Get thread - Docs by LangChain

Error

A valid request URL is required to generate request examples

{
  "agent_id": "11111111-1111-1111-1111-111111111111",
  "config": {},
  "created_at": "2026-01-15T09:30:00Z",
  "error": "<unknown>",
  "id": "22222222-2222-2222-2222-222222222222",
  "interrupts": {},
  "metadata": {},
  "state_updated_at": "2026-01-15T09:31:00Z",
  "status": "idle",
  "thread_id": "22222222-2222-2222-2222-222222222222",
  "title": "Quarterly report draft",
  "updated_at": "2026-01-15T09:30:00Z",
  "values": {}
}

{
  "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>"
}

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

GET

fleet

threads

{thread_id}

Error

A valid request URL is required to generate request examples

{
  "agent_id": "11111111-1111-1111-1111-111111111111",
  "config": {},
  "created_at": "2026-01-15T09:30:00Z",
  "error": "<unknown>",
  "id": "22222222-2222-2222-2222-222222222222",
  "interrupts": {},
  "metadata": {},
  "state_updated_at": "2026-01-15T09:31:00Z",
  "status": "idle",
  "thread_id": "22222222-2222-2222-2222-222222222222",
  "title": "Quarterly report draft",
  "updated_at": "2026-01-15T09:30:00Z",
  "values": {}
}

{
  "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>"
}

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

Authorizations

X-Api-Key

string

header

required

LangSmith API key (lsv2_...).

Path Parameters

thread_id

string

required

Thread id

Response

agent_id

string<uuid>

Example:

"11111111-1111-1111-1111-111111111111"

config

object

Run configuration captured on the thread's latest checkpoint.

Show child attributes

created_at

string<date-time>

Example:

"2026-01-15T09:30:00Z"

error

any

Details of the last run's failure, if any.

string<uuid>

Example:

"22222222-2222-2222-2222-222222222222"

interrupts

object

Pending interrupts awaiting resolution, keyed by interrupt ID.

Show child attributes

metadata

object

Show child attributes

state_updated_at

string<date-time>

When the thread's state last changed; null until the thread has run.

Example:

"2026-01-15T09:31:00Z"

status

enum<string>

Available options:

idle,

busy,

interrupted,

error

Example:

"idle"

thread_id

string<uuid>

Example:

"22222222-2222-2222-2222-222222222222"

title

string

Example:

"Quarterly report draft"

updated_at

string<date-time>

Example:

"2026-01-15T09:30:00Z"

values

object

Current thread state — the agent graph's channel values.

Show child attributes

Search threads

Delete thread