MemoryKit Docs

List Memories

List memories with cursor-based pagination and filters.

GET/v1/memories

Query parameters

limitnumber

Max results per page (1–100). Default: 20.

cursorstring

Cursor from a previous response for pagination.

statusstring

Filter by status: processing, completed, or failed.

typestring

Filter by content type.

userIdstring

Filter by user.

Response

dataMemory[]

Array of memory objects.

has_moreboolean

Whether more results are available.

cursorstring

Cursor to pass for the next page.

Example response

{
  "data": [
    {
      "id": "mem_abc123",
      "status": "completed",
      "title": "Q4 Planning Notes",
      "tags": ["planning", "q4"],
      "created_at": "2025-01-15T10:30:00Z"
    }
  ],
  "has_more": true,
  "cursor": "eyJpZCI6Im1lbV9..."
}

const list = await mk.memories.list({
  limit: 20,
  status: "completed",
  userId: "user_123",
});
 
for (const memory of list.data) {
  console.log(memory.title);
}
 
if (list.has_more) {
  const page2 = await mk.memories.list({ limit: 20, cursor: list.cursor });
}

Edit on GitHub

List Memories

Query parameters

Response

On this page