---
title: "Search annotation queue items"
method: POST
path: "/v1/private/annotation-queues/{id}/items/search"
tags: ["Annotation Queues"]
---

# Search annotation queue items

`POST /v1/private/annotation-queues/{id}/items/search`

Returns queue membership metadata — how each item got into the queue — for the given item ids. A lookup rather than a listing: the caller renders the items table from the traces or threads API with its own sort and filters, so it asks for exactly the ids it is displaying. Ids that are not in the queue are omitted.

## Path parameters

- `id` string, uuid, required

## Request body

- AnnotationQueueItemIdsPublic
  - `ids` string[], required

## Response `200`

Annotation queue items

- AnnotationQueueItemsPublic
  - `content` AnnotationQueueItemPublic[]
    - `id` string, uuid
    - `source` 'manual' | 'automated'

## Other responses

- `404` — Not Found

## Changes

- **2026-09-17** `4baa2ed0236f` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/comet-ml/apis/opik-rest-api/changes/v1/private/annotation-queues/:id/items/search/post.md)

---

[API](https://skmtc.dev/comet-ml/apis/opik-rest-api.md) · [All operations](https://skmtc.dev/comet-ml/apis/opik-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/comet-ml/apis/opik-rest-api/revisions/7e9b9ca95d8f?raw)