List Memories

Retrieve paginated list of user memories with filtering and search capabilities. Filter by user, agent, team, topics, or search within memory content.

GET /memories

List Memories

cURL

curl --request GET \
  --url https://api.example.com/memories \
  --header 'Authorization: Bearer <token>'

200

{
  "data": [
    {
      "memory_id": "f9361a69-2997-40c7-ae4e-a5861d434047",
      "memory": "User likes coffee.",
      "topics": [
        "preferences"
      ],
      "user_id": "123",
      "updated_at": "2025-09-01T07:53:17Z"
    }
  ]
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

user_id · string | null

Filter memories by user ID

agent_id · string | null

Filter memories by agent ID

team_id · string | null

Filter memories by team ID

search_content · string | null

Fuzzy search within memory content

limit · integer | null · default: 20

Number of memories to return per page

Required range: x >= 1

page · integer | null · default: 1

Page number for pagination

Required range: x >= 0

sort_by · string | null · default: updated_at

Field to sort memories by

sort_order · enum<string> | null · default: desc

Sort order (asc or desc)

Available options: asc, desc

db_id · string | null

Database ID to query memories from

table · string | null

The database table to use

topics · string[] | null

Comma-separated list of topics to filter by

Example:

"preferences,technical,communication_style"

Response

200

application/json

Memories retrieved successfully

data · UserMemorySchema · object[] · required

List of items for the current page

Show child attributes

meta · PaginationInfo · object · required

Pagination metadata

Show child attributes