Search Cases
searchCasesSearch cases in a queue with rich filters (multi-status, date ranges, label-based filters, and field-value filters over a typed queue's json_data). Use this when the simple query-string filters on GET /v2/queues/:queue_id/cases aren't enough. Each json_data entry is {path, operator, value} where path is a declared scalar in JSONPath dotted form ($.invoice.amount); entries are ANDed, so two comparisons on one path express a range. A path the queue's Case schema does not declare is rejected rather than ignored, as is a value that does not match the field's declared type. The contains operator is case-sensitive (unlike the free-text search parameter). Set count_only=true to skip Case row selection, enrichment, and transformation. The normal response shape is returned with cases: [] and the matching total.
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": {
"queue_id": "<queue_id>"
},
"name": "searchCases"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| offset | No | ||
| search | No | ||
| filters | No | ||
| sort_by | No | created_at | |
| queue_id | Yes | The queue's unique identifier | |
| count_only | No | Skip Case row selection, enrichment, and transformation. The normal response shape contains an empty cases array and the matching total. | |
| sort_order | No | desc | |
| include_blockers | No | Also return `blocker` on each case: for a case waiting to start, why the dispatcher cannot start it now, or null when nothing blocks it. Off by default, because it adds database reads; when off, `blocker` is left out. |