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"
}

Autorizaciones

Authorization · string · header · requerido

Bearer token for API authentication

Encabezados

x-doctor · string · requerido

Doctor identifier for tracking and auditing

x-patient · string

Patient identifier for tracking and auditing

Cuerpo

application/json

The body is of type object.

Respuesta

201

application/json

Thread created successfully

thread_id · string · requerido

Unique thread identifier

Ejemplo:

"thread-abc123"

created_at · string<date-time> · requerido

Timestamp when thread was created

Ejemplo:

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

status · enum<string> · requerido

Current status of the thread

Opciones disponibles: active, closed

Ejemplo:

"active"