Bulk Update Case Status

Update the status of multiple cases to pending, completed, or failed. Interrupts any active runs and releases their case ownership, but never cancels their human-in-the-loop state — pending requests and open approval batches stay answerable/resolvable from the run view. Resetting to pending re-dispatches cases to the queue's trigger consumer.

post/v2/queues/{queue_id}/cases/bulk-update-status

Path parameters

queue_idstring uuid required

The queue's unique identifier

Request body

case_idsstring[]

Explicit case IDs to act on (1-100). Provide this or set all_matching.

all_matchingboolean

When true, act on every case matching the provided filters/search instead of an explicit id list.

searchstring

Free-text search selecting the cases when all_matching is true.

status'pending' | 'completed' | 'failed' required

Target status for each case. completed and failed are terminal; pending resets the case (the queue's trigger consumer, if any, will re-claim it).

Response

Default Response

updatedCountnumber required

skippedCountnumber required

interruptedRunIdsstring[] required

Changes

No recorded changes to this endpoint across all 1 revision of this API.