---
title: "Create an Annotation Queue"
method: POST
path: "/api/{org_id}/annotation_queues"
tags: ["AnnotationQueues"]
---

# Create an Annotation Queue

`POST /api/{org_id}/annotation_queues`

## Request

- Base URL: `https://api.openobserve.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.openobserve.ai/api/{org_id}/annotation_queues`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/openobserve/apis/openobserve-api-http/docs/api/:org_id/annotation_queues/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates an Annotation Queue whose rubric is pinned to immutable Score Config row IDs.

## Path parameters

- `org_id` string, required

## Request body

- object
  - `description` string, nullable
  - `name` string, required
  - `scoreConfigRowIds` string[], required
  - `targetDatasetId` string, nullable

## Response `200`

- object
  - `allowedRefTypes` string[], required
  - `createdAt` integer, required
  - `createdBy` string, required
  - `description` string, nullable
  - `id` string, required
  - `name` string, required
  - `orgId` string, required
  - `reviewedCount` integer, required: Number of non-archived Queue Items whose review is complete.
  - `scoreConfigs` PinnedScoreConfigResponseBody[], required
    - `dataType` string, required
    - `entityId` string, required
    - `name` string, required
    - `rowId` string, required
    - `version` integer, required
  - `targetDatasetId` string, nullable
  - `targetDatasetName` string, nullable
  - `totalCount` integer, required: Number of non-archived Queue Items participating in review progress.
  - `updatedAt` integer, required
  - `updatedBy` string, required

## Other responses

- `400`: Bad Request
- `409`: Conflict

---

[API](https://skmtc.dev/openobserve/apis/openobserve-api-http.md) - [All operations](https://skmtc.dev/openobserve/apis/openobserve-api-http/llms.txt) - [OpenAPI document](https://skmtc.dev/openobserve/apis/openobserve-api-http/revisions/0529b8a10252?raw)