---
title: "List Memory Revisions"
method: GET
path: "/api/v1/memory/{memory_id}/revisions"
tags: ["memory"]
---

# List Memory Revisions

`GET /api/v1/memory/{memory_id}/revisions`

## Request

- Base URL: `https://memory.kagura-ai.com` (the document declares no server; this is the origin it was published from)
- URL: `https://memory.kagura-ai.com/api/v1/memory/{memory_id}/revisions`
- Auth: none declared

A memory's revision log, newest first (#2043).

One item per write event — ``created``, ``updated`` (with the fields it
changed), ``forgotten``, ``restored`` — with the version after it. Read
an earlier version's text with ``POST /reference`` and ``version``.

Status codes:
    200: A page; ``next_cursor`` (with ``has_more``) continues it.
    404: No such memory, the caller lacks access, or it was forgotten
         (the same answer as ``reference``).
    422: ``limit`` outside 1-100 or a malformed ``cursor``.

Permission: the same as ``reference`` (``PermissionService.
can_access_memory``). No member identity is returned: ``by_you`` marks
the caller's own events, and only those carry ``agent_id`` /
``session_id``.

## Path parameters

- `memory_id` string, uuid, required

## Query parameters

- `limit` integer
- `cursor` string, nullable

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- MemoryRevisionsResponse: A page of a memory's revision log, newest first (#2043).
  - `memory_id` unknown, required
  - `current_version` unknown, required
  - `revisions` unknown, required
  - `has_more` unknown, required
  - `next_cursor` unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/kagura-ai/apis/kagura-memory-cloud.md) · [All operations](https://skmtc.dev/kagura-ai/apis/kagura-memory-cloud/llms.txt) · [OpenAPI document](https://skmtc.dev/kagura-ai/apis/kagura-memory-cloud/revisions/aa9df1a21db9?raw)