---
title: "Remove items from an annotation queue"
method: POST
path: "/v2/annotation-queues/{annotation_queue_id}/items/remove"
tags: ["Annotation Queues"]
---

# Remove items from an annotation queue

`POST /v2/annotation-queues/{annotation_queue_id}/items/remove`

Removes the referenced spans from the annotation queue.

## Path parameters

- `annotation_queue_id` string, required

## Request body

- RemoveAnnotationQueueItemsRequest
  - `span_ids` string[], required — The unique identifiers of the spans to be removed from the annotation queue.

## Response `200`

OK

- RemoveAnnotationQueueItemsResponse

## Changes

> 261 revisions in range; 73 not diffed.

- **2026-09-01** `359a7831a2f0` — 2 breaking, 2 info
  - request body became required
  - removed the success response with the status `204`
  - removed the non-success response with the status `404`
  - added the success response with the status `200`
- **2026-09-01** `66b8a4902911` — 2 breaking, 3 info
  - the `span_ids` request property's minItems was increased to `1`
  - removed the success response with the status `200`
  - request body became optional
  - added the non-success response with the status `404`
  - …1 more
- **2026-09-01** `081200e02fe0` — 2 breaking, 2 info
  - request body became required
  - removed the success response with the status `204`
  - removed the non-success response with the status `404`
  - added the success response with the status `200`
- **2026-08-31** `b22330eb2d5a` — 2 breaking, 3 info
  - the `span_ids` request property's minItems was increased to `1`
  - removed the success response with the status `200`
  - request body became optional
  - added the non-success response with the status `404`
  - …1 more
- **2026-08-31** `3a2f6c296c09` — 2 breaking, 2 info
  - request body became required
  - removed the success response with the status `204`
  - removed the non-success response with the status `404`
  - added the success response with the status `200`

[Full history](https://skmtc.dev/orq-ai/apis/orq-ai-api/changes/v2/annotation-queues/:annotation_queue_id/items/remove/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/4a39391f62da/schema)