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