List memories
List memories with flat-equality filters and cursor pagination.
Documentation Index
Fetch the complete documentation index at: https://docs.mem.xtrace.ai/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
Long-lived org API key. Alternative: Authorization: Bearer <key>.
Required alongside the API key (no key→org reverse index).
Headers
Query Parameters
Filter by user_id (exact match). Combine with other entity params for AND.
Filter by agent_id (exact match).
Filter by conv_id (exact match).
Filter by app_id (exact match).
Restrict results to one memory subtype. Default: all three.
fact, artifact, episode Opaque pagination cursor from a previous response's next_cursor. Must match this request's order and the issuing org (mismatch → 422 cursor_mismatch).
Maximum rows per page. 1–100, default 50.
1 <= x <= 100Sort order on (created_at, id).
created_at_desc, created_at_asc Comma-separated opt-in extras. Currently only full_content is supported (populates details.full_content on artifact rows).
Response
Successful Response
Stripe-style list envelope used by GET /v1/memories,
GET /v1/memories/{id}/revisions, and the default search
response.
Constant discriminator for the resource type.
"list"Page of memory rows.
True if more rows exist beyond this page; use next_cursor to fetch them.
Opaque cursor for the next page. Null on the final page. Tenant-scoped: only usable with the same (org, key) that produced it.