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
  • 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.

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