agentApiMemories

List memories

Lists memories accessible to the agent. By default returns:

  • Memories about the specified subject (cross-agent sharing)
  • Organization-wide shared memories

Use scope parameter to filter by visibility. 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: subject, organization, or all

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

Headers

X-API-Keystring required

Enter your API key for programmatic access

Response

Memories

MemoriesListAgentMemoriesResponse200 required— unresolved $ref

Changes