threads

Specifies behavior on conflict:

• "raise": Raise an exception when a conflict occurs.
• "do_nothing": Ignore conflicts and proceed.

Strategy for pruning threads:

• "delete": Remove threads entirely.
• "keep_latest": Prune old checkpoints but keep threads and their latest state.

The order to sort by.

The field to sort by.

Represents the status of a thread:

• "idle": The thread is not currently processing any task.
• "busy": The thread is actively processing a task.
• "interrupted": The thread's execution was interrupted.
• "error": An exception occurred during task processing.

Defines the mode of streaming:

• "run_modes": Stream the same events as the runs on thread, as well as run_done events.
• "lifecycle": Stream only run start/end events.
• "state_update": Stream state updates on the thread.

Handle async requests to the LangGraph API.

Adds additional error messaging & content handling above the provided httpx client.

Represents a checkpoint in the execution process.

Represents a part of a stream response.

Represents a conversation thread.

Represents the state of a thread.

Represents the response from updating a thread's state.

Represents a JSON-like structure, which can be None or a dictionary with string keys and any values.

Client for managing threads in LangGraph.

A thread maintains the state of a graph across multiple interactions/invocations (aka runs). It accumulates and persists the graph's state, allowing for continuity between separate invocations of the graph.

client = get_client(url="http://localhost:2024"))
new_thread = await client.threads.create(metadata={"user_id": "123"})