Memory
List memory entries
List memory entries. Requires permission memory:read.
GET
List memory entries
The reference panel describes the current v3 operation. The notes below describe its v2 compatibility API. Follow the v3 request schema for current calls: v3 can move identifiers from the body or query into the URL. Keep the v2 method, path, and payload together when using the compatibility API.
v2 compatibility notes
GET /api/v2/memory/list answers one page of memory entries. Pass limit (1 to 100, default 50; a larger value is 400 too_big) and, after the first page, cursor set to the previous page’s meta.nextCursor. Continue while meta.hasMore is true; meta.nextCursor is null on the last page.
layer=longterm(requiresagentId): the agent’sACTIVElong-term entries, newest first.layer=channelwithagentId: the agent’s channel entries inchannelIdorder. WithchannelIdalone (platform keys only): every agent’s entry for that channel, in creation order. With both: at most one entry, in a single page.
meta.hasMore, not the page size. An agentId outside the caller’s reach (an External App’s owner-scope chain; for an API key, memory:read at the agent’s home), or a Personal Agent, answers an empty list, and a listing by channelId alone leaves out such agents’ entries.
Errors
400 bad_request
400 bad_request
An unsupported
layer (layer_not_supported); a limit of 0, a negative or non-integer value, or a repeated limit (Invalid limit); a malformed or repeated cursor, or one issued for another listing (Invalid cursor); a malformed channelId (Invalid channelId); or a missing agentId where one is required.Authorizations
Query Parameters
Response
One page of memory entries

