Interrupt a running turn
POST /v1/chat/interrupt — Stop the session's in-flight turn. The turn ends gracefully: partial work is kept, and the SSE stream finishes with a `d
POST /v1/chat/interrupt
Stop the session's in-flight turn. The turn ends gracefully: partial work is kept, and the SSE stream finishes with a done event carrying interrupted: true.
| Method | POST |
| Path | /v1/chat/interrupt |
| Auth | Authorization: Bearer <token> required when GATEWAY_AUTH_TOKEN is set |
| Category | chat |
Request body
{ "session_id": "sess_abc" }Response body
{ "status": "interrupted" }Notes
Backs a user-facing Stop button. The turn does not error out: text and tool results produced before the interrupt persist to the session transcript, and the stream still closes with a normal done event (flagged interrupted: true).
Idempotent: returns 200 with { "status": "interrupted" } when a turn was stopped, and 200 with { "status": "no_active_turn" } when nothing was running. 400 when session_id is missing.