v2

latestOpenAPI 3.1.0raw.githubusercontent.com2026-04-272589173.5 KB

Memories

Search memories

Perform a search query across your memories.

Standard mode (collection_ids or readable-scope search): returns hierarchical MemoryRecall with semantics, episodes, procedures, and sources.

Snapshot mode (snapshot field): returns graph-search results with {entities, relationships} from stateless in-memory traversal.

post/v1/memories/search

collection_idsstring[] nullable

Optional list of collection UUIDs or names to scope the search.

effort'auto' | 'low' | 'medium' | 'high'

Compute effort budget for memory search.

Effort controls traversal compute (exploration budgets, depth, fanout), not the size of the returned MemoryRecall projection.

filtersobject nullable

Optional filters to apply to the search.

nqlstring nullable

Pre-written NQL script. Executes directly without planner compilation. Mutually exclusive with query.

querystring nullable

Natural-language search query. Mutually exclusive with nql.

{
  "search_settings": {
    "fulltext_weight": 0.2,
    "include_scores": true,
    "semantic_weight": 0.8,
    "verbose": false
  }
}

Successful Response