API ReferenceREST API
Create session
Opens a new query session scoped to a patient. Sessions track interaction context across multiple MCP tool calls within a single agent run.
Authorization
Bearer writeAuthorizationBearer <token>
Each operation lists the OAuth scope (read or write) it requires.
In: header
Scope: write
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/string/sessions"{ "sessionId": "string", "patientId": "string", "createdAt": "string"}Get an ingestion GET
One submission and where its work stands. `status` is derived from the work the submission started, so this is the handle to poll after submitting — it stays valid for the life of that work.
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.