---
title: "Add Runs To Annotation Queue"
method: POST
path: "/api/v1/annotation-queues/{queue_id}/runs"
tags: ["annotation-queues"]
---

# Add Runs To Annotation Queue

`POST /api/v1/annotation-queues/{queue_id}/runs`

## Path parameters

- `queue_id` string, uuid, required

## Request body

- union
  - string[]
  - AddRunToQueueRequest[]
    - `run_id` string, uuid, required
    - `source_proposed_example_id` string, uuid, nullable
  - AnnotationQueueRunAddSchema[]
    - `run_id` string, uuid, required
    - `start_time` string, date-time, nullable
    - `session_id` string, uuid, nullable
    - `trace_id` string, uuid, nullable
    - `parent_run_id` string, uuid, nullable
    - `trace_tier` 'longlived' | 'shortlived'

## Response `200`

Successful Response

- AnnotationQueueRunSchema[]
  - `run_id` string, uuid, required
  - `queue_id` string, uuid, required
  - `last_reviewed_time` string, date-time, nullable
  - `added_at` string, date-time
  - `source_proposed_example_id` string, uuid, nullable
  - `id` string, uuid, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-05-27** `a0acb3a6a101` — 5 warning, 4 info
  - removed the request property `anyOf[subschema #2: RunsAnnotationQueueRunAddSchemaArray]/items/parent_run_id`
  - removed the request property `anyOf[subschema #2: RunsAnnotationQueueRunAddSchemaArray]/items/session_id`
  - removed the request property `anyOf[subschema #2: RunsAnnotationQueueRunAddSchemaArray]/items/start_time`
  - removed the request property `anyOf[subschema #2: RunsAnnotationQueueRunAddSchemaArray]/items/trace_id`
  - …5 more
- **2026-03-31** `9b9d7777d6a9` — 6 info
  - request property `anyOf[subschema #2: RunsAnnotationQueueRunAddSchemaArray]/items/parent_run_id` deprecated
  - request property `anyOf[subschema #2: RunsAnnotationQueueRunAddSchemaArray]/items/run_id` deprecated
  - request property `anyOf[subschema #2: RunsAnnotationQueueRunAddSchemaArray]/items/session_id` deprecated
  - request property `anyOf[subschema #2: RunsAnnotationQueueRunAddSchemaArray]/items/start_time` deprecated
  - …2 more

[Change history](https://skmtc.dev/langchain-ai/apis/langsmith/changes/api/v1/annotation-queues/:queue_id/runs/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-service-production.skmtc.workers.dev/v1/apis/langchain-ai/langsmith/revisions/a0acb3a6a101/schema)