Get Thread History Get

Get the checkpoint history for a thread.

Returns a list of past states ordered from newest to oldest. Use limit to control how many states are returned and before to paginate.

GET /threads/{thread_id}/history

Get Thread History Get

cURL

curl --request GET \
  --url https://api.example.com/threads/{thread_id}/history

200

[
  {
    "values": {},
    "checkpoint": {
      "checkpoint_id": "<string>",
      "thread_id": "<string>",
      "checkpoint_ns": ""
    },
    "next": [
      "<string>"
    ],
    "tasks": [
      {}
    ],
    "interrupts": [
      {}
    ],
    "metadata": {},
    "created_at": "2023-11-07T05:31:56Z",
    "parent_checkpoint": {
      "checkpoint_id": "<string>",
      "thread_id": "<string>",
      "checkpoint_ns": ""
    },
    "checkpoint_id": "<string>",
    "parent_checkpoint_id": "<string>"
  }
]

Path Parameters

thread_id · string · required

Query Parameters

limit · integer · default: 10

Number of states to return

Required range: 1 <= x <= 1000

before · string | null

Return states before this checkpoint ID

subgraphs · boolean | null · default: false

Include states from subgraphs

checkpoint_ns · string | null

Checkpoint namespace

metadata · string | null

JSON-encoded metadata filter

Response

200

application/json

Successful Response

values · Values · object · required

Channel values (messages, etc.)

checkpoint · ThreadCheckpoint · object · required

Current checkpoint

Show child attributes

next · string[]

Next nodes to execute

tasks · Tasks · object[]

Tasks to execute

interrupts · Interrupts · object[]

Interrupt data

metadata · Metadata · object

Checkpoint metadata

created_at · string<date-time> | null

Timestamp of state creation

parent_checkpoint · ThreadCheckpoint · object

Parent checkpoint

Show child attributes

checkpoint_id · string | null

Checkpoint ID (for backward compatibility)

parent_checkpoint_id · string | null

Parent checkpoint ID (for backward compatibility)