Search memories
Retrieve relevant memory data based on query text using multiple retrieval methods
Documentation Index
Fetch the complete documentation index at: https://docs.evermind.ai/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
Bearer authentication header of the form Bearer 'api_key', where 'api_key' is your EverOS auth api key.
Body
User ID (at least one of user_id or group_id must be provided)
"user_123"
List of memory types to retrieve, enum values from MemoryType:
- profile: user profile (Milvus vector search only)
- episodic_memory: episodic memory
- foresight: prospective memory (not yet supported for search)
- event_log: event log (not yet supported for search) Note: Only profile and episodic_memory are supported. Defaults to both if not specified.
profile, episodic_memory, foresight, event_log ["episodic_memory"]Whether to include metadata
true
Time range start (ISO 8601 format with Timezone is required). Only applies to episodic_memory, ignored for profile
"2024-01-01T00:00:00+00:00"
Time range end (ISO 8601 format with Timezone is required). Only applies to episodic_memory, ignored for profile
"2024-12-31T23:59:59+00:00"
Search query text
"coffee preference"
Retrieval method, enum values from RetrieveMethod:
- keyword: keyword retrieval (BM25, default)
- vector: vector semantic retrieval
- hybrid: hybrid retrieval (keyword + vector)
- rrf: RRF fusion retrieval (keyword + vector + RRF ranking fusion)
- agentic: LLM-guided multi-round intelligent retrieval
keyword, vector, hybrid, rrf, agentic "keyword"
Current time, used to filter forward-looking events within validity period
COSINE similarity threshold for vector retrieval (only for vector and hybrid methods, default 0.6)
0 <= x <= 10.6
Maximum number of results to return. -1 means return all results that meet the threshold (up to 100). Valid values: -1 or 1-100.
-1 <= x <= 10010
-1
Array of Group IDs to search (max 10 items). None means search all groups for the user.
["group_456", "group_789"]