Skip to content

Search memories

POST
/api/v1/chat/memory/search
curl --request POST \
--url http://localhost:11044/api/v1/chat/memory/search \
--header 'Content-Type: application/json' \
--header 'X-Embabel-Api-Key: <X-Embabel-Api-Key>' \
--data '{ "minConfidence": "0.5", "query": "example", "topK": "20" }'

Search the user’s memories by text similarity, scoped to ACTIVE propositions in the current context. The JSON body requires query; topK defaults to 20 (clamped to 1..30) and minConfidence to 0.5 (clamped to 0..1).

What to look for among the caller’s memories. query is required and must be a string; missing or any other JSON type is refused with 400. topK caps how many come back, default 20, clamped to 1..30; minConfidence is the lowest similarity score returned, default 0.5, clamped to 0..1. Only ACTIVE memories in the caller’s current context are searched

Media typeapplication/json

A memory search

object
minConfidence

Minimum similarity to include, 0..1

number format: double
default: 0.5
query
required

The text to match against the user’s memories

string
topK

How many results to return; clamped to 1..30

integer format: int32
default: 20

Search results

Media type*/*
object

Missing query

Media type*/*

A refusal carrying only its reason, with no status word

object
error
required

Why the request was refused, written to be shown

string