Memory Versions changedapi/beta/memory_stores/memory_versions
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+93added
Lines−27removed
From line
5
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 ## Retrieve a Memory Version ## Redact a Memory Version ## List memory versions ## Retrieve a memory version ## Redact a memory version
The whole hunk
from line 5, old and new numbered
/
from line 5
55
66# Memory Versions
77
8## List memory versions
8## List Memory Versions
99
1010**GET** `/v1/memory_stores/{memory_store_id}/memory_versions`
1111
12List memory versions
12List Memory Versions
1313
1414### Path parameters
1515
from line 37
3737
3838- `limit: optional number`
3939
40 The maximum number of versions to return per page. Defaults to 20.
40 The maximum number of versions to return per page, from 1 to 100. Defaults to 20.
4141
42 With `view=full`, a page holds at most 20 versions.
43
4244 format: int32
4345
4446- `memory_id: optional string`
from line 47
4547
4648 Return only versions of the memory with this ID (`mem_...`).
4749
48 The filter still works after the memory is deleted. The results then include the version whose `operation` is `deleted`.
50 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`.
4951
5052- `operation: optional BetaManagedAgentsMemoryVersionOperation`
5153
from line 79
7779
7880- `view: optional BetaManagedAgentsMemoryView`
7981
80 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.
82 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.
8183
84 With `full`, list operations return at most 20 items per page.
85
8286 - `"basic"`
8387
8488 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 233
229233
230234 - `memory_id: string`
231235
232 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.
236 The ID of the memory that this version belongs to (`mem_...`).
233237
238 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.
239
234240 - `memory_store_id: string`
235241
236242 ID of the memory store this version belongs to (a `memstore_...` value).
from line 273
267273
268274 - `created_by: optional BetaManagedAgentsActor`
269275
270 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).
276 Who made this change to the memory, or `null` if the author wasn't recorded.
271277
278 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.
279
280 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.
281
272282 - `BetaManagedAgentsSessionActor object`
273283
274284 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 333
323333
324334 - `redacted_at: optional string or null`
325335
326 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).
336 When the version was redacted, in RFC 3339, or `null` if it hasn't been.
327337
338 When set, `content`, `path`, `content_size_bytes`, and `content_sha256` are `null`.
339
340 See the [memory guide](https://platform.claude.com/docs/en/managed-agents/memory?sdk_languages=http#redact-a-version) to learn more about redaction.
341
328342 format: date-time
329343
330344 - `redacted_by: optional BetaManagedAgentsActor`
from line 347
333347
334348- `next_page: optional string or null`
335349
336 Opaque cursor for the next page (a `page_...` value), or `null` if there are no more results. Pass as `page` on the next request.
350 The value to pass as `page` to get the next page, or `null` if there are no more results.
337351
338352### Example
339353
from line 389
375389}
376390```
377391
378## Retrieve a memory version
392## Retrieve a Memory Version
379393
380394**GET** `/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}`
381395
382Retrieve a memory version
396Retrieve a Memory Version
383397
384398### Path parameters
385399
from line 409
395409
396410- `view: optional BetaManagedAgentsMemoryView`
397411
398 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.
412 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.
399413
414 With `full`, list operations return at most 20 items per page.
415
400416 - `"basic"`
401417
402418 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 547
531547
532548- `BetaManagedAgentsMemoryVersion object`
533549
534 A `memory_version` object: one immutable, attributed row in a memory's append-only history. Every non-no-op mutation to a memory produces a new version. Versions belong to the store (not the individual memory) and are not deleted with the memory; each version is retained for at least the version retention period after it was written, unless the store itself is deleted. Retrieving a redacted version returns 200 with `content`, `path`, `content_size_bytes`, and `content_sha256` set to `null`; branch on `redacted_at`, not HTTP status.
550 One entry in a memory's history, recording a single change and who made it.
535551
552 Every change to a memory adds one version. Only redaction can change a version after that. Versions belong to the memory store and stay after the memory is deleted. Each version is retained for at least the version retention period after it was written, unless the store itself is deleted.
553
554 Retrieving a redacted version succeeds, with `content`, `path`, `content_size_bytes`, and `content_sha256` set to `null`. Check `redacted_at` to find out whether a version was redacted.
555
556 See the [memory guide](https://platform.claude.com/docs/en/managed-agents/memory?sdk_languages=http#audit-memory-changes) to learn more about memory versions.
557
536558 - `type: "memory_version"`
537559
538560 - `id: string`
from line 569
547569
548570 - `memory_id: string`
549571
550 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.
572 The ID of the memory that this version belongs to (`mem_...`).
551573
574 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.
575
552576 - `memory_store_id: string`
553577
554578 ID of the memory store this version belongs to (a `memstore_...` value).
from line 609
585609
586610 - `created_by: optional BetaManagedAgentsActor`
587611
588 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).
612 Who made this change to the memory, or `null` if the author wasn't recorded.
589613
614 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.
615
616 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.
617
590618 - `BetaManagedAgentsSessionActor object`
591619
592620 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 669
641669
642670 - `redacted_at: optional string or null`
643671
644 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).
672 When the version was redacted, in RFC 3339, or `null` if it hasn't been.
645673
674 When set, `content`, `path`, `content_size_bytes`, and `content_sha256` are `null`.
675
676 See the [memory guide](https://platform.claude.com/docs/en/managed-agents/memory?sdk_languages=http#redact-a-version) to learn more about redaction.
677
646678 format: date-time
647679
648680 - `redacted_by: optional BetaManagedAgentsActor`
from line 716
684716}
685717```
686718
687## Redact a memory version
719## Redact a Memory Version
688720
689721**POST** `/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}/redact`
690722
691Redact a memory version
723Redact a Memory Version
692724
693725### Path parameters
694726
from line 858
826858
827859- `BetaManagedAgentsMemoryVersion object`
828860
829 A `memory_version` object: one immutable, attributed row in a memory's append-only history. Every non-no-op mutation to a memory produces a new version. Versions belong to the store (not the individual memory) and are not deleted with the memory; each version is retained for at least the version retention period after it was written, unless the store itself is deleted. Retrieving a redacted version returns 200 with `content`, `path`, `content_size_bytes`, and `content_sha256` set to `null`; branch on `redacted_at`, not HTTP status.
861 One entry in a memory's history, recording a single change and who made it.
830862
863 Every change to a memory adds one version. Only redaction can change a version after that. Versions belong to the memory store and stay after the memory is deleted. Each version is retained for at least the version retention period after it was written, unless the store itself is deleted.
864
865 Retrieving a redacted version succeeds, with `content`, `path`, `content_size_bytes`, and `content_sha256` set to `null`. Check `redacted_at` to find out whether a version was redacted.
866
867 See the [memory guide](https://platform.claude.com/docs/en/managed-agents/memory?sdk_languages=http#audit-memory-changes) to learn more about memory versions.
868
831869 - `type: "memory_version"`
832870
833871 - `id: string`
from line 880
842880
843881 - `memory_id: string`
844882
845 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.
883 The ID of the memory that this version belongs to (`mem_...`).
846884
885 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.
886
847887 - `memory_store_id: string`
848888
849889 ID of the memory store this version belongs to (a `memstore_...` value).
from line 920
880920
881921 - `created_by: optional BetaManagedAgentsActor`
882922
883 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).
923 Who made this change to the memory, or `null` if the author wasn't recorded.
884924
925 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.
926
927 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.
928
885929 - `BetaManagedAgentsSessionActor object`
886930
887931 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 980
936980
937981 - `redacted_at: optional string or null`
938982
939 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).
983 When the version was redacted, in RFC 3339, or `null` if it hasn't been.
940984
985 When set, `content`, `path`, `content_size_bytes`, and `content_sha256` are `null`.
986
987 See the [memory guide](https://platform.claude.com/docs/en/managed-agents/memory?sdk_languages=http#redact-a-version) to learn more about redaction.
988
941989 format: date-time
942990
943991 - `redacted_by: optional BetaManagedAgentsActor`
from line 1102
10541102
10551103- `BetaManagedAgentsMemoryVersion object`
10561104
1057 A `memory_version` object: one immutable, attributed row in a memory's append-only history. Every non-no-op mutation to a memory produces a new version. Versions belong to the store (not the individual memory) and are not deleted with the memory; each version is retained for at least the version retention period after it was written, unless the store itself is deleted. Retrieving a redacted version returns 200 with `content`, `path`, `content_size_bytes`, and `content_sha256` set to `null`; branch on `redacted_at`, not HTTP status.
1105 One entry in a memory's history, recording a single change and who made it.
10581106
1107 Every change to a memory adds one version. Only redaction can change a version after that. Versions belong to the memory store and stay after the memory is deleted. Each version is retained for at least the version retention period after it was written, unless the store itself is deleted.
1108
1109 Retrieving a redacted version succeeds, with `content`, `path`, `content_size_bytes`, and `content_sha256` set to `null`. Check `redacted_at` to find out whether a version was redacted.
1110
1111 See the [memory guide](https://platform.claude.com/docs/en/managed-agents/memory?sdk_languages=http#audit-memory-changes) to learn more about memory versions.
1112
10591113 - `type: "memory_version"`
10601114
10611115 - `id: string`
from line 1124
10701124
10711125 - `memory_id: string`
10721126
1073 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.
1127 The ID of the memory that this version belongs to (`mem_...`).
10741128
1129 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.
1130
10751131 - `memory_store_id: string`
10761132
10771133 ID of the memory store this version belongs to (a `memstore_...` value).
from line 1164
11081164
11091165 - `created_by: optional BetaManagedAgentsActor`
11101166
1111 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).
1167 Who made this change to the memory, or `null` if the author wasn't recorded.
11121168
1169 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.
1170
1171 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.
1172
11131173 - `BetaManagedAgentsSessionActor object`
11141174
11151175 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 1224
11641224
11651225 - `redacted_at: optional string or null`
11661226
1167 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).
1227 When the version was redacted, in RFC 3339, or `null` if it hasn't been.
11681228
1229 When set, `content`, `path`, `content_size_bytes`, and `content_sha256` are `null`.
1230
1231 See the [memory guide](https://platform.claude.com/docs/en/managed-agents/memory?sdk_languages=http#redact-a-version) to learn more about redaction.
1232
11691233 format: date-time
11701234
11711235 - `redacted_by: optional BetaManagedAgentsActor`
from line 1240
11761240
11771241- `BetaManagedAgentsMemoryVersionOperation = "created" or "modified" or "deleted"`
11781242
1179 The kind of mutation a `memory_version` records. Every non-no-op mutation to a memory appends exactly one version row with one of these values.
1243 The kind of change that a memory version records.
1244
1245 Every change to a memory adds one version. If you update a memory and nothing changes, the memory doesn't get a new version.
11801246
11811247 - `"created"`
11821248
No line in this hunk matches that.