Skip to main content
POST
/
v1
/
lang-graph
/
threads
/
{threadId}
/
runs
Execute conversation run
curl --request POST \
  --url https://{your-prod-endpoint}/v1/lang-graph/threads/{threadId}/runs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-doctor: <x-doctor>' \
  --data '
{
  "input": {
    "messages": [
      {
        "role": "user",
        "content": "Hello, how can you help me today?"
      }
    ]
  },
  "config": {
    "configurable": {
      "thread_id": "thread-abc123"
    }
  }
}
'
{
  "run_id": "run-xyz789",
  "thread_id": "thread-abc123",
  "status": "pending",
  "created_at": "2023-10-09T10:00:00.000Z"
}

Authorizations

​
Authorization
string
header
required

Bearer token for API authentication

Headers

​
x-is-chat
boolean

Boolean flag to determine assistant type (true = chat/scribe, false = extraction)

​
x-doctor
string
required

Doctor identifier for tracking and auditing

​
x-patient
string

Patient identifier for tracking and auditing

Path Parameters

​
threadId
string
required

The thread identifier to execute the run in

Body

application/json
​
input
object
required
​
config
object
required

Response

Run created successfully

​
run_id
string
required

Unique run identifier

Example:

"run-xyz789"

​
thread_id
string
required

Associated thread identifier

Example:

"thread-abc123"

​
status
enum<string>
required

Current status of the run

Available options:
pending,
running,
completed,
failed
Example:

"pending"

​
created_at
string<date-time>
required

Timestamp when run was created

Example:

"2023-10-09T10:00:00.000Z"