Skip to main content
POST
/
v2
/
memories
/
search
Search_Memories
curl --request POST \
  --url https://api.memmachine.ai/docs/v2/memories/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "<string>",
  "top_k": 10,
  "filter": "",
  "types": [
    "semantic"
  ]
}
'
{
  "content": {},
  "status": 0
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Specification model for searching memories.

​
query
string
required
The natural language query used for semantic memory search. This should be
a descriptive string of the information you are looking for.
Example:

"What was the user's last conversation about finance?"

​
top_k
integer
default:10
The maximum number of memories to return in the search results.
Examples:

5

10

20

​
filter
string
default:""
An optional string filter applied to the memory metadata. This uses a
simple query language (e.g., 'metadata.user_id=123') for exact matches.
Multiple conditions can be combined using AND operators.  The metadata
fields are prefixed with 'metadata.' to distinguish them from other fields.
Example:

"metadata.user_id=123 AND metadata.session_id=abc"

​
types
enum<string>[]
A list of memory types to include in the search (e.g., Episodic, Semantic).
If empty, all available types are searched.

Memory type.

Available options:
semantic,
episodic
Example:
["Episodic", "Semantic"]

Response

Successful Response

Response model for memory search results.

​
content
Content · object
required
The dictionary containing the memory search results (e.g., list of memory
objects).
​
status
integer
default:0
The status code of the search operation. 0 typically indicates success.
Example:

0