---
title: "Bulk Update Task Status"
method: PATCH
path: "/v2/tasks/status"
tags: ["tasks"]
---

# Bulk Update Task Status

`PATCH /v2/tasks/status`

Bulk semantic status mutation (ready / verified / revision / rejected, or clear); non-atomic.

## Request body

- BulkStatusRequest — Bulk semantic status mutation. Provide exactly one of ``ids`` or ``slugs`` (slugs are task external_ids, resolved within ``taskset_id``), and exactly one of ``status``, ``clear=true``, or ``reviewed``.
  - `ids` string[], nullable
  - `slugs` string[], nullable
  - `taskset_id` string, uuid, nullable
  - `status` 'pending' | 'ready' | 'verified' | 'revision' | 'rejected', nullable
  - `clear` boolean
  - `reviewed` boolean, nullable

## Response `200`

Successful Response

- BulkStatusResponse — Non-atomic: partial successes commit. Per-input failures are surfaced individually instead of failing the whole batch. ``unchanged`` carries no-ops (target progress equals existing progress).
  - `succeeded` string[]
  - `unchanged` string[]
  - `failures` BulkStatusFailure[]
    - `input` string, required
    - `resolved_id` string, uuid, nullable
    - `reason` string, required
    - `code` 'not_found' | 'forbidden' | 'invalid_transition', required

## Other responses

- `400` — Invalid or malformed request
- `401` — Missing or invalid credentials
- `403` — Caller may not access this resource
- `404` — Referenced entity does not exist
- `409` — Resource already exists
- `422` — Validation Error

---

[API](https://skmtc.dev/hud/apis/hud-platform.md) · [All operations](https://skmtc.dev/hud/apis/hud-platform/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hud/hud-platform/revisions/58558fc733d9/schema)