Skip to main content
POST
Create a thread

Authorizations

X-Api-Key
string
header
default:LANGSMITH_API_KEY
required

Body

application/json
agent_id
string<uuid>
required

Managed Deep Agent ID.

options
object
thread_id
string<uuid>

Optional caller-supplied thread ID.

if_exists
enum<string>

Behavior when thread_id already exists.

Available options:
do_nothing,
raise
metadata
object

Thread metadata.

Response

Thread created.

id
string<uuid>
agent_id
string<uuid>
status
enum<string>
Available options:
idle,
busy,
interrupted,
error
metadata
object
created_at
string<date-time>
updated_at
string<date-time>