Clinia
API ReferenceREST API

Append session messages

POST
/v1/patients/{patientId}/sessions/{sessionId}/messages

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.

Authorization

Bearer write
AuthorizationBearer <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.

Length1 <= length

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Messages to append to an open session.

Response Body

application/json

application/json

curl -X POST "https://example.com/v1/patients/string/sessions/string/messages" \  -H "Content-Type: application/json" \  -d '{    "messages": [      {        "role": "user",        "content": "string"      }    ]  }'
{  "ok": true,  "messageCount": 0}

Get session GET

Returns metadata for a session.

Generate session memories POST

Extracts memories from messages appended since the last run and infers memory↔fact relationships. The session stays active and can keep receiving messages. Append-only: it never re-extracts messages already covered by a prior run, so re-running it only adds memories for what's new, but it does not deduplicate against memories from a previous run. Call it intentionally rather than on every turn.