List all memories for the current user, optionally filtered by type and metadata.
Requires authentication and operates on user-scoped data. SecureSmartMemory automatically handles tenant isolation.
GRAPH-API-1l: supersedes GET /memory/by-metadata for metadata lookups —
same filter, but with this route's pagination and total. Filters only ever
narrow the caller's own accessible set; they can never surface an item the
caller could not otherwise see. See
docs/features/GRAPH-API-1l/list-filters-contract.json.
Query Parameters
Metadata key to filter on (exact match). Nested keys use dot syntax, e.g. profile.tier. Must be supplied together with metadata_value.
Value the metadata key must equal. Must be supplied together with metadata_key.
Exact memory type filter
Include grounding nodes; omit to inherit workspace then env (default OFF)
Response Body
application/json
application/json
curl -X GET "https://example.com/memory/list"{
"items": [
{}
],
"total": 0,
"limit": 0,
"offset": 0,
"policy": {
"include_grounding": true,
"source": "request"
}
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string",
"input": null,
"ctx": {}
}
]
}