---
title: "Edit an annotation queue"
method: PATCH
path: "/v2/annotation-queues/{annotation_queue_id}"
tags: ["Annotation Queues"]
---

# Edit an annotation queue

`PATCH /v2/annotation-queues/{annotation_queue_id}`

Update an annotation queue by ID with the provided fields.

## Path parameters

- `annotation_queue_id` string, required

## Request body

- object
  - `display_name` string — The display name of the annotation queue
  - `description` string — The description of the annotation queue
  - `project_id` string — The project ID. When set, human reviews are resolved from the project automatically
  - `human_review_ids` string[] — Legacy: update manually selected human review IDs. Only allowed when project_id is not set

## Response `200`

Annotation queue updated

- object
  - `_id` string, required — The unique identifier of the annotation queue
  - `display_name` string, required — The display name of the annotation queue
  - `description` string, required — The description of the annotation queue
  - `workspace_id` string, required — The unique identifier of the workspace it belongs to
  - `project_id` string — The project ID. When set, human reviews are resolved from the project automatically
  - `human_review_ids` string[], required — Legacy: manually selected human review IDs. Used only when project_id is not set
  - `metadata` object, required
    - `items_count` number, required — The number of items in the annotation queue
  - `created_by_id` string, uuid, nullable — The id of the user who created the resource
  - `updated_by_id` string, uuid, nullable — The id of the user who last updated the resource
  - `created` union — The date and time the resource was created
    - string, date-time
    - string, date-time
  - `updated` union — The date and time the resource was last updated
    - string, date-time
    - string, date-time

## Changes

> 251 revisions in range; 71 not diffed.

- **2026-08-28** `9642bb8e4f83` — 7 breaking, 8 info
  - the response property `created_by_id` became nullable for the status `200`
  - the response property `updated_by_id` became nullable for the status `200`
  - the `created` response's property type/format changed from `string`/`date-time` to ``/`date-time` for status `200`
  - the `created_by_id` response's property type/format changed from `string`/`` to `string, null`/`uuid` for status `200`
  - …11 more
- **2026-08-27** `a38e9ab59771` — 7 breaking, 6 info
  - request body became required
  - the `created` response's property type/format changed from ``/`date-time` to `string`/`date-time` for status `200`
  - the `created_by_id` response's property type/format changed from `string, null`/`uuid` to `string`/`` for status `200`
  - the `metadata` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - …9 more
- **2026-08-26** `d5a398a9e78d` — 2 info
  - the `` response's property default value changed from `2026-08-26T13:26:42.563Z` to `2026-08-26T20:33:30.418Z` for the status `200`
  - the `created` response's property default value changed from `2026-08-26T13:26:42.562Z` to `2026-08-26T20:33:30.417Z` for the status `200`
- …earlier changes not shown

[Full history](https://skmtc.dev/orq-ai/apis/orq-ai-api/changes/v2/annotation-queues/:annotation_queue_id/patch.md)

---

[API](https://skmtc.dev/orq-ai/apis/orq-ai-api.md) · [All operations](https://skmtc.dev/orq-ai/apis/orq-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/orq-ai/orq-ai-api/revisions/9642bb8e4f83/schema)