---
title: "Add annotation queue items"
method: POST
path: "/api/v1/platform/annotation-queues/{queue_id}/items"
tags: ["annotation_queues"]
---

# Add annotation queue items

`POST /api/v1/platform/annotation-queues/{queue_id}/items`

## Request

- Base URL: `https://api.smith.langchain.com`
- URL: `https://api.smith.langchain.com/api/v1/platform/annotation-queues/{queue_id}/items`
- Auth: one of:
  - API key in header `X-API-Key`
  - API key in header `X-Tenant-Id`
  - HTTP bearer

Add RUN or THREAD items to a single annotation queue. RUN items require run_id unless they are created from a suggested example. THREAD items require thread_id and project_id.

## Path parameters

- `queue_id` string, required

## Query parameters

- `extend_trace_retention` boolean

## Request body

- AnnotationqueuesAddAnnotationQueueItemsRequest
  - `items` AnnotationqueuesAnnotationQueueItemInput[]
    - `item_type` 'RUN' | 'THREAD'
    - `project_id` string
    - `run_id` string: RUN fields
    - `session_id` string: SessionID is an alias for project_id.
    - `source_proposed_example_id` string: SourceProposedExampleID links the queue item to the suggested example it was created from, when applicable.
    - `start_time` string, date-time
    - `thread_id` string

## Response `201`

Created

- AnnotationqueuesAddAnnotationQueueItemsResponse
  - `items` AnnotationqueuesAnnotationQueueItem[]
    - `added_at` string
    - `id` string
    - `item_type` 'RUN' | 'THREAD'
    - `last_reviewed_time` string: LastReviewedTime is always present on the wire (null until reviewed).
    - `project_id` string
    - `queue_id` string
    - `run_id` string
    - `source_proposed_example_id` string
    - `start_time` string
    - `thread_id` string

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found
- `422`: Unprocessable Entity

## Changes

- **2026-10-16** `1a8ee9358d81`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/langchain-ai/apis/langsmith/changes/api/v1/platform/annotation-queues/:queue_id/items/post.md)

---

[API](https://skmtc.dev/langchain-ai/apis/langsmith.md) - [All operations](https://skmtc.dev/langchain-ai/apis/langsmith/llms.txt) - [OpenAPI document](https://skmtc.dev/langchain-ai/apis/langsmith/revisions/7a01c01f75e8?raw)