Memory
Search memories
Recall the memories in one memory space that best answer a question.
POST
/v1/dum/searchSearches one memory space and returns the most relevant, current memories, best match first. lynk.recall calls it for you.
Body
memory_space_idstring<uuid>requiredThe memory space to search.
querystringrequiredThe question, in plain words.
top_kintegerdefault: 5How many memories to return, from 1 to 50.
end_userstring | nullReturns only this person's memories, up to 255 characters. Required in a multi-user space, where a search without it returns []. See End users.
Response
A list of memories, best match first.
[].idstring<uuid>requiredThe memory's ID.
[].contentstringrequiredThe remembered text.
[].memory_typestringrequiredThe storage class. See Memory types.
[].confidence_scorenumber | nullrequiredHow strongly the memory answers the query, from 0 to 1.
Status codes
| Status | Meaning |
|---|---|
200 | The search ran. An empty list means nothing matched. |
401 | The key is missing, malformed, or revoked. |
403 | The key's capability or scope doesn't allow searching this memory space. |
404 | The memory space doesn't exist in the key's workspace. |
422 | A field is missing or invalid, such as top_k above 50. |
429 | The read rate limit was hit. |