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 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.