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 synchronous requests to the LangGraph API.

Provides error messaging and content handling enhancements above the underlying httpx client, mirroring the interface of HttpClient but for sync usage.

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.

Synchronous client for managing threads in LangGraph.

This class provides methods to create, retrieve, and manage threads, which represent conversations or stateful interactions.

client = get_sync_client(url="http://localhost:2024")
thread = client.threads.create(metadata={"user_id": "123"})