Skip to main content
POST
Error

Authorizations

X-Api-Key
string
header
required

LangSmith API key (lsv2_...).

Body

application/json

Thread creation payload

agent_id
string
Example:

"11111111-1111-1111-1111-111111111111"

if_exists
enum<string>
Available options:
do_nothing,
raise
metadata
object
options
object
thread_id
string<uuid>

Response

Created

agent_id
string<uuid>
Example:

"11111111-1111-1111-1111-111111111111"

created_at
string<date-time>
Example:

"2026-01-15T09:30:00Z"

id
string<uuid>
Example:

"22222222-2222-2222-2222-222222222222"

metadata
object
status
enum<string>
Available options:
idle,
busy,
interrupted,
error
Example:

"idle"

updated_at
string<date-time>
Example:

"2026-01-15T09:30:00Z"