Error

A valid request URL is required to generate request examples

{
  "items": [
    {
      "added_at": "<string>",
      "completed_by": [
        "<string>"
      ],
      "effective_added_at": "<string>",
      "id": "<string>",
      "item_type": "RUN",
      "last_reviewed_time": "<string>",
      "project_id": "<string>",
      "queue_id": "<string>",
      "reserved_by": [
        "<string>"
      ],
      "run_id": "<string>",
      "source_proposed_example_id": "<string>",
      "start_time": "<string>",
      "thread_id": "<string>"
    }
  ],
  "next_cursor": "<string>",
  "previous_cursor": "<string>"
}

{
  "detail": "<string>",
  "details": {
    "adapter": "<string>",
    "item_type": "<string>",
    "run_id": "<string>"
  },
  "error_class": "PARSE_FAILURE",
  "instance": "<string>",
  "remedy": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>"
}

{
  "detail": "<string>",
  "details": {
    "adapter": "<string>",
    "item_type": "<string>",
    "run_id": "<string>"
  },
  "error_class": "PARSE_FAILURE",
  "instance": "<string>",
  "remedy": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>"
}

{
  "detail": "<string>",
  "details": {
    "adapter": "<string>",
    "item_type": "<string>",
    "run_id": "<string>"
  },
  "error_class": "PARSE_FAILURE",
  "instance": "<string>",
  "remedy": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>"
}

List annotation queue items

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

platform

annotation-queues

{queue_id}

items

Error

A valid request URL is required to generate request examples

{
  "items": [
    {
      "added_at": "<string>",
      "completed_by": [
        "<string>"
      ],
      "effective_added_at": "<string>",
      "id": "<string>",
      "item_type": "RUN",
      "last_reviewed_time": "<string>",
      "project_id": "<string>",
      "queue_id": "<string>",
      "reserved_by": [
        "<string>"
      ],
      "run_id": "<string>",
      "source_proposed_example_id": "<string>",
      "start_time": "<string>",
      "thread_id": "<string>"
    }
  ],
  "next_cursor": "<string>",
  "previous_cursor": "<string>"
}

{
  "detail": "<string>",
  "details": {
    "adapter": "<string>",
    "item_type": "<string>",
    "run_id": "<string>"
  },
  "error_class": "PARSE_FAILURE",
  "instance": "<string>",
  "remedy": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>"
}

{
  "detail": "<string>",
  "details": {
    "adapter": "<string>",
    "item_type": "<string>",
    "run_id": "<string>"
  },
  "error_class": "PARSE_FAILURE",
  "instance": "<string>",
  "remedy": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>"
}

{
  "detail": "<string>",
  "details": {
    "adapter": "<string>",
    "item_type": "<string>",
    "run_id": "<string>"
  },
  "error_class": "PARSE_FAILURE",
  "instance": "<string>",
  "remedy": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>"
}

Authorizations

X-API-Key

string

header

required

Path Parameters

queue_id

string

required

Annotation queue ID

Query Parameters

status

enum<string>

required

Review section: needs_my_review, needs_others_review, or archived

Available options:

needs_my_review,

needs_others_review,

archived

page_size

integer

default:20

Page size (max 100)

cursor

string

Opaque pagination cursor

item_type

enum<string>

Filter to RUN or THREAD

Available options:

RUN,

THREAD

min_start_time

string<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_time

string<date-time>

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

direction

enum<string>

default:forward

Pagination direction. backward requires cursor

Available options:

forward,

backward

Response

items

object[]

Show child attributes

next_cursor

string

previous_cursor

string

SmithDB SDK migration

LangSmith REST API

List annotation queue items

Authorizations

Path Parameters

Query Parameters

Response