v1

OpenAPI 3.0.1Apache 2.02026-07-135212282.4 KB

memories

Search memories (V3)

Relevance-ranked search across stored memories. V3 uses hybrid retrieval and can also apply temporal reasoning for time-aware queries. Entity IDs must be passed inside the filters object. Top-level user_id / agent_id / run_id are rejected with 400. At least one entity ID is required.

post/v3/memories/search/

Request body

querystring required

Natural-language search query.

filtersobject required

Entity and metadata filters. Must include at least one entity ID (user_id, agent_id, app_id, or run_id). Supports AND, OR, NOT, and comparison operators (in, gte, lte, gt, lt, contains, icontains, ne).

show_expiredboolean

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

top_kinteger

Number of results to return.

thresholdnumber

Minimum semantic relevance score. Pass 0.0 to disable filtering.

rerankboolean

Apply the managed reranker for better ordering (adds latency).

Response

Ranked search results.