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 \
     -d scope=about_me \
     -d system=long_term \
     -d type=semantic \
     -d segment=user \
     --data-urlencode "content_query=prefers SUV" \
     -d page_size=20 \
     -d status=active

{
  "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": {
    "page_size": 1,
    "total_count": 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.

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.

Authentication

X-API-Keystring

Enter your API key for programmatic access

AuthorizationBearer

Enter your JWT token (without the ‘Bearer ’ prefix)

Query parameters

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_sizeintegerOptional

Number of results per page (max 50)

statusstringOptional

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

Response

User Memories

datalist of objects

metaobject

Errors

401

Unauthorized Error

403

Forbidden Error