Skip to main content
GET
/
api
/
v1
/
memories
List Memories
curl --request GET \
  --url https://api.example.com/api/v1/memories

​
Query Parameters

ParameterTypeDescription
scopeuser, agent, allDefaults to user; all includes user and agent rows
agent_idstringRequired when scope=agent; rejected for other scopes
kindcore, archivalOptional kind filter
limitintegerDefaults to 50; minimum 1, maximum 200
offsetintegerDefaults to 0

​
Response

{
  "memories": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "kind": "core",
      "content": "Prefers concise summaries.",
      "scope": "user",
      "agent_id": null,
      "created_at": "2026-04-30T16:00:00",
      "updated_at": "2026-04-30T16:30:00"
    }
  ],
  "total": 1,
  "limit": 50,
  "offset": 0
}