Update Case
updateCaseEdit a case's title and/or its data payload. Provide at least one field. For the payload, send free-form data OR a structured json_data object, never both. json_data is validated against the queue's Case schema and requires the queue to have one; a case that is already typed against a schema keeps its structured payload and rejects a free-text data write. Works on pending, in-progress, and settled cases. Other attributes (status, priority, labels) have their own dedicated endpoints. Returns the updated case with its event history and approval batches.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"case_id": "<case_id>"
},
"name": "updateCase"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | New free-form data payload handed to the agent when the case is claimed. Mutually exclusive with `json_data`. | |
| title | No | New case title (1–500 characters). | |
| case_id | Yes | The case's unique identifier | |
| json_data | No | New structured payload for a case on a queue that has a Case schema. Validated against that schema and mutually exclusive with `data`. |