---
title: "Create an annotation queue"
method: POST
path: "/v2/annotation-queues"
tags: ["Annotation Queues"]
---

# Create an annotation queue

`POST /v2/annotation-queues`

Creates an annotation queue in a project.

## Request body

- CreateAnnotationQueueRequest
  - `display_name` string, required — Required. The display name of the annotation queue.
  - `description` string, required — Required. The description of the annotation queue.
  - `project_id` string, required — Required. The project to link this annotation queue to.

## Response `200`

OK

- AnnotationQueue
  - `_id` string, required — Unique annotation queue identifier assigned by ORQ.
  - `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` AnnotationQueueMetadata, required — Aggregate counters maintained by the service as items are added and removed.
    - `items_count` integer, required — Number of items currently in the annotation queue.
  - `created_by_id` string — The account that created the annotation queue. Unset when created via API key authentication.
  - `updated_by_id` string — The account that last updated the annotation queue. Unset when updated via API key authentication.
  - `created` string, date-time — The date and time the annotation queue was created.
  - `updated` string, date-time — The date and time the annotation queue was last updated.

## Changes

> 271 revisions in range; 82 not diffed.

- **2026-09-01** `359a7831a2f0` — 7 breaking, 6 info
  - request body became required
  - the `created` response's property type changed from no type to `string` for status `200`
  - the `created_by_id` response's property type changed from `string, null` to `string`, and format from `uuid` to no format for status `200`
  - the `metadata` response's property type changed from `object` to no type for status `200`
  - …9 more
- **2026-09-01** `66b8a4902911` — 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 changed from `string` to no type for status `200`
  - the `created_by_id` response's property type changed from `string` to `string, null`, and format from no format to `uuid` for status `200`
  - …11 more
- **2026-09-01** `081200e02fe0` — 7 breaking, 6 info
  - request body became required
  - the `created` response's property type changed from no type to `string` for status `200`
  - the `created_by_id` response's property type changed from `string, null` to `string`, and format from `uuid` to no format for status `200`
  - the `metadata` response's property type changed from `object` to no type for status `200`
  - …9 more
- …earlier changes not shown

[Full history](https://skmtc.dev/orq-ai/apis/orq-ai-api/changes/v2/annotation-queues/post.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/3df7b466d7e5/schema)