API ReferenceREST API
Get session
Returns metadata for a session.
Authorization
Bearer readAuthorizationBearer <token>
Each operation lists the OAuth scope (read or write) it requires.
In: header
Scope: read
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
curl -X GET "https://example.com/v1/patients/string/sessions/string"{ "sessionId": "string", "patientId": "string", "createdAt": "string"}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.
Append session messages POST
Appends user/assistant messages to an open session's transcript, in order. The session stays open. Tool-call turns are recorded separately by the MCP layer and are not accepted here.