Advanced: query XMemo memory stats
get_system_statsRead-onlyIdempotent
Retrieve detailed memory statistics with filters for path, type, status, and time range, and group results by various dimensions for analysis.
Instructions
Detailed memory stats with filters and grouping. For a quick summary use memory_overview or memory_stats.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| scope | No | Optional scope that narrows memory access; leave blank for the token default. | |
| since | No | Only include memories or activity on or after this ISO 8601 timestamp. | |
| top_n | No | Maximum number of aggregate groups to return. | |
| until | No | Only include memories or activity on or before this ISO 8601 timestamp. | |
| source | No | Optional source filter for system statistics. | |
| status | No | Memory status filter or update value, such as active, archived, deleted, or %. | % |
| team_id | No | Optional team/workspace identifier for team-scoped memory access. | |
| group_by | No | Optional grouping: none, month, agent, location, memory_type, type, source, path, bucket, day, or comma-separated advanced fields. | |
| memory_type | No | Memory type/category filter or value, such as episodic, identity, procedural, semantic, working, auto, or %. | % |
| output_json | No | Return a machine-readable JSON response instead of a human-readable summary. | |
| path_filter | No | Memory path filter; % matches all paths. | % |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |