API ReferenceREST API
Get session
Returns metadata for a session.
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/patient-123/sessions/session-456"{
"sessionId": "string",
"patientId": "string",
"createdAt": "string"
}{
"code": 1,
"type": "ALREADY_EXISTS",
"message": "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.