Error

A valid request URL is required to generate request examples

{
  "items": [
    {
      "agent_id": "11111111-1111-1111-1111-111111111111",
      "created_at": "2026-01-15T09:30:00Z",
      "has_interrupts": false,
      "id": "22222222-2222-2222-2222-222222222222",
      "metadata": {},
      "state_updated_at": "2026-01-15T09:31:00Z",
      "status": "idle",
      "title": "Quarterly report draft",
      "updated_at": "2026-01-15T09:30:00Z"
    }
  ],
  "next_cursor": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

List threads for an agent

Returns one page of recent non-test threads for a single agent, ordered by latest conversation activity. Designed for the Agent Builder thread sidebar; returns a slim summary per thread without full LangGraph thread state.

Sort order is fixed to recency descending — state_updated_at desc nulls last, then updated_at desc nulls last, then created_at desc. By default only non-test threads are returned (test_run=false); pass test_run=true to list test-run threads instead. Pagination is cursor-based; pass next_cursor from the previous response to fetch the next page.

When requires_attention=true, the endpoint fans out to the three buckets that need user action — interrupted, error, and idle threads with metadata.read_status=false — and merges them into a single recency-ordered page. It cannot be combined with status.

Note: is_pinned is supported as a temporary filter while pinning lives in metadata; it will be removed once pinning becomes a first-class field.

GET

fleet

threads

Error

A valid request URL is required to generate request examples

{
  "items": [
    {
      "agent_id": "11111111-1111-1111-1111-111111111111",
      "created_at": "2026-01-15T09:30:00Z",
      "has_interrupts": false,
      "id": "22222222-2222-2222-2222-222222222222",
      "metadata": {},
      "state_updated_at": "2026-01-15T09:31:00Z",
      "status": "idle",
      "title": "Quarterly report draft",
      "updated_at": "2026-01-15T09:30:00Z"
    }
  ],
  "next_cursor": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

Authorizations

X-Api-Key

string

header

required

LangSmith API key (lsv2_...).

Query Parameters

agent_id

string<uuid>

required

Agent UUID. Required.

page_size

integer

Items per page (1-20). Default 20.

cursor

string

Opaque pagination cursor returned by the previous list call.

status

enum<string>

Filter to a single thread status.

Available options:

idle,

busy,

interrupted,

error

is_pinned

boolean

Filter by pinned state. Temporary; will be removed once pinning is first-class.

test_run

boolean

Return test-run threads instead of non-test threads. Default false.

requires_attention

boolean

Return only threads that need user action (interrupted, errored, or unread idle). Cannot be combined with status.

Response

items

object[]

Show child attributes

next_cursor

string

Get current Fleet user

Create a thread