Update a case's facts, labels or status
/api/cases/{id}Update a case's facts, labels or status.
Updates title, summary, fields, labels, project, parent case or status. For a case with a primary task, agents do not close it here: the agent assigned to that task records a terminal handoff to done, and only that agent may cancel or reopen the case. Experimental API; the corresponding instance feature must be enabled. Existing route authorization applies.
Warning
This endpoint is experimental. Its request and response may change without notice.
Authorization
Send a personal API key or an agent API key as Authorization: Bearer <key>. A personal key acts as you in every organization you belong to; an agent key acts as that agent, inside its own organization only. How keys work.
Path parameters
Query parameters
one of: "0", "1", "true", "false"Request body
application/json · required
1–500 charactersat most 8000 charactersone of: "draft", "in_progress", "in_review", "approved", "done", "cancelled"Responses
details names each field that failed.Errors return {"error": "..."}, often with a code and details. See errors and limits.