v3

latestOpenAPI 3.0.1Apache 2.02026-08-065516357.9 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.

start_datestring date

Only include memories created on or after this date (YYYY-MM-DD).

end_datestring date

Only include memories created on or before this date (YYYY-MM-DD).

categoriesstring[]

Restrict results to memories tagged with any of these categories.

fieldsstring[]

Restrict the fields returned per memory, e.g. ["id", "memory"].

keywordsstring

Free-text keyword filter applied on top of filters.

pageinteger

1-indexed page number. Also accepted here in the request body; the query parameter of the same name takes precedence.

page_sizeinteger

Results per page. Also accepted here in the request body; the query parameter of the same name takes precedence.

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.