Get Thread History

Get all past states for a thread.

GET /threads/{thread_id}/history

Try it

200

[
  {
    "values": [
      {}
    ],
    "next": [
      "<string>"
    ],
    "checkpoint": {
      "thread_id": "<string>",
      "checkpoint_ns": "<string>",
      "checkpoint_id": "<string>",
      "checkpoint_map": {}
    },
    "metadata": {},
    "created_at": "<string>",
    "tasks": [
      {
        "id": "<string>",
        "name": "<string>",
        "error": "<string>",
        "interrupts": [
          {
            "value": {},
            "id": "<string>"
          }
        ],
        "checkpoint": {
          "thread_id": "<string>",
          "checkpoint_ns": "<string>",
          "checkpoint_id": "<string>",
          "checkpoint_map": {}
        },
        "state": "<unknown>"
      }
    ],
    "parent_checkpoint": {},
    "interrupts": [
      {
        "value": {},
        "id": "<string>"
      }
    ]
  }
]

Path Parameters

thread_id · string<uuid> · required

The ID of the thread.

Query Parameters

limit · integer · default: 10

before · string

Response

200

application/json

Success

values · object · required

Values · object[]

Values · object

next · string[] · required

checkpoint · Checkpoint · object · required

Checkpoint config.

Show child attributes

checkpoint. thread_id · string

Unique identifier for the thread associated with this checkpoint.

checkpoint. checkpoint_ns · string

Namespace for the checkpoint, used for organization and retrieval.

checkpoint. checkpoint_id · string

Optional unique identifier for the checkpoint itself.

checkpoint. checkpoint_map · object

Optional dictionary containing checkpoint-specific data.

metadata · Metadata · object · required

created_at · string · required

tasks · Tasks · object[]

Show child attributes

tasks. id · string · required

tasks. name · string · required

tasks. error · string

tasks. interrupts · Interrupt · object[]

Show child attributes

tasks.interrupts. value · object · required

tasks.interrupts. id · string | null

tasks. checkpoint · Checkpoint · object

Checkpoint config.

Show child attributes

tasks.checkpoint. thread_id · string

Unique identifier for the thread associated with this checkpoint.

tasks.checkpoint. checkpoint_ns · string

Namespace for the checkpoint, used for organization and retrieval.

tasks.checkpoint. checkpoint_id · string

Optional unique identifier for the checkpoint itself.

tasks.checkpoint. checkpoint_map · object

Optional dictionary containing checkpoint-specific data.

tasks. state · any

parent_checkpoint · Parent Checkpoint · object

interrupts · Interrupt · object[]

Show child attributes

interrupts. value · object · required

interrupts. id · string | null