Remove a queued message
remove_queued_message
Takes a message out of a site's queue so the site agent never runs it.
Scopesites:deleteDestructive
It cannot be undone. Unlike an edit, it is not limited to messages you queued yourself, and the queue belongs to the whole workspace, so an entry you did not write may be one somebody queued and is waiting on. The tool tells the client to read list_queued_messages first and to confirm with you before removing anything that is not yours.
Only a message that is still queued can be removed. One the agent has already started is refused with That message already left the queue and is running!, and cancel_job is the tool for that. See Message queue.
Inputs
| Input | Type | Required | Description |
|---|---|---|---|
projectId |
string | Yes | The site id, from list_sites or get_site. |
itemId |
string | Yes | The Id of the queued message, exactly as list_queued_messages reported it. |