v4

latestOpenAPI 3.1.02026-08-019681,1012.0 MB

annotation_queue_records

Partial Search Annotation Queue Records

Search records in an annotation queue with partial field selection.

This endpoint queries all project/run pairs associated with the queue and returns records that are in the annotation queue, with only the requested fields included.

Permission checks:

User must have READ permission on the annotation queue

Note: This endpoint queries across all projects/runs in the queue.

post/annotation_queues/{queue_id}/partial_search

Path parameters

queue_idstring uuid4 required

Request body

starting_tokeninteger

limitinteger

previous_last_row_idstring uuid4 nullable

truncate_fieldsboolean

Whether to truncate long text fields

include_countsboolean

If True, include computed child counts (e.g., num_traces for sessions, num_spans for traces).

Response

Successful Response

starting_tokeninteger

limitinteger

paginatedboolean

next_starting_tokeninteger nullable

last_row_idstring uuid4 nullable

num_recordsinteger required

number of records

Example response

{
  "next_starting_token": 2,
  "num_rows": 2,
  "paginated": true,
  "records": [
    {
      "annotation_aggregates": {},
      "annotation_agreement": {},
      "annotation_queue_ids": [],
      "annotations": {},
      "created_at": "2026-07-27T17:31:56.136109Z",
      "dataset_metadata": {},
      "error_message": "",
      "feedback_rating_info": {},
      "file_ids": [],
      "file_modalities": [],
      "id": "1a0939d1-8b43-4fe3-a91c-196e2d9847e3",
      "input": "Who is a smart LLM?",
      "is_complete": true,
      "metrics": {},
      "name": "",
      "progress_message": "",
      "tags": [],
      "type": "trace",
      "user_metadata": {}
    },
    {
      "annotation_aggregates": {},
      "annotation_agreement": {},
      "annotation_queue_ids": [],
      "annotations": {},
      "created_at": "2026-07-27T17:31:56.136254Z",
      "dataset_metadata": {},
      "error_message": "",
      "feedback_rating_info": {},
      "file_ids": [],
      "file_modalities": [],
      "id": "1edc2401-24b4-448c-a392-b36932293061",
      "input": [
        {
          "content": "Who is a smart LLM?",
          "role": "user"
        }
      ],
      "is_complete": true,
      "metrics": {},
      "name": "",
      "output": {
        "content": "",
        "role": "assistant"
      },
      "progress_message": "",
      "tags": [],
      "type": "llm",
      "user_metadata": {}
    }
  ]
}