annotation_queues

List annotation queue items

Changed on

List RUN and THREAD items in a single annotation queue for one review status section, with opaque cursor pagination. Optional item_type=RUN|THREAD filters the page. Optional min_start_time/max_start_time bound the item's trace start time; items with no start time are excluded when either bound is set. direction=backward returns items before the supplied cursor. The response contains item metadata only, not expanded run or thread payloads. status=archived returns items whose queue review requirements have been satisfied, not merely items the caller personally marked completed.

get/api/v1/platform/annotation-queues/{queue_id}/items

Request

  • Base URL
    https://api.smith.langchain.com
  • URL
    https://api.smith.langchain.com/api/v1/platform/annotation-queues/{queue_id}/items
  • Auth
    • API key in header X-API-Key
    • or API key in header X-Tenant-Id
    • or HTTP bearer

Path parameters

queue_idstring required

Annotation queue ID

Query parameters

status'needs_my_review' | 'needs_others_review' | 'archived' required

Review section: needs_my_review, needs_others_review, or archived

page_sizeinteger

Page size (max 100)

cursorstring

Opaque pagination cursor

item_type'RUN' | 'THREAD'

Filter to RUN or THREAD

min_start_timestring date-time

Only items whose trace start time is at or after this timestamp. Omit or send the zero time for no bound

max_start_timestring date-time

Only items whose trace start time is at or before this timestamp. Omit or send the zero time for no bound

direction'forward' | 'backward'

Pagination direction. backward requires cursor

Response

OK

next_cursorstring
previous_cursorstring

Changes