Skip to main content
POST
Interrupt an agent's turn

Authorizations

Authorization
string
header
required

murmur API key: mur_<key_id>.

Body

application/json
agentId
object

Identifies an agent. The identity is (tenant, workspace, owner, agent path); the workspace scopes the agent's repos, environment, and base branches.

runId
integer<int32>

The turn to stop. Required: must equal the agent's current run number — read it from the runCount field of the agent status response. An omitted or stale value is rejected with INVALID_ARGUMENT, so a retried stop never kills a newer turn.

mode
enum<string>
default:STOP_TURN_MODE_UNSPECIFIED

Controls how the running turn is stopped. INTERRUPT stops gracefully — the agent flushes its cost, duration, and response before exiting. KILL terminates immediately with no result recovery. There is no automatic escalation: send a second stop with KILL mode if the first doesn't take effect.

  • STOP_TURN_MODE_UNSPECIFIED: treated as INTERRUPT
  • STOP_TURN_MODE_INTERRUPT: graceful stop — first press
  • STOP_TURN_MODE_KILL: forceful stop — second press (escalation)
Available options:
STOP_TURN_MODE_UNSPECIFIED,
STOP_TURN_MODE_INTERRUPT,
STOP_TURN_MODE_KILL

Response

A successful response.

The response is of type object.