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

Request body

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.

Example request

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

Response

Successful Response

Changes

Changed in 1 of the 2 revisions of this API.3913

Apr 27, 2026b1da2c0bb1ae3913See the full diff
- ▲
  the request property type changed from object to no type
  request-property-type-changed
- ▲
  the response's body type changed from object to no type for status
  response-body-type-changed
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ●
  removed the request property
  request-property-removed
- ●
  removed the request property /
  request-property-removed
- ●
  removed the request property /
  request-property-removed
- ●
  removed the request property /
  request-property-removed
- ●
  removed the request property /
  request-property-removed
- ●
  removed the request property /
  request-property-removed
- ●
  removed the request property /
  request-property-removed
- ●
  removed the request property /
  request-property-removed
- ●
  removed the request property /
  request-property-removed
- ○
  api operation id search_engrams_v1_memories_search_post removed and replaced with search_memories
  api-operation-id-removed
- ○
  api tag Memories added
  api-tag-added
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added subschema #2 to the request property anyOf list
  request-property-any-of-added
- ○
  the request property became optional
  request-property-became-optional
- ○
  request property list-of-types was widened by adding types null to media type application/json
  request-property-list-of-types-widened
- ○
  added to the response body anyOf list for the response status
  response-body-any-of-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
This revision also has 119 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history