---
title: "Bulk Update Case Status"
method: POST
path: "/v2/queues/{queue_id}/cases/bulk-update-status"
tags: ["Cases"]
---

# Bulk Update Case Status

`POST /v2/queues/{queue_id}/cases/bulk-update-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.

## Path parameters

- `queue_id` string, uuid, required

## Request body

- object
  - `case_ids` string[] — Explicit case IDs to act on (1-100). Provide this or set all_matching.
  - `all_matching` boolean — When true, act on every case matching the provided filters/search instead of an explicit id list.
  - `filters` object — Filters selecting the cases when all_matching is true.
    - `status` string[]
    - `created_at_from` string
    - `updated_at_from` string
    - `labels` object
  - `search` string — 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 `200`

Default Response

- object
  - `updatedCount` number, required
  - `skippedCount` number, required
  - `interruptedRunIds` string[], required

## Other responses

- `401` — Default Response
- `404` — Default Response
- `500` — Default Response

---

[API](https://skmtc.net/duvo/apis/duvo-public-api.md) · [All operations](https://skmtc.net/duvo/apis/duvo-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/duvo/duvo-public-api/revisions/dafcf3d868a9/schema)