Sign in
humanApiMemories

List memories for current user

Lists memories accessible to the authenticated user:

  • Memories about the user (subject_id = user's UUID)
  • Organization-scoped memories in the user's organization
  • The agent-scoped private memories of the agents this user owns, which carry no organization and so come back with organization_id: null
  • Optionally filter by chat room to see room-level memories

Unlike agents, users can see memories from ALL agents in their organization that are about them or in rooms they participate in. Another owner's agents' private memories are never returned.

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

Display fields: each row carries subject_name, subject_type, source_agent_name, chat_room_title, chat_room_status and chat_room_type next to the raw ids, so a table can be labelled without a follow-up request per row. They are resolved once for the whole page. Every one of them is nullable: a referent that was deleted, or that the caller may not see, reads as null while its id is still returned.

get/api/v1/me/memories

Query parameters

cursorstring

Opaque cursor for keyset pagination

limitinteger

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

pageinteger

Page number (offset pagination) - DEPRECATED

chat_room_idstring

Filter by chat room ID

scopestring

Filter scope: about_me, organization, room, all

systemstring

Filter by memory system

typestring

Filter by memory type

segmentstring

Filter by segment

source_agent_idstring uuid

Filter by the agent that stored the memory

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

User Memories

MemoriesListUserMemoriesResponse200 required— unresolved $ref

Changes