Update Thread State
Update thread state or retrieve it via POST.
When values is provided, creates a new checkpoint with the updated state.
Use as_node to attribute the update to a specific graph node. When
values is null AND as_node is not provided, this endpoint acts as a
POST-based alternative to the GET state endpoint (useful when passing
complex checkpoint/subgraph parameters in the request body).
When values is null AND as_node is provided (e.g. as_node="__copy__"
as LangGraph Studio sends for “Re-run from here”), this creates a new
checkpoint derived from the supplied checkpoint_id without applying
any state change — used to anchor a subsequent run as a fork of that
checkpoint rather than of the thread’s latest state.
Documentation Index
Fetch the complete documentation index at: https://docs.aegra.dev/llms.txt
Use this file to discover all available pages before exploring further.
Path Parameters
Body
Request model for updating thread state
The values to update the state with
- Values · object
- Values · object[]
The checkpoint to update the state of
Optional checkpoint ID to update from
Update the state as if this node had just executed
Include states from subgraphs
Checkpoint namespace
Response
Successful Response
- ThreadState
- ThreadStateUpdateResponse
Thread state model for history endpoint
Channel values (messages, etc.)
Current checkpoint
Next nodes to execute
Tasks to execute
Interrupt data
Checkpoint metadata
Timestamp of state creation
Parent checkpoint
Checkpoint ID (for backward compatibility)
Parent checkpoint ID (for backward compatibility)