Search memories

Search memories for a specific user.

POST
/
product
/
search
{
  "code": 0,
  "message": "<string>",
  "data": {}
}

Body

application/json
query
string
required

User search query

user_id
string
required

User ID

readable_cube_ids
string[]

List of cube IDs that are readable for this request. Required for algorithm-facing API; optional for developer-facing API.

mode
string

Enumeration for search modes.

Enum:"fast""fine""mixture"
session_id
string

Session ID used as a soft signal to prioritize more relevant memories. Only used for weighting, not as a hard filter.

top_k
number
default: 10

Number of textual memories to retrieve (top-K). Default: 10.

dedup
string

Optional dedup option for textual memories. Use 'no' for no dedup, 'sim' for similarity dedup. If None, default exact-text dedup is applied.

Enum:"no""sim"
pref_top_k
number
default: 6

Number of preference memories to retrieve (top-K). Default: 6.

include_preference
boolean
default: true

Whether to retrieve preference memories along with general memories. If enabled, the system will automatically recall user preferences relevant to the query. Default: True.

search_tool_memory
boolean
default: true

Whether to retrieve tool memories along with general memories. If enabled, the system will automatically recall tool memories relevant to the query. Default: True.

tool_mem_top_k
number
default: 6

Number of tool memories to retrieve (top-K). Default: 6.

filter
object

Filter for the memory

internet_search
boolean
default: false

Whether to enable internet search in addition to memory search. Primarily used by internal algorithms. Default: False.

threshold
number

Internal similarity threshold for searching plaintext memories. If None, default thresholds will be applied.

search_memory_type
string
default: All

Type of memory to search: All, WorkingMemory, LongTermMemory, UserMemory, OuterMemory, ToolSchemaMemory, ToolTrajectoryMemory

chat_history
object[]

Historical chat messages used internally by algorithms. If None, internal stored history may be used; if provided (even an empty list), this value will be used as-is.

mem_cube_id
string

(Deprecated) Single cube ID to search in. Prefer `readable_cube_ids` for multi-cube search.

moscube
boolean
default: false

(Deprecated / internal) Whether to use legacy MemOSCube path.

operation
object[]

(Internal) Operation definitions for multi-cube read permissions.

source
string

Source of the search query [plugin will router diff search]

Response

application/json

Successful Response

code
number
default: 200

Response status code

message
string
required

Response message

data
object

Response data