---
title: "Create Queue"
method: POST
path: "/v1/annotation-queues"
tags: ["Annotation Queues"]
---

# Create Queue

`POST /v1/annotation-queues`

## Request

- Base URL: `https://api.confident-ai.com`
- URL: `https://api.confident-ai.com/v1/annotation-queues`
- Auth: none declared. Required headers: `CONFIDENT_API_KEY`
- TypeScript: <https://skmtc.dev/confident-ai/apis/confident-ai-metrics-api/docs/v1/annotation-queues/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a new annotation queue for organizing traces, spans, threads, golden datasets, or test runs for systematic review and annotation.

**Queue types:**
- `TRACE`: Queue for reviewing complete trace executions
- `SPAN`: Queue for reviewing individual spans within traces
- `THREAD`: Queue for reviewing conversation threads
- `GOLDEN`: Queue for creating golden datasets
- `TEST_RUN`: Queue for reviewing test run results

Queue names must be unique within your project.

## Headers

- `CONFIDENT_API_KEY` string, required

## Request body

- CreateAnnotationQueue
  - `name` string, required: The name of the annotation queue
  - `type` 'TRACE' | 'SPAN' | 'THREAD' | 'GOLDEN' | 'TEST_RUN', required: The type of items this queue will contain

## Response `200`

Successfully created annotation queue

- CreateAnnotationQueueResponse
  - `success` boolean, required: Indicates if the annotation queue was successfully created.
  - `data` object, required: Contains the created annotation queue information.
    - `id` string, required: The unique identifier of the newly created annotation queue.

---

[API](https://skmtc.dev/confident-ai/apis/confident-ai-metrics-api.md) - [All operations](https://skmtc.dev/confident-ai/apis/confident-ai-metrics-api/llms.txt) - [OpenAPI document](https://skmtc.dev/confident-ai/apis/confident-ai-metrics-api/revisions/95cdde71b65e?raw)