Create a thread

Create a thread bound to a Managed Deep Agent. Use the returned thread ID to start runs.

POST /threads

Create a thread

cURL

curl --request POST \
  --url https://api.smith.langchain.com/v1/deepagents/threads \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "agent_id": "11111111-1111-1111-1111-111111111111",
  "options": {
    "test_run": false,
    "skip_memory_write_protection": false
  }
}
'

201

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "metadata": {},
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

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

Show child attributes

Response

201

application/json

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>