The whole hunk
from line 1, old and new numbered
/
lines
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