Skip to main content
POST
/
api
/
v1
/
memories
/
get
Python
from everos import EverOS

client = EverOS()
memories = client.v1.memories

response = memories.get(
    filters={"user_id": "<string>"},
    memory_type="<string>",
    page=1,
    page_size=10
)
print(response)
{
  "data": {
    "episodes": [],
    "profiles": [],
    "agent_cases": [],
    "agent_skills": [],
    "total_count": 0,
    "count": 0
  }
}
Filters DSL Allowlist-based: only the following fields are processed, unknown fields are silently ignored.
FieldTypeOperatorsDescription
user_idstringeq, inUser ID filter (conditional required)
group_idstringeq, inGroup ID filter (conditional required)
session_idstringeq, in, gt, gte, lt, lteSession ID filter
timestampint (epoch ms/s) or ISO stringeq, gt, gte, lt, lteTime range filter
ANDarray-All conditions must match
ORarray-Any condition must match
Operator syntax: plain value = eq, {"in": [...]}, {"gte": v, "lt": v}

Authorizations

​
Authorization
string
header
default:Bearer <api_key>
required

Bearer authentication header of the form Bearer 'api_key', obtain your API key from everos.evermind.ai.

Body

application/json
​
memory_type
enum<string>
required

Memory type to query. Scope constraint per type:

  • episodic_memory: supports both user_id and group_id
  • profile: user_id only (group_id will return 400)
  • agent_case: user_id only (group_id will return 400)
  • agent_skill: user_id only (group_id will return 400)
Available options:
episodic_memory,
profile,
agent_case,
agent_skill
​
filters
object
required

Filter conditions. Supported fields: user_id, group_id, session_id, timestamp. user_id and group_id are placed at the top level of the filters object. session_id and timestamp support operators (eq, in, gt, gte, lt, lte) and can be used inside AND/OR combinators.

​
page
integer
default:1

Page number (starts from 1)

Required range: x >= 1
​
page_size
integer
default:20

Items per page

Required range: 1 <= x <= 100
​
rank_by
string
default:timestamp

Sort field

​
rank_order
enum<string>
default:desc

Sort order

Available options:
asc,
desc

Response

Memories retrieved successfully

​
data
object