Get Memories
Retrieve memories with paginated results and advanced filtering using logical operators like AND, OR, NOT, and comparison queries.
user_id, agent_id, app_id, run_id) must be passed inside the filters object: top-level entity IDs are rejected with 400.
Expired memories are hidden by default. Pass show_expired: true to include memories whose expiration_date has passed.
Python uses show_expired; TypeScript uses showExpired.
The filters object supports complex logical operations (AND, OR, NOT) and comparison operators:
in: Matches any of the values specifiedgte: Greater than or equal tolte: Less than or equal togt: Greater thanlt: Less thanne: Not equal toicontains: Case-insensitive containment check*: Wildcard character that matches everything
page and page_size as query parameters to paginate through results.
count, next, previous, and results. Use page and page_size query params to step through results.Query Parameters
1-indexed page number.
x >= 1Results per page.
1 <= x <= 200Body
Entity and metadata filters. Must include at least one entity ID (user_id, agent_id, app_id, or run_id).
When true, include memories whose expiration_date has passed. Expired memories are hidden by default.
Only include memories created on or after this date (YYYY-MM-DD).
Only include memories created on or before this date (YYYY-MM-DD).
Restrict results to memories tagged with any of these categories.
Restrict the fields returned per memory, e.g. ["id", "memory"].
Free-text keyword filter applied on top of filters.
1-indexed page number. Also accepted here in the request body; the query parameter of the same name takes precedence.
Results per page. Also accepted here in the request body; the query parameter of the same name takes precedence.
Response
Paginated envelope of memories.