Search Memory

POST

/memory/search

Search memory semantically for the given scope.

Args:
query_text: Natural language query to search memory.
memory_level: Scope for search (tenant/agent/user/user_agent).
top_k: Maximum number of results to return.
agent_id: Optional agent identifier when scope is agent-related.
authorization: Optional authorization header used to identify the user.

Request

Header Params

Body Params application/jsonRequired

Example

{
    "query_text": "string",
    "memory_level": "string",
    "top_k": 5,
    "agent_id": "string"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/memory/search' \
--header 'authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "query_text": "string",
    "memory_level": "string",
    "top_k": 5,
    "agent_id": "string"
}'

Responses

🟢200

application/json

Successful Response

Body

Example

null

🟠422

Modified at 2025-12-12 05:26:19

Add Memory

List Memory