Memory Versions changedapi/beta/memory_stores/memory_versions
Nearest release: v2.1.268, published under an hour 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+87added
Lines−70removed
From line
1
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits24to this page, all time
The whole hunk
from line 1, old and new numbered
/
from line 1
1---
2title: Memory Versions
3url: https://platform.claude.com/docs/en/api/beta/memory_stores/memory_versions
4---
5
16# Memory Versions
27
38## List memory versions
from line 81
7681
7782 - `string`
7883
79 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
84 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
8085
8186 - `"message-batches-2024-09-24"`
8287
from line 129
124129
125130 - `"user-profiles-2026-08-18"`
126131
132 - `"user-profiles-2026-09-04"`
133
127134 - `"advisor-tool-2026-03-01"`
128135
129136 - `"managed-agents-2026-04-01"`
from line 173
166173
167174 - `"mid-conversation-system-clear-at-2026-08-21"`
168175
176- `"anthropic-workspace-id": optional string`
177
169178### Returns
170179
171180- `data: optional array of BetaManagedAgentsMemoryVersion`
from line 181
172181
173182 One page of `memory_version` objects, ordered by `created_at` descending (newest first), with `id` as tiebreak.
174183
184 - `type: "memory_version"`
185
175186 - `id: string`
176187
177188 Unique identifier for this version (a `memver_...` value).
from line 211
200211
201212 - `"deleted"`
202213
203 - `type: "memory_version"`
204
205214 - `content: optional string or null`
206215
207216 The memory's UTF-8 text content as of this version. `null` when `view=basic`, when `operation` is `deleted`, or when `redacted_at` is set.
from line 227
218227
219228 - `created_by: optional BetaManagedAgentsActor`
220229
221 Identifies who performed a write or redact operation. Captured at write time on the `memory_version` row. The API key that created a session is not recorded on agent writes; attribution answers who made the write, not who is ultimately responsible. Look up session provenance separately via the [Sessions API](/docs/en/api/sessions-retrieve).
230 Identifies who performed a write or redact operation. Captured at write time on the `memory_version` row. The API key that created a session is not recorded on agent writes; attribution answers who made the write, not who is ultimately responsible. Look up session provenance separately via the [Sessions API](/docs/en/api/beta/sessions/retrieve).
222231
223232 - `BetaManagedAgentsSessionActor object`
224233
225234 Attribution for a write made by an agent during a session, through the mounted filesystem at `/mnt/memory/`.
226235
236 - `type: "session_actor"`
237
227238 - `session_id: string`
228239
229 ID of the session that performed the write (a `sesn_...` value). Look up the session via [Retrieve a session](/docs/en/api/sessions-retrieve) for further provenance.
240 ID of the session that performed the write (a `sesn_...` value). Look up the session via [Retrieve a session](/docs/en/api/beta/sessions/retrieve) for further provenance.
230241
231242 minLength: 1
232243
233 - `type: "session_actor"`
234
235244 - `BetaManagedAgentsAPIActor object`
236245
237246 Attribution for a write made directly via the public API (outside of any session).
238247
248 - `type: "api_actor"`
249
239250 - `api_key_id: string`
240251
241252 ID of the API key that performed the write. This identifies the key, not the secret.
from line 253
242253
243254 minLength: 1
244255
245 - `type: "api_actor"`
246
247256 - `BetaManagedAgentsUserActor object`
248257
249258 Attribution for a write made by a human user through the Anthropic Console.
from line 269
260269
261270 Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation.
262271
272 - `type: "service_account_actor"`
273
263274 - `service_account_id: string`
264275
265276 ID of the service account that performed the write (a `svac_...` value).
from line 277
266277
267278 minLength: 1
268279
269 - `type: "service_account_actor"`
270
271280 - `path: optional string or null`
272281
273282 The memory's path at the time of this write. `null` if and only if `redacted_at` is set.
from line 289
280289
281290 - `redacted_by: optional BetaManagedAgentsActor`
282291
283 Identifies who performed a write or redact operation. Captured at write time on the `memory_version` row. The API key that created a session is not recorded on agent writes; attribution answers who made the write, not who is ultimately responsible. Look up session provenance separately via the [Sessions API](/docs/en/api/sessions-retrieve).
292 Identifies who performed a write or redact operation. Captured at write time on the `memory_version` row. The API key that created a session is not recorded on agent writes; attribution answers who made the write, not who is ultimately responsible. Look up session provenance separately via the [Sessions API](/docs/en/api/beta/sessions/retrieve).
284293
285294- `next_page: optional string or null`
286295
from line 365
356365
357366 - `string`
358367
359 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
368 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
360369
361370 - `"message-batches-2024-09-24"`
362371
from line 413
404413
405414 - `"user-profiles-2026-08-18"`
406415
416 - `"user-profiles-2026-09-04"`
417
407418 - `"advisor-tool-2026-03-01"`
408419
409420 - `"managed-agents-2026-04-01"`
from line 457
446457
447458 - `"mid-conversation-system-clear-at-2026-08-21"`
448459
460- `"anthropic-workspace-id": optional string`
461
449462### Returns
450463
451464- `BetaManagedAgentsMemoryVersion object`
from line 465
452465
453466 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.
454467
468 - `type: "memory_version"`
469
455470 - `id: string`
456471
457472 Unique identifier for this version (a `memver_...` value).
from line 495
480495
481496 - `"deleted"`
482497
483 - `type: "memory_version"`
484
485498 - `content: optional string or null`
486499
487500 The memory's UTF-8 text content as of this version. `null` when `view=basic`, when `operation` is `deleted`, or when `redacted_at` is set.
from line 511
498511
499512 - `created_by: optional BetaManagedAgentsActor`
500513
501 Identifies who performed a write or redact operation. Captured at write time on the `memory_version` row. The API key that created a session is not recorded on agent writes; attribution answers who made the write, not who is ultimately responsible. Look up session provenance separately via the [Sessions API](/docs/en/api/sessions-retrieve).
514 Identifies who performed a write or redact operation. Captured at write time on the `memory_version` row. The API key that created a session is not recorded on agent writes; attribution answers who made the write, not who is ultimately responsible. Look up session provenance separately via the [Sessions API](/docs/en/api/beta/sessions/retrieve).
502515
503516 - `BetaManagedAgentsSessionActor object`
504517
505518 Attribution for a write made by an agent during a session, through the mounted filesystem at `/mnt/memory/`.
506519
520 - `type: "session_actor"`
521
507522 - `session_id: string`
508523
509 ID of the session that performed the write (a `sesn_...` value). Look up the session via [Retrieve a session](/docs/en/api/sessions-retrieve) for further provenance.
524 ID of the session that performed the write (a `sesn_...` value). Look up the session via [Retrieve a session](/docs/en/api/beta/sessions/retrieve) for further provenance.
510525
511526 minLength: 1
512527
513 - `type: "session_actor"`
514
515528 - `BetaManagedAgentsAPIActor object`
516529
517530 Attribution for a write made directly via the public API (outside of any session).
518531
532 - `type: "api_actor"`
533
519534 - `api_key_id: string`
520535
521536 ID of the API key that performed the write. This identifies the key, not the secret.
from line 537
522537
523538 minLength: 1
524539
525 - `type: "api_actor"`
526
527540 - `BetaManagedAgentsUserActor object`
528541
529542 Attribution for a write made by a human user through the Anthropic Console.
from line 553
540553
541554 Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation.
542555
556 - `type: "service_account_actor"`
557
543558 - `service_account_id: string`
544559
545560 ID of the service account that performed the write (a `svac_...` value).
from line 561
546561
547562 minLength: 1
548563
549 - `type: "service_account_actor"`
550
551564 - `path: optional string or null`
552565
553566 The memory's path at the time of this write. `null` if and only if `redacted_at` is set.
from line 573
560573
561574 - `redacted_by: optional BetaManagedAgentsActor`
562575
563 Identifies who performed a write or redact operation. Captured at write time on the `memory_version` row. The API key that created a session is not recorded on agent writes; attribution answers who made the write, not who is ultimately responsible. Look up session provenance separately via the [Sessions API](/docs/en/api/sessions-retrieve).
576 Identifies who performed a write or redact operation. Captured at write time on the `memory_version` row. The API key that created a session is not recorded on agent writes; attribution answers who made the write, not who is ultimately responsible. Look up session provenance separately via the [Sessions API](/docs/en/api/beta/sessions/retrieve).
564577
565578### Example
566579
from line 630
617630
618631 - `string`
619632
620 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
633 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
621634
622635 - `"message-batches-2024-09-24"`
623636
from line 678
665678
666679 - `"user-profiles-2026-08-18"`
667680
681 - `"user-profiles-2026-09-04"`
682
668683 - `"advisor-tool-2026-03-01"`
669684
670685 - `"managed-agents-2026-04-01"`
from line 722
707722
708723 - `"mid-conversation-system-clear-at-2026-08-21"`
709724
725- `"anthropic-workspace-id": optional string`
726
710727### Returns
711728
712729- `BetaManagedAgentsMemoryVersion object`
from line 730
713730
714731 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.
715732
733 - `type: "memory_version"`
734
716735 - `id: string`
717736
718737 Unique identifier for this version (a `memver_...` value).
from line 760
741760
742761 - `"deleted"`
743762
744 - `type: "memory_version"`
745
746763 - `content: optional string or null`
747764
748765 The memory's UTF-8 text content as of this version. `null` when `view=basic`, when `operation` is `deleted`, or when `redacted_at` is set.
from line 776
759776
760777 - `created_by: optional BetaManagedAgentsActor`
761778
762 Identifies who performed a write or redact operation. Captured at write time on the `memory_version` row. The API key that created a session is not recorded on agent writes; attribution answers who made the write, not who is ultimately responsible. Look up session provenance separately via the [Sessions API](/docs/en/api/sessions-retrieve).
779 Identifies who performed a write or redact operation. Captured at write time on the `memory_version` row. The API key that created a session is not recorded on agent writes; attribution answers who made the write, not who is ultimately responsible. Look up session provenance separately via the [Sessions API](/docs/en/api/beta/sessions/retrieve).
763780
764781 - `BetaManagedAgentsSessionActor object`
765782
766783 Attribution for a write made by an agent during a session, through the mounted filesystem at `/mnt/memory/`.
767784
785 - `type: "session_actor"`
786
768787 - `session_id: string`
769788
770 ID of the session that performed the write (a `sesn_...` value). Look up the session via [Retrieve a session](/docs/en/api/sessions-retrieve) for further provenance.
789 ID of the session that performed the write (a `sesn_...` value). Look up the session via [Retrieve a session](/docs/en/api/beta/sessions/retrieve) for further provenance.
771790
772791 minLength: 1
773792
774 - `type: "session_actor"`
775
776793 - `BetaManagedAgentsAPIActor object`
777794
778795 Attribution for a write made directly via the public API (outside of any session).
779796
797 - `type: "api_actor"`
798
780799 - `api_key_id: string`
781800
782801 ID of the API key that performed the write. This identifies the key, not the secret.
from line 802
783802
784803 minLength: 1
785804
786 - `type: "api_actor"`
787
788805 - `BetaManagedAgentsUserActor object`
789806
790807 Attribution for a write made by a human user through the Anthropic Console.
from line 818
801818
802819 Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation.
803820
821 - `type: "service_account_actor"`
822
804823 - `service_account_id: string`
805824
806825 ID of the service account that performed the write (a `svac_...` value).
from line 826
807826
808827 minLength: 1
809828
810 - `type: "service_account_actor"`
811
812829 - `path: optional string or null`
813830
814831 The memory's path at the time of this write. `null` if and only if `redacted_at` is set.
from line 838
821838
822839 - `redacted_by: optional BetaManagedAgentsActor`
823840
824 Identifies who performed a write or redact operation. Captured at write time on the `memory_version` row. The API key that created a session is not recorded on agent writes; attribution answers who made the write, not who is ultimately responsible. Look up session provenance separately via the [Sessions API](/docs/en/api/sessions-retrieve).
841 Identifies who performed a write or redact operation. Captured at write time on the `memory_version` row. The API key that created a session is not recorded on agent writes; attribution answers who made the write, not who is ultimately responsible. Look up session provenance separately via the [Sessions API](/docs/en/api/beta/sessions/retrieve).
825842
826843### Example
827844
from line 882
865882
866883- `BetaManagedAgentsActor = BetaManagedAgentsSessionActor or BetaManagedAgentsAPIActor or BetaManagedAgentsUserActor or BetaManagedAgentsServiceAccountActor`
867884
868 Identifies who performed a write or redact operation. Captured at write time on the `memory_version` row. The API key that created a session is not recorded on agent writes; attribution answers who made the write, not who is ultimately responsible. Look up session provenance separately via the [Sessions API](/docs/en/api/sessions-retrieve).
885 Identifies who performed a write or redact operation. Captured at write time on the `memory_version` row. The API key that created a session is not recorded on agent writes; attribution answers who made the write, not who is ultimately responsible. Look up session provenance separately via the [Sessions API](/docs/en/api/beta/sessions/retrieve).
869886
870887 - `BetaManagedAgentsSessionActor object`
871888
872889 Attribution for a write made by an agent during a session, through the mounted filesystem at `/mnt/memory/`.
873890
891 - `type: "session_actor"`
892
874893 - `session_id: string`
875894
876 ID of the session that performed the write (a `sesn_...` value). Look up the session via [Retrieve a session](/docs/en/api/sessions-retrieve) for further provenance.
895 ID of the session that performed the write (a `sesn_...` value). Look up the session via [Retrieve a session](/docs/en/api/beta/sessions/retrieve) for further provenance.
877896
878897 minLength: 1
879898
880 - `type: "session_actor"`
881
882899 - `BetaManagedAgentsAPIActor object`
883900
884901 Attribution for a write made directly via the public API (outside of any session).
885902
903 - `type: "api_actor"`
904
886905 - `api_key_id: string`
887906
888907 ID of the API key that performed the write. This identifies the key, not the secret.
from line 908
889908
890909 minLength: 1
891910
892 - `type: "api_actor"`
893
894911 - `BetaManagedAgentsUserActor object`
895912
896913 Attribution for a write made by a human user through the Anthropic Console.
from line 924
907924
908925 Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation.
909926
927 - `type: "service_account_actor"`
928
910929 - `service_account_id: string`
911930
912931 ID of the service account that performed the write (a `svac_...` value).
from line 932
913932
914933 minLength: 1
915934
916 - `type: "service_account_actor"`
917
918935### Beta Managed Agents API Actor
919936
920937- `BetaManagedAgentsAPIActor object`
from line 938
921938
922939 Attribution for a write made directly via the public API (outside of any session).
923940
941 - `type: "api_actor"`
942
924943 - `api_key_id: string`
925944
926945 ID of the API key that performed the write. This identifies the key, not the secret.
from line 946
927946
928947 minLength: 1
929948
930 - `type: "api_actor"`
931
932949### Beta Managed Agents Memory Version
933950
934951- `BetaManagedAgentsMemoryVersion object`
from line 952
935952
936953 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.
937954
955 - `type: "memory_version"`
956
938957 - `id: string`
939958
940959 Unique identifier for this version (a `memver_...` value).
from line 982
963982
964983 - `"deleted"`
965984
966 - `type: "memory_version"`
967
968985 - `content: optional string or null`
969986
970987 The memory's UTF-8 text content as of this version. `null` when `view=basic`, when `operation` is `deleted`, or when `redacted_at` is set.
from line 998
981998
982999 - `created_by: optional BetaManagedAgentsActor`
9831000
984 Identifies who performed a write or redact operation. Captured at write time on the `memory_version` row. The API key that created a session is not recorded on agent writes; attribution answers who made the write, not who is ultimately responsible. Look up session provenance separately via the [Sessions API](/docs/en/api/sessions-retrieve).
1001 Identifies who performed a write or redact operation. Captured at write time on the `memory_version` row. The API key that created a session is not recorded on agent writes; attribution answers who made the write, not who is ultimately responsible. Look up session provenance separately via the [Sessions API](/docs/en/api/beta/sessions/retrieve).
9851002
9861003 - `BetaManagedAgentsSessionActor object`
9871004
9881005 Attribution for a write made by an agent during a session, through the mounted filesystem at `/mnt/memory/`.
9891006
1007 - `type: "session_actor"`
1008
9901009 - `session_id: string`
9911010
992 ID of the session that performed the write (a `sesn_...` value). Look up the session via [Retrieve a session](/docs/en/api/sessions-retrieve) for further provenance.
1011 ID of the session that performed the write (a `sesn_...` value). Look up the session via [Retrieve a session](/docs/en/api/beta/sessions/retrieve) for further provenance.
9931012
9941013 minLength: 1
9951014
996 - `type: "session_actor"`
997
9981015 - `BetaManagedAgentsAPIActor object`
9991016
10001017 Attribution for a write made directly via the public API (outside of any session).
10011018
1019 - `type: "api_actor"`
1020
10021021 - `api_key_id: string`
10031022
10041023 ID of the API key that performed the write. This identifies the key, not the secret.
from line 1024
10051024
10061025 minLength: 1
10071026
1008 - `type: "api_actor"`
1009
10101027 - `BetaManagedAgentsUserActor object`
10111028
10121029 Attribution for a write made by a human user through the Anthropic Console.
from line 1040
10231040
10241041 Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation.
10251042
1043 - `type: "service_account_actor"`
1044
10261045 - `service_account_id: string`
10271046
10281047 ID of the service account that performed the write (a `svac_...` value).
from line 1048
10291048
10301049 minLength: 1
10311050
1032 - `type: "service_account_actor"`
1033
10341051 - `path: optional string or null`
10351052
10361053 The memory's path at the time of this write. `null` if and only if `redacted_at` is set.
from line 1060
10431060
10441061 - `redacted_by: optional BetaManagedAgentsActor`
10451062
1046 Identifies who performed a write or redact operation. Captured at write time on the `memory_version` row. The API key that created a session is not recorded on agent writes; attribution answers who made the write, not who is ultimately responsible. Look up session provenance separately via the [Sessions API](/docs/en/api/sessions-retrieve).
1063 Identifies who performed a write or redact operation. Captured at write time on the `memory_version` row. The API key that created a session is not recorded on agent writes; attribution answers who made the write, not who is ultimately responsible. Look up session provenance separately via the [Sessions API](/docs/en/api/beta/sessions/retrieve).
10471064
10481065### Beta Managed Agents Memory Version Operation
10491066
from line 1080
10631080
10641081 Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation.
10651082
1083 - `type: "service_account_actor"`
1084
10661085 - `service_account_id: string`
10671086
10681087 ID of the service account that performed the write (a `svac_...` value).
from line 1088
10691088
10701089 minLength: 1
10711090
1072 - `type: "service_account_actor"`
1073
10741091### Beta Managed Agents Session Actor
10751092
10761093- `BetaManagedAgentsSessionActor object`
from line 1094
10771094
10781095 Attribution for a write made by an agent during a session, through the mounted filesystem at `/mnt/memory/`.
10791096
1097 - `type: "session_actor"`
1098
10801099 - `session_id: string`
10811100
1082 ID of the session that performed the write (a `sesn_...` value). Look up the session via [Retrieve a session](/docs/en/api/sessions-retrieve) for further provenance.
1101 ID of the session that performed the write (a `sesn_...` value). Look up the session via [Retrieve a session](/docs/en/api/beta/sessions/retrieve) for further provenance.
10831102
10841103 minLength: 1
1085
1086 - `type: "session_actor"`
10871104
10881105### Beta Managed Agents User Actor
10891106
No line in this hunk matches that.