LangGraph provides the time travel functionality to resume execution from a prior checkpoint, either replaying the same state or modifying it to explore alternatives. In all cases, resuming past execution produces a new fork in the history. To time travel using the LangGraph Server API (via the LangGraph SDK):
  1. Run the graph with initial inputs using LangGraph SDK’s [client.runs.wait][langgraph_sdk.client.RunsClient.wait] or [client.runs.stream][langgraph_sdk.client.RunsClient.stream] APIs.
  2. Identify a checkpoint in an existing thread: Use [client.threads.get_history][langgraph_sdk.client.ThreadsClient.get_history] method to retrieve the execution history for a specific thread_id and locate the desired checkpoint_id. Alternatively, set a breakpoint before the node(s) where you want execution to pause. You can then find the most recent checkpoint recorded up to that breakpoint.
  3. (Optional) modify the graph state: Use the [client.threads.update_state][langgraph_sdk.client.ThreadsClient.update_state] method to modify the graph’s state at the checkpoint and resume execution from alternative state.
  4. Resume execution from the checkpoint: Use the [client.runs.wait][langgraph_sdk.client.RunsClient.wait] or [client.runs.stream][langgraph_sdk.client.RunsClient.stream] APIs with an input of None and the appropriate thread_id and checkpoint_id.

​
Use time travel in a workflow

​
1. Run the graph

from langgraph_sdk import get_client
client = get_client(url=<DEPLOYMENT_URL>)

# Using the graph deployed with the name "agent"
assistant_id = "agent"

# create a thread
thread = await client.threads.create()
thread_id = thread["thread_id"]

# Run the graph
result = await client.runs.wait(
    thread_id,
    assistant_id,
    input={}
)

​
2. Identify a checkpoint

# The states are returned in reverse chronological order.
states = await client.threads.get_history(thread_id)
selected_state = states[1]
print(selected_state)

​
3. Update the state

update_state will create a new checkpoint. The new checkpoint will be associated with the same thread, but a new checkpoint ID. 
new_config = await client.threads.update_state(
    thread_id,
    {"topic": "chickens"},
    # highlight-next-line
    checkpoint_id=selected_state["checkpoint_id"]
)
print(new_config)

​
4. Resume execution from the checkpoint

await client.runs.wait(
    thread_id,
    assistant_id,
    # highlight-next-line
    input=None,
    # highlight-next-line
    checkpoint_id=new_config["checkpoint_id"]
)

​
Learn more