List memories for current user

curl -G https://app.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 status=active \
     -d system=long_term \
     -d type=semantic

{
  "data": [
    {
      "content": "string",
      "id": "string",
      "inserted_at": "2024-01-15T09:30:00Z",
      "scope": "subject",
      "segment": "user",
      "system": "sensory",
      "type": "iconic",
      "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
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.

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.

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

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 objects

metaobject

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

metadataobject

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