Skip to main content
POST
/
threads
/
{thread_id}
/
history
Get Thread History Post
curl --request POST \
  --url https://api.example.com/threads/{thread_id}/history \
  --header 'Content-Type: application/json' \
  --data '
{
  "limit": 1,
  "before": {
    "thread_id": "<string>",
    "checkpoint_ns": "<string>",
    "checkpoint_id": "<string>",
    "checkpoint_map": {}
  },
  "metadata": {},
  "checkpoint": {
    "thread_id": "<string>",
    "checkpoint_ns": "<string>",
    "checkpoint_id": "<string>",
    "checkpoint_map": {}
  }
}
'
[
  {
    "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.

Body

application/json
​
limit
integer
default:1

The maximum number of states to return.

Required range: 1 <= x <= 1000
​
before
Before · object

Return states before this checkpoint.

​
metadata
Metadata · object

Filter states by metadata key-value pairs.

​
checkpoint
Checkpoint · object

Return states for this subgraph.

Response

Success

​
values
object
required
​
next
string[]
required
​
checkpoint
Checkpoint · object
required

Checkpoint config.

​
metadata
Metadata · object
required
​
created_at
string
required
​
tasks
Tasks · object[]
​
parent_checkpoint
Parent Checkpoint · object
​
interrupts
Interrupt · object[]