Core Memory Operations
Search Memories
Search memories with hybrid retrieval (semantic + BM25 + entity matching) and advanced filtering using logical and comparison operators.
POST
cURL
Relevance-ranked hybrid search across stored memories. V3 uses multi-signal retrieval: semantic, BM25 keyword, and entity matching scored in parallel and fused. The returned
score is a combined [0, 1] value.
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. At least one entity ID is required.
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
Search parameter defaults
Body
application/json