Skip to main content
POST
/
threads
/
runs
Create a thread and start a run
curl --request POST \
  --url https://api.smith.langchain.com/v1/deepagents/threads/runs \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "agent_id": "11111111-1111-1111-1111-111111111111",
  "thread": {
    "thread_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "metadata": {},
    "options": {
      "test_run": true,
      "skip_memory_write_protection": false
    }
  }
}
'
{}

Authorizations

​
X-Api-Key
string
header
default:LANGSMITH_API_KEY
required

Body

application/json
​
agent_id
string
required

Managed Deep Agent ID.

Example:

"11111111-1111-1111-1111-111111111111"

​
thread
object

Response

Run returned.

The response is of type object.