cURL
Core Memory Operations
Get Memories
Retrieve memories with paginated results and advanced filtering using logical operators like AND, OR, NOT, and comparison queries.
POST
cURL
List memories scoped by filters with paginated results. Entity IDs (
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.
The response is a paginated envelope with
count, next, previous, and results. Use page and page_size query params to step through results.Query Parameters
1-indexed page number.
Required range:
x >= 1Results per page.
Required range:
1 <= x <= 200Body
application/json
Response
Paginated envelope of memories.