Skip to main content

List annotation queue items

POST 
/api/v1/evals/list-annotation-queue-items

Lists annotation queue items.

Reading an item​

Section ID: DOC-IS-evaluation-api-listAnnotationQueueItems#reading-an-item

For a trace item, pass objectId to get-trace. Other target kinds need their matching read operation.

The following access conditions are preserved as declared intent and are not implemented by generated code: Authorized scoped domain action.

Use this in a guide: Review and score turns

Request​

Responses​

OK

Schema-valid request illustration; replace example identifiers and confirm operation prerequisites.​

Section ID: DOC-IS-evaluation-api-listAnnotationQueueItems#example-evals-listAnnotationQueueItems-request

Request example

{
  "queueId": "example_123"
}

Guide request for Pull the worklist. Replace example resource identifiers with your own authorized values.​

Section ID: DOC-IS-evaluation-api-listAnnotationQueueItems#example-cookbook-insights-evaluation-review-04-request

Request example

{
  "queueId": "q_weekly",
  "status": "ANNOTATION_QUEUE_ITEM_STATUS_PENDING",
  "page": 1,
  "pageSize": 20
}

Illustrative response shape; omitted default fields and actual outcomes depend on the operation.​

Section ID: DOC-IS-evaluation-api-listAnnotationQueueItems#example-evals-listAnnotationQueueItems-response

Response example

{
  "items": [
    {
      "itemId": "example_123",
      "queueId": "example_123",
      "objectId": "example_123",
      "objectType": "EVAL_TARGET_TYPE_TRACE",
      "status": "ANNOTATION_QUEUE_ITEM_STATUS_PENDING",
      "completedAt": "2026-09-16T12:00:00Z",
      "completedBy": "example",
      "createdAt": "2026-09-16T12:00:00Z"
    }
  ],
  "page": {
    "page": 1,
    "limit": 1,
    "totalItems": 1,
    "totalPages": 1
  }
}

Illustrative response for Pull the worklist. Replace example resource identifiers with your own authorized values.​

Section ID: DOC-IS-evaluation-api-listAnnotationQueueItems#example-cookbook-insights-evaluation-review-json-01-response

Response example

{
  "items": [
    {
      "itemId": "qi_001",
      "queueId": "q_weekly",
      "objectType": "EVAL_TARGET_TYPE_TRACE",
      "objectId": "trc_a1b2c3",
      "status": "ANNOTATION_QUEUE_ITEM_STATUS_PENDING",
      "createdAt": "2026-08-12T17:00:00Z"
    }
  ],
  "page": {
    "page": 1,
    "limit": 20,
    "totalItems": 34,
    "totalPages": 2
  }
}

Document ID: DOC-IS-evaluation-api-listAnnotationQueueItems. Section identities and revisions.

SectionStable reference
List annotation queue itemsDOC-IS-evaluation-api-listAnnotationQueueItems#overview
RequestDOC-IS-evaluation-api-listAnnotationQueueItems#request
ResponsesDOC-IS-evaluation-api-listAnnotationQueueItems#responses