MINARA

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.

MethodPOST
Path/v1/chat/interrupt
AuthAuthorization: Bearer <token> required when GATEWAY_AUTH_TOKEN is set
Categorychat

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.

On this page