API ReferenceREST API
Upsert a session
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.
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}$sessionId*string
Unique session ID returned when the session was created.
Length
1 <= lengthResponse Body
application/json
application/json
application/json
curl -X PUT "https://example.com/v1/patients/string/sessions/string"{ "sessionId": "string", "patientId": "string", "createdAt": "string"}