Endpoint
Query Parameters
| Parameter | Type | Description |
|---|
type | string | Filter by memory type |
visibility | string | Filter by visibility: private or share |
pinned | boolean | Filter by pin status |
history | boolean | true to include all versions (default: latest only) |
minImportance | number | Minimum importance (0.0–1.0) |
sortBy | string | createdAt, updatedAt, or importance (default: createdAt desc) |
limit | number | Results per page (default 50, max 100) |
offset | number | Offset for traditional pagination |
cursor | string | Cursor for cursor-based pagination |
Response (200)
{
"memories": [
{
"id": "...",
"type": "semantic",
"key": "facts/project-alpha",
"version": 2,
"sizeBytes": 48,
"pinned": true,
"importance": 0.8,
"metadata": { "tags": ["project"] },
"visibility": "private",
"createdAt": "...",
"updatedAt": "..."
}
],
"limit": 20,
"nextCursor": "base64...",
"hasMore": true
}
total is only included in offset-based pagination responses (not cursor-based) to avoid expensive count queries on large datasets.
nextCursor from the response as cursor in the next request for stable pagination:
# Page 1
GET /v1/memory?limit=20
# Page 2
GET /v1/memory?limit=20&cursor=<nextCursor>
