v1

OpenAPI 3.0.1Apache 2.02026-07-135212282.4 KB

memories

Get all memories (V3, paginated)

List memories scoped by filters, paginated. Entity IDs must be passed inside the filters object. Top-level user_id / agent_id / run_id are rejected with 400. filters supports the same operator set as V2 search (AND, OR, NOT, in, gte, lte, etc.). Response is a paginated envelope; pass page and page_size as query parameters to step through results.

post/v3/memories/

Query parameters

pageinteger

1-indexed page number.

page_sizeinteger

Results per page.

Request body

filtersobject required

Entity and metadata filters. Must include at least one entity ID (user_id, agent_id, app_id, or run_id).

show_expiredboolean

When true, include memories whose expiration_date has passed. Expired memories are hidden by default.

Response

Paginated envelope of memories.

countinteger required

Total number of memories matching the filters.

nextstring uri nullable required

URL for the next page, or null if this is the last page.

previousstring uri nullable required

URL for the previous page, or null if this is the first page.