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

ID of the patient

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",
  "createdAt": "string"
}
{
  "code": 1,
  "type": "ALREADY_EXISTS",
  "message": "string"
}

Get ingest execution GET

Returns full detail for a single ingest execution: stage-level timings, per-entity-type and per-source delta breakdowns, entity merge count, extraction warnings, and error detail if failed.

Upsert a session PUT

Idempotently opens a session under a caller-provided id: creates it if new, or returns the existing session unchanged. Sessions track interaction context across multiple MCP tool calls within a single agent run.