Clinia
API ReferenceREST API

Create session

POST
/v1/patients/{patientId}/sessions

Opens a new query session scoped to a patient. Sessions track interaction context across multiple MCP tool calls within a single agent run.

Path Parameters

patientId*string

Registry key of the patient, as assigned by the caller when the first ingest was submitted.

Match^[A-Za-z0-9._-]{1,128}$

Response Body

application/json

application/json

curl -X POST "https://example.com/v1/patients/patient-123/sessions"
{
  "sessionId": "string",
  "patientId": "string",
  "startedAt": "string"
}
{
  "code": 1,
  "type": "ALREADY_EXISTS",
  "message": "string"
}