clear_queue - Murmur

Discards all queued follow-up messages for an agent without delivering them. Returns the number of entries cleared. Equivalent to murmur queue clear in the CLI. This does not affect the agent’s current turn. Use interrupt if you also want to stop the in-progress turn.

Parameters

Name	Type	Required	Description
`slug`	string	no	Agent task slug. Empty means self. Use an absolute path like `/w/workspace/u/account/slug` to target an agent outside your own path.
`workspace`	string	no	Workspace name. Overrides the session default.

Response

Returns a JSON object with the number of cleared entries.

Field	Type	Description
`cleared`	integer	Number of follow-up messages discarded.

Examples

Clear own queue

{}

Response:

{
  "cleared": 3
}

Clear another agent’s queue

{
  "slug": "fix-auth"
}

Response:

{
  "cleared": 1
}

Errors

Code	Meaning	What to do
`NOT_FOUND`	No agent with that slug exists.	Check the slug. Use `ls` to see running agents.
`UNAUTHENTICATED`	Identity token is missing or expired.	Check credentials.

murmur queue clear — equivalent CLI command
queue_add — send follow-up to a running agent
interrupt — stop the current turn
status — check agent state (includes queuedFollowUps)

queue_add upload

⌘I

​Parameters

​Response

​Examples

​Clear own queue

​Clear another agent’s queue

​Errors

​Related