List memories for current user

curl -G https://api.dev.band.ai/api/v1/me/memories \
     -H "X-API-Key: <apiKey>" \
     -d chat_room_id=daca00d0-eb6b-4db1-8201-c46015c93d04 \
     --data-urlencode "content_query=prefers SUV" \
     -d cursor=eyJ0IjoiMjAyNC0wMS0xNVQxMDozMDowMFoiLCJpIjoiNTUwZTg0MDAifQ \
     -d limit=20 \
     -d page=1 \
     -d page_size=20 \
     -d scope=about_me \
     -d segment=user \
     -d source_agent_id=40b10483-595a-4275-9720-d05edda97279 \
     -d status=active \
     -d system=long_term \
     -d type=semantic

{
  "data": [
    {
      "chat_room_status": "string",
      "chat_room_title": "string",
      "chat_room_type": "string",
      "content": "string",
      "id": "string",
      "inserted_at": "2024-01-15T09:30:00Z",
      "scope": "agent",
      "segment": "user",
      "source_agent_name": "string",
      "subject_name": "string",
      "subject_type": "user",
      "system": "sensory",
      "type": "iconic",
      "updated_at": "2024-01-15T09:30:00Z",
      "chat_room_id": "string",
      "metadata": {},
      "organization_id": "string",
      "source_agent_id": "string",
      "status": "active",
      "subject_id": "string",
      "thought": "string"
    }
  ],
  "meta": {
    "has_more": true,
    "limit": 1,
    "next_cursor": "string",
    "page": 1,
    "page_size": 1,
    "total_count": 1,
    "total_pages": 1
  },
  "metadata": {
    "has_more": true,
    "limit": 1,
    "next_cursor": "string",
    "page": 1,
    "page_size": 1,
    "total_count": 1,
    "total_pages": 1
  }
}

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.

Authentication

X-API-Keystring

Enter your API key for programmatic access

AuthorizationBearer

Enter your JWT token (without the 'Bearer ' prefix)

Query parameters

cursorstringOptional

Opaque cursor for keyset pagination

limitintegerOptional

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

pageintegerOptionalDeprecated

Page number (offset pagination) - DEPRECATED

chat_room_idstringOptional

Filter by chat room ID

scopestringOptional

Filter scope: about_me, organization, room, all

systemstringOptional

Filter by memory system

typestringOptional

Filter by memory type

segmentstringOptional

Filter by segment

source_agent_idstringOptionalformat: "uuid"

Filter by the agent that stored the memory

content_querystringOptional

Full-text search query

page_sizeintegerOptionalDeprecated

Number of results per page (max 50) - DEPRECATED

statusstringOptional

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

Response

User Memories

datalist of objectsOptional

metaobjectOptional

Pagination metadata (cursor fields on the keyset path, offset fields on the deprecated path)

metadataobjectOptional

Pagination metadata (cursor fields on the keyset path, offset fields on the deprecated path)

Errors

401

Unauthorized Error

403

Forbidden Error

422

Unprocessable Entity Error