Polyrankdocs
ApiLab

POST /v1/lab/agent/conversations/{id}/stop

Stop the assistant’s answer in one of the caller’s conversations. A turn still queued is withdrawn at once (200, status idle; the message stays in the transcript, unanswered). A running turn is asked to stop (202, stopping: true): the runner stops between steps or mid-answer within about a second, keeps what it finished (finished steps and their cards, the answer text written so far) and ends the turn (the event stream says `stopped`, then `turn_end`). A conversation not answering answers 200 with stopping false. Signed-in session only. 503 `lab_agent_live_unavailable` when the stop cannot be passed on. 404 `lab_agent_disabled` while LAB_AGENT_ENABLED is off.

POST
/v1/lab/agent/conversations/{id}/stop

Stop the assistant’s answer in one of the caller’s conversations. A turn still queued is withdrawn at once (200, status idle; the message stays in the transcript, unanswered). A running turn is asked to stop (202, stopping: true): the runner stops between steps or mid-answer within about a second, keeps what it finished (finished steps and their cards, the answer text written so far) and ends the turn (the event stream says stopped, then turn_end). A conversation not answering answers 200 with stopping false. Signed-in session only. 503 lab_agent_live_unavailable when the stop cannot be passed on. 404 lab_agent_disabled while LAB_AGENT_ENABLED is off.

AuthorizationBearer <token>

API key: Authorization: Bearer pk_live_… (mint at polyrank.app/api-keys)

In: header

Path Parameters

id*string

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/lab/agent/conversations/497f6eca-6276-4993-bfeb-53cbbbba6f08/stop"
{  "status": "idle",  "stopping": true}
{  "status": "idle",  "stopping": true}
{  "error": "string",  "message": "string",  "feature": "string",  "field": "string",  "plan": "string",  "retry_after_sec": 0,  "retry_after_seconds": 0,  "reason": "string",  "issues": [    null  ],  "trace_id": "string"}
{  "error": "string",  "message": "string",  "feature": "string",  "field": "string",  "plan": "string",  "retry_after_sec": 0,  "retry_after_seconds": 0,  "reason": "string",  "issues": [    null  ],  "trace_id": "string"}
{  "error": "string",  "message": "string",  "feature": "string",  "field": "string",  "plan": "string",  "retry_after_sec": 0,  "retry_after_seconds": 0,  "reason": "string",  "issues": [    null  ],  "trace_id": "string"}
{  "error": "string",  "message": "string",  "feature": "string",  "field": "string",  "plan": "string",  "retry_after_sec": 0,  "retry_after_seconds": 0,  "reason": "string",  "issues": [    null  ],  "trace_id": "string"}
{  "error": "string",  "message": "string",  "feature": "string",  "field": "string",  "plan": "string",  "retry_after_sec": 0,  "retry_after_seconds": 0,  "reason": "string",  "issues": [    null  ],  "trace_id": "string"}
{  "error": "string",  "message": "string",  "feature": "string",  "field": "string",  "plan": "string",  "retry_after_sec": 0,  "retry_after_seconds": 0,  "reason": "string",  "issues": [    null  ],  "trace_id": "string"}
{  "error": "string",  "message": "string",  "feature": "string",  "field": "string",  "plan": "string",  "retry_after_sec": 0,  "retry_after_seconds": 0,  "reason": "string",  "issues": [    null  ],  "trace_id": "string"}
{  "error": "string",  "message": "string",  "feature": "string",  "field": "string",  "plan": "string",  "retry_after_sec": 0,  "retry_after_seconds": 0,  "reason": "string",  "issues": [    null  ],  "trace_id": "string"}