Memories

Semantic search by vector: the query text never reaches the server

Same ranking and the same memories as GET (both use one scoring function), but the client sends the query's vector in the body instead of its text. The server never sees the query and logs only that a vector search happened. Sealed matches come back with scheme: sealed, summary: null and their blob_b64, so the client decrypts them without another request. Since 2026-09-21.

post/v1/memories/search

Request

  • Base URL: https://api.chainmemory.ai
  • URL: https://api.chainmemory.ai/v1/memories/search
  • Auth: API key in header x-api-key

Request body

query_embeddingnumber[] required

384 numbers, L2-normalized (norm 1, tolerance 0.001): the all-MiniLM-L6-v2 vector computed on the client, [CLS] + up to 254 tokens + [SEP], mean pooling

limitinteger

1-20, default 10

Response

Matches with a relevance score

Changes

No recorded changes to this operation across all 1 revision of this API.