latestOpenAPI 3.0.32026-07-222111928.0 KB

dafcf3d868a9

Agent Folders5

Agent Memory2

Agents12

Case Triggers6

Cases20

Clarity19

ClarityV222

Connections10

Credentials8

Duvo Pulse22

Files7

Integrations3

Organizations10

Plugins1

Queues6

Revision Integrations9

Revisions5

Runs8

Sandboxes4

Schedules4

Secrets8

Skills10

Suggestions3

Team4

Triggers3

Cases

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