Clinia
API ReferenceREST API

List session memories

GET
/v1/patients/{patientId}/sessions/{sessionId}/memories

Returns the memories extracted from this session, paginated. Sorted by createdAt descending (newest first) by default.

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

Query Parameters

page?|

Zero-indexed page of memories to return. Defaults to 0.

Default0
Range0 <= value
perPage?integer

Number of memories per page. Defaults to 100; maximum is 1000.

Default100
Range1 <= value <= 1000
sort?string

Field to sort by. One of: createdAt. Defaults to createdAt.

Default"createdAt"
Value in"createdAt"
order?string

Sort direction. Defaults to desc.

Default"desc"
Value in"asc" | "desc"

Response Body

application/json

application/json

curl -X GET "https://example.com/v1/patients/patient-123/sessions/session-456/memories"
{
  "data": [
    {
      "id": "string",
      "type": "symptom",
      "content": "string",
      "sessionId": "string",
      "createdAt": "string"
    }
  ],
  "meta": {
    "total": 0,
    "page": 0,
    "perPage": 0
  }
}
{
  "code": 1,
  "type": "ALREADY_EXISTS",
  "message": "string"
}

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.

Browse VFS GET

Lists the contents of a VFS path. Returns directory children with name, type, and preview, or file content when the path resolves to a file. Paths are relative to the patient root (e.g. `/conditions/active`); the patient is identified by the `patientId` route param. Defaults to the root when `path` is omitted.