Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.murmur.dev/llms.txt

Use this file to discover all available pages before exploring further.

Interrupts an agent’s current turn. The agent stops cleanly between tool calls — no in-progress work is lost — and resumes by processing any queued follow-ups on its next turn. Equivalent to murmur session interrupt in the CLI. The interrupt + queue_add pattern is the standard way to amend or supersede a previously queued instruction without waiting for a long task to finish. Interrupt the agent, then immediately queue the new instruction. The agent picks up the new message on its next turn. Use kill instead if you want to terminate the agent entirely, or clear_queue if you want to drop pending follow-ups without affecting the current turn.

​
Parameters

NameTypeRequiredDescription
slugstringyesAgent task slug to interrupt. Use an absolute path like /w/workspace/u/account/slug to target an agent outside your own path.
workspacestringnoWorkspace name. Overrides the session default.

​
Response

Returns a confirmation string: interrupt sent to <slug>.

​
Examples

​
Interrupt an agent

{
  "slug": "fix-auth"
}
Response: 
interrupt sent to fix-auth

​
Interrupt then redirect

First, interrupt the current turn: 
{
  "slug": "fix-auth"
}
Then send new instructions with queue_add: 
{
  "slug": "fix-auth",
  "description": "Stop what you're doing. Focus on the login handler instead."
}

​
Interrupt using absolute path

{
  "slug": "/w/backend/u/bob/api-refactor"
}

​
Errors

CodeMeaningWhat to do
NOT_FOUNDNo agent with that slug exists.Check the slug. Use ls to see running agents.
UNAUTHENTICATEDIdentity token is missing or expired.Check credentials.