List Memory Versions changedapi/beta/memory_stores/memory_versions/list
Nearest release: v2.1.306, published 2 hours after this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
Recorded here
Lines+24added
Lines−10removed
From line
1
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits21to this page, all time
# List Memory Versions # List memory versions
The whole hunk
from line 1, old and new numbered
/
from line 1
11---
2title: List memory versions
2title: List Memory Versions
33url: https://platform.claude.com/docs/en/api/beta/memory_stores/memory_versions/list
44---
55
6# List memory versions
6# List Memory Versions
77
88**GET** `/v1/memory_stores/{memory_store_id}/memory_versions`
99
10List memory versions
10List Memory Versions
1111
1212## Path parameters
1313
from line 35
3535
3636- `limit: optional number`
3737
38 The maximum number of versions to return per page. Defaults to 20.
38 The maximum number of versions to return per page, from 1 to 100. Defaults to 20.
3939
40 With `view=full`, a page holds at most 20 versions.
41
4042 format: int32
4143
4244- `memory_id: optional string`
from line 45
4345
4446 Return only versions of the memory with this ID (`mem_...`).
4547
46 The filter still works after the memory is deleted. The results then include the version whose `operation` is `deleted`.
48 The filter still works after the memory is deleted. While that memory's versions are retained, the results include the version whose `operation` is `deleted`.
4749
4850- `operation: optional BetaManagedAgentsMemoryVersionOperation`
4951
from line 77
7577
7678- `view: optional BetaManagedAgentsMemoryView`
7779
78 Selects which projection of a `memory` or `memory_version` the server returns. `basic` returns the object with `content` set to `null`; `full` populates `content`. When omitted, the default is endpoint-specific: retrieve operations default to `full`; list, create, and update operations default to `basic`. Listing with `view=full` caps `limit` at 20.
80 Whether a `memory` or `memory_version` in the response includes its `content`. Defaults to `full` on retrieve operations and to `basic` on list, create, and update operations.
7981
82 With `full`, list operations return at most 20 items per page.
83
8084 - `"basic"`
8185
8286 Return the object with `content` set to `null`. The `content_size_bytes` and `content_sha256` fields remain populated, so sync clients can diff without fetching content.
from line 231
227231
228232 - `memory_id: string`
229233
230 ID of the memory this version snapshots (a `mem_...` value). Remains valid after the memory is deleted; pass it as `memory_id` to [List memory versions](https://platform.claude.com/docs/en/api/beta/memory_stores/memory_versions/list?sdk_languages=http) to retrieve the memory's retained versions, including the `deleted` row while the lineage is retained.
234 The ID of the memory that this version belongs to (`mem_...`).
231235
236 The ID stays valid after the memory is deleted. Pass it as `memory_id` to [List Memory Versions](https://platform.claude.com/docs/en/api/beta/memory_stores/memory_versions/list?sdk_languages=http) to get the memory's retained versions, including its `deleted` version while the lineage is retained.
237
232238 - `memory_store_id: string`
233239
234240 ID of the memory store this version belongs to (a `memstore_...` value).
from line 271
265271
266272 - `created_by: optional BetaManagedAgentsActor`
267273
268 Who performed this write: one of `session_actor`, `api_actor`, `user_actor`, or `service_account_actor`; `null` when no writer is recorded. Captured at write time and preserved through redaction. A `session_actor` is an agent writing through the store's mounted filesystem at `/mnt/memory/`. The API key that created that session is not recorded on agent writes, so attribution names who made the write, not who is ultimately responsible; look up session provenance via the [Sessions API](https://platform.claude.com/docs/en/api/beta/sessions/retrieve?sdk_languages=http).
274 Who made this change to the memory, or `null` if the author wasn't recorded.
269275
276 Redacting the version doesn't change this field. A `session_actor` here is an agent that wrote through the store's mounted filesystem at `/mnt/memory/`. The version doesn't record the API key that created that session. So the author in `created_by` is who made the change, not who is ultimately responsible for it.
277
278 You can [retrieve the session](https://platform.claude.com/docs/en/api/beta/sessions/retrieve?sdk_languages=http) to learn more about where the change came from.
279
270280 - `BetaManagedAgentsSessionActor object`
271281
272282 An agent acting during a session, for example through the session's mounted filesystem. It names the session itself, not the user or API key that started the session.
from line 331
321331
322332 - `redacted_at: optional string or null`
323333
324 When this version was redacted, in RFC 3339 format, or `null` if it has not been redacted. When set, `content`, `path`, `content_size_bytes`, and `content_sha256` are all `null`. See [Redact a memory version](https://platform.claude.com/docs/en/api/beta/memory_stores/memory_versions/redact?sdk_languages=http).
334 When the version was redacted, in RFC 3339, or `null` if it hasn't been.
325335
336 When set, `content`, `path`, `content_size_bytes`, and `content_sha256` are `null`.
337
338 See the [memory guide](https://platform.claude.com/docs/en/managed-agents/memory?sdk_languages=http#redact-a-version) to learn more about redaction.
339
326340 format: date-time
327341
328342 - `redacted_by: optional BetaManagedAgentsActor`
from line 345
331345
332346- `next_page: optional string or null`
333347
334 Opaque cursor for the next page (a `page_...` value), or `null` if there are no more results. Pass as `page` on the next request.
348 The value to pass as `page` to get the next page, or `null` if there are no more results.
335349
336350## Example
337351
No line in this hunk matches that.