Create conversation thread

Creates a new conversation thread for AI-powered interactions (chat or clinical extraction). Initializes a stateful conversation session with the AI assistant. The thread maintains context across multiple interactions and is required before executing any conversation runs.

POST /v1/lang-graph/threads

Create conversation thread

cURL

curl --request POST \
  --url https://{your-prod-endpoint}/v1/lang-graph/threads \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-doctor: <x-doctor>' \
  --data '{}'

201

{
  "thread_id": "thread-abc123",
  "created_at": "2023-10-09T10:00:00.000Z",
  "status": "active"
}

Authorizations

Authorization · string · header · required

Bearer token for API authentication

Headers

x-doctor · string · required

Doctor identifier for tracking and auditing

x-patient · string

Patient identifier for tracking and auditing

Body

application/json

The body is of type object.

Response

201

application/json

Thread created successfully

thread_id · string · required

Unique thread identifier

Example:

"thread-abc123"

created_at · string<date-time> · required

Timestamp when thread was created

Example:

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

status · enum<string> · required

Current status of the thread

Available options: active, closed

Example:

"active"