Read memories

GET

state

{patient_id}

memories

import olira

olira.init(api_key="YOUR_API_KEY")
mem = olira.read_memories(patient_id="8a4fde23-0f1b-4c2a-9d7e-b36c1a5f0e82", query="appointment", limit=20)
print(mem.results)

using Olira;

OliraModule.Init(apiKey: "YOUR_API_KEY");
var mem = OliraModule.ReadMemories(patientId: "8a4fde23-0f1b-4c2a-9d7e-b36c1a5f0e82", query: "appointment", limit: 20);
Console.WriteLine(mem.Results);

GET /v1/state/8a4fde23-0f1b-4c2a-9d7e-b36c1a5f0e82/memories?query=appointment&limit=20
Authorization: Bearer YOUR_API_KEY

MemoriesResult(
    patient_id="8a4fde23-0f1b-4c2a-9d7e-b36c1a5f0e82",
    count=1,
    results=[
        MemoryEntry(
            memory_id="mem-001",
            content="Patient prefers morning appointments.",
            metadata={"source": "conversation"},
            created_at="2026-01-10T15:00:00Z",
            updated_at=None,
        ),
    ],
)

{
  "error": true,
  "status_code": 401,
  "error_type": "authentication_error",
  "message": "Could not validate credentials",
  "details": [
    {
      "type": "authentication_error",
      "message": "Could not validate credentials"
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

{
  "error": true,
  "status_code": 403,
  "error_type": "authorization_error",
  "message": "Insufficient OAuth scope for this endpoint",
  "details": [
    {
      "type": "authorization_error",
      "message": "Insufficient OAuth scope for this endpoint"
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

{
  "error": true,
  "status_code": 404,
  "error_type": "not_found_error",
  "message": "Patient not found",
  "details": [
    {
      "type": "not_found_error",
      "message": "Patient not found"
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

{
  "error": true,
  "status_code": 422,
  "error_type": "validation_error",
  "message": "Request validation failed (1 error)",
  "details": [
    {
      "type": "missing",
      "message": "Field required",
      "field": "patient_id",
      "location": ["body", "patient_id"],
      "input_value": null
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

{
  "error": true,
  "status_code": 429,
  "error_type": "server_error",
  "message": "Rate limit exceeded",
  "details": [
    {
      "type": "rate_limit",
      "message": "Too many requests; retry after backoff"
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

{
  "error": true,
  "status_code": 500,
  "error_type": "internal_server_error",
  "message": "An internal server error occurred",
  "details": [
    {
      "type": "internal_server_error",
      "message": "An unexpected error occurred while processing your request"
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

olira.read_memories(
    patient_id: str,
    query: str | None = None,
    limit: int = 100,
) -> MemoriesResult

OliraModule.ReadMemories(
    string patientId,
    string? query = null,
    int limit = 100,
)  // -> MemoriesResult

Requires scope: sdk:state-read Omit query to list up to limit; pass query for text search.

Parameters

str

required

Olira patient id.

str | None

Optional search string.

int

default:"100"

Max memories.

Returns

MemoriesResult

str

Patient id.

int

Returned count.

list[MemoryEntry]

Memory rows.

str

Memory id.

str

Text content.

dict | None

Optional metadata.

str | None

Created at.

str | None

Updated at.

Raises

Exception	When
`AuthError`	HTTP 401 or 403 — invalid API key or insufficient OAuth scope for this endpoint.
`ValidationError`	HTTP 400, 404, or 422 — malformed JSON, unknown patient, or validation failure (message includes response excerpt).
`ServerError`	HTTP 409 (e.g. conflicting external identifier) or repeated 5xx after retries; includes status_code when applicable.
`RateLimitError`	HTTP 429 — rate limited; check retry_after (seconds).
`NetworkError`	Connection timeout, DNS failure, or read error after retries.

import olira

olira.init(api_key="YOUR_API_KEY")
mem = olira.read_memories(patient_id="8a4fde23-0f1b-4c2a-9d7e-b36c1a5f0e82", query="appointment", limit=20)
print(mem.results)

using Olira;

OliraModule.Init(apiKey: "YOUR_API_KEY");
var mem = OliraModule.ReadMemories(patientId: "8a4fde23-0f1b-4c2a-9d7e-b36c1a5f0e82", query: "appointment", limit: 20);
Console.WriteLine(mem.Results);

GET /v1/state/8a4fde23-0f1b-4c2a-9d7e-b36c1a5f0e82/memories?query=appointment&limit=20
Authorization: Bearer YOUR_API_KEY

MemoriesResult(
    patient_id="8a4fde23-0f1b-4c2a-9d7e-b36c1a5f0e82",
    count=1,
    results=[
        MemoryEntry(
            memory_id="mem-001",
            content="Patient prefers morning appointments.",
            metadata={"source": "conversation"},
            created_at="2026-01-10T15:00:00Z",
            updated_at=None,
        ),
    ],
)

{
  "error": true,
  "status_code": 401,
  "error_type": "authentication_error",
  "message": "Could not validate credentials",
  "details": [
    {
      "type": "authentication_error",
      "message": "Could not validate credentials"
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

{
  "error": true,
  "status_code": 403,
  "error_type": "authorization_error",
  "message": "Insufficient OAuth scope for this endpoint",
  "details": [
    {
      "type": "authorization_error",
      "message": "Insufficient OAuth scope for this endpoint"
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

{
  "error": true,
  "status_code": 404,
  "error_type": "not_found_error",
  "message": "Patient not found",
  "details": [
    {
      "type": "not_found_error",
      "message": "Patient not found"
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

{
  "error": true,
  "status_code": 422,
  "error_type": "validation_error",
  "message": "Request validation failed (1 error)",
  "details": [
    {
      "type": "missing",
      "message": "Field required",
      "field": "patient_id",
      "location": ["body", "patient_id"],
      "input_value": null
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

{
  "error": true,
  "status_code": 429,
  "error_type": "server_error",
  "message": "Rate limit exceeded",
  "details": [
    {
      "type": "rate_limit",
      "message": "Too many requests; retry after backoff"
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

{
  "error": true,
  "status_code": 500,
  "error_type": "internal_server_error",
  "message": "An internal server error occurred",
  "details": [
    {
      "type": "internal_server_error",
      "message": "An unexpected error occurred while processing your request"
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

import olira

olira.init(api_key="YOUR_API_KEY")
mem = olira.read_memories(patient_id="8a4fde23-0f1b-4c2a-9d7e-b36c1a5f0e82", query="appointment", limit=20)
print(mem.results)

using Olira;

OliraModule.Init(apiKey: "YOUR_API_KEY");
var mem = OliraModule.ReadMemories(patientId: "8a4fde23-0f1b-4c2a-9d7e-b36c1a5f0e82", query: "appointment", limit: 20);
Console.WriteLine(mem.Results);

GET /v1/state/8a4fde23-0f1b-4c2a-9d7e-b36c1a5f0e82/memories?query=appointment&limit=20
Authorization: Bearer YOUR_API_KEY

MemoriesResult(
    patient_id="8a4fde23-0f1b-4c2a-9d7e-b36c1a5f0e82",
    count=1,
    results=[
        MemoryEntry(
            memory_id="mem-001",
            content="Patient prefers morning appointments.",
            metadata={"source": "conversation"},
            created_at="2026-01-10T15:00:00Z",
            updated_at=None,
        ),
    ],
)

{
  "error": true,
  "status_code": 401,
  "error_type": "authentication_error",
  "message": "Could not validate credentials",
  "details": [
    {
      "type": "authentication_error",
      "message": "Could not validate credentials"
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

{
  "error": true,
  "status_code": 403,
  "error_type": "authorization_error",
  "message": "Insufficient OAuth scope for this endpoint",
  "details": [
    {
      "type": "authorization_error",
      "message": "Insufficient OAuth scope for this endpoint"
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

{
  "error": true,
  "status_code": 404,
  "error_type": "not_found_error",
  "message": "Patient not found",
  "details": [
    {
      "type": "not_found_error",
      "message": "Patient not found"
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

{
  "error": true,
  "status_code": 422,
  "error_type": "validation_error",
  "message": "Request validation failed (1 error)",
  "details": [
    {
      "type": "missing",
      "message": "Field required",
      "field": "patient_id",
      "location": ["body", "patient_id"],
      "input_value": null
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

{
  "error": true,
  "status_code": 429,
  "error_type": "server_error",
  "message": "Rate limit exceeded",
  "details": [
    {
      "type": "rate_limit",
      "message": "Too many requests; retry after backoff"
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

{
  "error": true,
  "status_code": 500,
  "error_type": "internal_server_error",
  "message": "An internal server error occurred",
  "details": [
    {
      "type": "internal_server_error",
      "message": "An unexpected error occurred while processing your request"
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

Log types

SDK

Read memories

Parameters

Returns

Raises

​Parameters

​Returns

​Raises

Parameters

Returns

Raises