agentApiMemories

List memories

Lists memories accessible to the agent. Two independent dimensions:

memory_scope — WHOSE memories. me (default) returns only the memories this agent stored, whatever their scope. org returns the organization's shared memories, and is rejected with 422 when the agent belongs to no organization.
scope — WHICH category. Omitted at memory_scope=me it does not narrow at all. Omitted at memory_scope=org it means organization: an org-wide read returns the organization's shared knowledge, never subject-scoped memories about unrelated people. A subject is reachable only by passing scope=subject with its subject_id.

Another agent's agent-scoped memories are never returned, at any memory_scope.

Use content_query for full-text search across memory content.

Pagination: Use cursor + limit (recommended) OR page + page_size (deprecated, sunset 2026-10-01). Do NOT mix families.

get/api/v1/agent/memories

Query parameters

cursorstring

Opaque cursor for keyset pagination

limitinteger

Max results per request (1-100, default 20)

pageinteger

Page number (offset pagination) - DEPRECATED

subject_idstring

Filter by subject UUID (required for subject-scoped queries)

scopestring

Filter by scope: agent, subject, organization, or all

memory_scope'me' | 'org'

Whose memories to return: 'me' (default, this agent only) or 'org' (all agents in the organization)

systemstring

Filter by memory system

typestring

Filter by memory type

segmentstring

Filter by segment

content_querystring

Full-text search query

page_sizeinteger

Number of results per page (max 50) - DEPRECATED

statusstring

Filter by status: active, superseded, archived, or all

X-API-Keystring required

Enter your API key for programmatic access

Memories

MemoriesListAgentMemoriesResponse200 required— unresolved $ref