Retrieve relevant memory data based on query text using multiple retrieval methods
Bearer authentication header of the form Bearer 'api_key', where 'api_key' is your EverMemOS auth api key.
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, 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, 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"]