Memory
Search many memory spaces
Recall from up to 10 memory spaces in one call, merged into one ranked list.
POST
/v1/dum/federated-searchSearches several memory spaces at once and merges the results, best match first. Spaces the key can't reach, or that don't exist, are skipped, and the rest are still searched.
Body
memory_space_idsstring<uuid>[]requiredThe memory spaces to search, from 1 to 10.
querystringrequiredThe question, in plain words.
top_kintegerdefault: 5How many memories to return in total, from 1 to 20.
end_userstring | nullReturns only this person's memories, in every space searched.
Response
A list of memories from every space searched, best match first.
[].idstring<uuid>requiredThe memory's ID.
[].contentstringrequiredThe remembered text.
[].memory_typestringrequiredThe storage class.
[].confidence_scorenumber | nullrequiredHow strongly the memory answers the query, from 0 to 1.
[].memory_space_idstring<uuid>requiredThe memory space the memory came from.
Status codes
| Status | Meaning |
|---|---|
200 | The search ran across every space the key can reach. |
401 | The key is missing, malformed, or revoked. |
422 | A field is missing or invalid, such as more than 10 spaces. |
429 | The read rate limit was hit. |
One federated search counts as one read, however many spaces it covers.