The whole hunk
from line 1, old and new numbered
/
lines
from line 1
1---
2title: Memory Stores
3url: https://platform.claude.com/docs/en/api/beta/memory_stores
4---
5
16# Memory Stores
27
38## Create a memory store
from line 19
1419
1520 - `string`
1621
17 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
22 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
1823
1924 - `"message-batches-2024-09-24"`
2025
from line 67
6267
6368 - `"user-profiles-2026-08-18"`
6469
70 - `"user-profiles-2026-09-04"`
71
6572 - `"advisor-tool-2026-03-01"`
6673
6774 - `"managed-agents-2026-04-01"`
from line 111
104111
105112 - `"mid-conversation-system-clear-at-2026-08-21"`
106113
114- `"anthropic-workspace-id": optional string`
115
107116### Body parameters
108117
109118- `name: string`
from line 137
128137
129138 A `memory_store`: a named container for agent memories, scoped to a workspace. Attach a store to a session via `resources[]` to mount it as a directory the agent can read and write.
130139
140 - `type: "memory_store"`
141
131142 - `id: string`
132143
133144 Unique identifier for the memory store (a `memstore_...` tagged ID). Use this when attaching the store to a session, or in the `{memory_store_id}` path parameter of subsequent calls.
from line 153
142153
143154 Human-readable name for the store. 1–255 characters. The store's mount-path slug under `/mnt/memory/` is derived from this name.
144155
145 - `type: "memory_store"`
146
147156 - `updated_at: string`
148157
149158 A timestamp in RFC 3339 format
from line 245
236245
237246 - `string`
238247
239 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
248 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
240249
241250 - `"message-batches-2024-09-24"`
242251
from line 293
284293
285294 - `"user-profiles-2026-08-18"`
286295
296 - `"user-profiles-2026-09-04"`
297
287298 - `"advisor-tool-2026-03-01"`
288299
289300 - `"managed-agents-2026-04-01"`
from line 337
326337
327338 - `"mid-conversation-system-clear-at-2026-08-21"`
328339
340- `"anthropic-workspace-id": optional string`
341
329342### Returns
330343
331344- `data: optional array of BetaManagedAgentsMemoryStore`
from line 345
332345
333346 Memory stores on this page, newest first. Empty when there are no stores matching the filters.
334347
348 - `type: "memory_store"`
349
335350 - `id: string`
336351
337352 Unique identifier for the memory store (a `memstore_...` tagged ID). Use this when attaching the store to a session, or in the `{memory_store_id}` path parameter of subsequent calls.
from line 361
346361
347362 Human-readable name for the store. 1–255 characters. The store's mount-path slug under `/mnt/memory/` is derived from this name.
348363
349 - `type: "memory_store"`
350
351364 - `updated_at: string`
352365
353366 A timestamp in RFC 3339 format
from line 434
421434
422435 - `string`
423436
424 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
437 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
425438
426439 - `"message-batches-2024-09-24"`
427440
from line 482
469482
470483 - `"user-profiles-2026-08-18"`
471484
485 - `"user-profiles-2026-09-04"`
486
472487 - `"advisor-tool-2026-03-01"`
473488
474489 - `"managed-agents-2026-04-01"`
from line 526
511526
512527 - `"mid-conversation-system-clear-at-2026-08-21"`
513528
529- `"anthropic-workspace-id": optional string`
530
514531### Returns
515532
516533- `BetaManagedAgentsMemoryStore object`
from line 534
517534
518535 A `memory_store`: a named container for agent memories, scoped to a workspace. Attach a store to a session via `resources[]` to mount it as a directory the agent can read and write.
519536
537 - `type: "memory_store"`
538
520539 - `id: string`
521540
522541 Unique identifier for the memory store (a `memstore_...` tagged ID). Use this when attaching the store to a session, or in the `{memory_store_id}` path parameter of subsequent calls.
from line 550
531550
532551 Human-readable name for the store. 1–255 characters. The store's mount-path slug under `/mnt/memory/` is derived from this name.
533552
534 - `type: "memory_store"`
535
536553 - `updated_at: string`
537554
538555 A timestamp in RFC 3339 format
from line 614
597614
598615 - `string`
599616
600 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
617 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
601618
602619 - `"message-batches-2024-09-24"`
603620
from line 662
645662
646663 - `"user-profiles-2026-08-18"`
647664
665 - `"user-profiles-2026-09-04"`
666
648667 - `"advisor-tool-2026-03-01"`
649668
650669 - `"managed-agents-2026-04-01"`
from line 706
687706
688707 - `"mid-conversation-system-clear-at-2026-08-21"`
689708
709- `"anthropic-workspace-id": optional string`
710
690711### Body parameters
691712
692713- `description: optional string or null`
from line 732
711732
712733 A `memory_store`: a named container for agent memories, scoped to a workspace. Attach a store to a session via `resources[]` to mount it as a directory the agent can read and write.
713734
735 - `type: "memory_store"`
736
714737 - `id: string`
715738
716739 Unique identifier for the memory store (a `memstore_...` tagged ID). Use this when attaching the store to a session, or in the `{memory_store_id}` path parameter of subsequent calls.
from line 748
725748
726749 Human-readable name for the store. 1–255 characters. The store's mount-path slug under `/mnt/memory/` is derived from this name.
727750
728 - `type: "memory_store"`
729
730751 - `updated_at: string`
731752
732753 A timestamp in RFC 3339 format
from line 814
793814
794815 - `string`
795816
796 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
817 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
797818
798819 - `"message-batches-2024-09-24"`
799820
from line 862
841862
842863 - `"user-profiles-2026-08-18"`
843864
865 - `"user-profiles-2026-09-04"`
866
844867 - `"advisor-tool-2026-03-01"`
845868
846869 - `"managed-agents-2026-04-01"`
from line 906
883906
884907 - `"mid-conversation-system-clear-at-2026-08-21"`
885908
909- `"anthropic-workspace-id": optional string`
910
886911### Returns
887912
888913- `BetaManagedAgentsDeletedMemoryStore object`
from line 914
889914
890915 Confirmation that a `memory_store` was deleted.
891916
917 - `type: "memory_store_deleted"`
918
892919 - `id: string`
893920
894921 ID of the deleted memory store (a `memstore_...` identifier). The store and all its memories and versions are no longer retrievable.
895922
896 - `type: "memory_store_deleted"`
897
898923### Example
899924
900925```bash
from line 957
932957
933958 - `string`
934959
935 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
960 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
936961
937962 - `"message-batches-2024-09-24"`
938963
from line 1005
9801005
9811006 - `"user-profiles-2026-08-18"`
9821007
1008 - `"user-profiles-2026-09-04"`
1009
9831010 - `"advisor-tool-2026-03-01"`
9841011
9851012 - `"managed-agents-2026-04-01"`
from line 1049
10221049
10231050 - `"mid-conversation-system-clear-at-2026-08-21"`
10241051
1052- `"anthropic-workspace-id": optional string`
1053
10251054### Returns
10261055
10271056- `BetaManagedAgentsMemoryStore object`
from line 1057
10281057
10291058 A `memory_store`: a named container for agent memories, scoped to a workspace. Attach a store to a session via `resources[]` to mount it as a directory the agent can read and write.
10301059
1060 - `type: "memory_store"`
1061
10311062 - `id: string`
10321063
10331064 Unique identifier for the memory store (a `memstore_...` tagged ID). Use this when attaching the store to a session, or in the `{memory_store_id}` path parameter of subsequent calls.
from line 1073
10421073
10431074 Human-readable name for the store. 1–255 characters. The store's mount-path slug under `/mnt/memory/` is derived from this name.
10441075
1045 - `type: "memory_store"`
1046
10471076 - `updated_at: string`
10481077
10491078 A timestamp in RFC 3339 format
from line 1128
10991128
11001129 Confirmation that a `memory_store` was deleted.
11011130
1131 - `type: "memory_store_deleted"`
1132
11021133 - `id: string`
11031134
11041135 ID of the deleted memory store (a `memstore_...` identifier). The store and all its memories and versions are no longer retrievable.
11051136
1106 - `type: "memory_store_deleted"`
1107
11081137### Beta Managed Agents Memory Store
11091138
11101139- `BetaManagedAgentsMemoryStore object`
from line 1140
11111140
11121141 A `memory_store`: a named container for agent memories, scoped to a workspace. Attach a store to a session via `resources[]` to mount it as a directory the agent can read and write.
11131142
1143 - `type: "memory_store"`
1144
11141145 - `id: string`
11151146
11161147 Unique identifier for the memory store (a `memstore_...` tagged ID). Use this when attaching the store to a session, or in the `{memory_store_id}` path parameter of subsequent calls.
from line 1156
11251156
11261157 Human-readable name for the store. 1–255 characters. The store's mount-path slug under `/mnt/memory/` is derived from this name.
11271158
1128 - `type: "memory_store"`
1129
11301159 - `updated_at: string`
11311160
11321161 A timestamp in RFC 3339 format
from line 1206
11771206
11781207 - `string`
11791208
1180 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
1209 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
11811210
11821211 - `"message-batches-2024-09-24"`
11831212
from line 1254
12251254
12261255 - `"user-profiles-2026-08-18"`
12271256
1257 - `"user-profiles-2026-09-04"`
1258
12281259 - `"advisor-tool-2026-03-01"`
12291260
12301261 - `"managed-agents-2026-04-01"`
from line 1298
12671298
12681299 - `"mid-conversation-system-clear-at-2026-08-21"`
12691300
1301- `"anthropic-workspace-id": optional string`
1302
12701303#### Body parameters
12711304
12721305- `content: string or null`
from line 1318
12851318
12861319 A `memory` object: a single text document at a hierarchical path inside a memory store. The `content` field is populated when `view=full` and `null` when `view=basic`; the `content_size_bytes` and `content_sha256` fields are always populated so sync clients can diff without fetching content. Memories are addressed by their `mem_...` ID; the path is the create key and can be changed via update.
12871320
1321 - `type: "memory"`
1322
12881323 - `id: string`
12891324
12901325 Unique identifier for this memory (a `mem_...` value). Stable across renames; use this ID, not the path, to read, update, or delete the memory.
from line 1352
13171352
13181353 Hierarchical path of the memory within the store, e.g. `/projects/foo/notes.md`. Always starts with `/`. Paths are case-sensitive and unique within a store. Maximum 1,024 bytes.
13191354
1320 - `type: "memory"`
1321
13221355 - `updated_at: string`
13231356
13241357 A timestamp in RFC 3339 format
from line 1441
14081441
14091442 - `string`
14101443
1411 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
1444 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
14121445
14131446 - `"message-batches-2024-09-24"`
14141447
from line 1489
14561489
14571490 - `"user-profiles-2026-08-18"`
14581491
1492 - `"user-profiles-2026-09-04"`
1493
14591494 - `"advisor-tool-2026-03-01"`
14601495
14611496 - `"managed-agents-2026-04-01"`
from line 1533
14981533
14991534 - `"mid-conversation-system-clear-at-2026-08-21"`
15001535
1536- `"anthropic-workspace-id": optional string`
1537
15011538#### Returns
15021539
15031540- `data: optional array of BetaManagedAgentsMemoryListItem`
from line 1545
15081545
15091546 A `memory` object: a single text document at a hierarchical path inside a memory store. The `content` field is populated when `view=full` and `null` when `view=basic`; the `content_size_bytes` and `content_sha256` fields are always populated so sync clients can diff without fetching content. Memories are addressed by their `mem_...` ID; the path is the create key and can be changed via update.
15101547
1548 - `type: "memory"`
1549
15111550 - `id: string`
15121551
15131552 Unique identifier for this memory (a `mem_...` value). Stable across renames; use this ID, not the path, to read, update, or delete the memory.
from line 1579
15401579
15411580 Hierarchical path of the memory within the store, e.g. `/projects/foo/notes.md`. Always starts with `/`. Paths are case-sensitive and unique within a store. Maximum 1,024 bytes.
15421581
1543 - `type: "memory"`
1544
15451582 - `updated_at: string`
15461583
15471584 A timestamp in RFC 3339 format
from line 1593
15561593
15571594 A rolled-up directory marker returned by [List memories](/docs/en/api/beta/memory_stores/memories/list) when `depth` is set. Indicates that one or more memories exist deeper than the requested depth under this prefix. This is a list-time rollup, not a stored resource; it has no ID and no lifecycle. Each prefix counts toward the page `limit` and interleaves with `memory` items in path order.
15581595
1596 - `type: "memory_prefix"`
1597
15591598 - `path: string`
15601599
15611600 The rolled-up path prefix, including a trailing `/` (e.g. `/projects/foo/`). Pass this value as `path_prefix` on a subsequent list call to drill into the directory.
15621601
1563 - `type: "memory_prefix"`
1564
15651602- `next_page: optional string or null`
15661603
15671604 Opaque cursor for the next page (a `page_...` value), or `null` if there are no more results. Pass as `page` on the next request.
from line 1664
16271664
16281665 - `string`
16291666
1630 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
1667 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
16311668
16321669 - `"message-batches-2024-09-24"`
16331670
from line 1712
16751712
16761713 - `"user-profiles-2026-08-18"`
16771714
1715 - `"user-profiles-2026-09-04"`
1716
16781717 - `"advisor-tool-2026-03-01"`
16791718
16801719 - `"managed-agents-2026-04-01"`
from line 1756
17171756
17181757 - `"mid-conversation-system-clear-at-2026-08-21"`
17191758
1759- `"anthropic-workspace-id": optional string`
1760
17201761#### Returns
17211762
17221763- `BetaManagedAgentsMemory object`
from line 1764
17231764
17241765 A `memory` object: a single text document at a hierarchical path inside a memory store. The `content` field is populated when `view=full` and `null` when `view=basic`; the `content_size_bytes` and `content_sha256` fields are always populated so sync clients can diff without fetching content. Memories are addressed by their `mem_...` ID; the path is the create key and can be changed via update.
17251766
1767 - `type: "memory"`
1768
17261769 - `id: string`
17271770
17281771 Unique identifier for this memory (a `mem_...` value). Stable across renames; use this ID, not the path, to read, update, or delete the memory.
from line 1798
17551798
17561799 Hierarchical path of the memory within the store, e.g. `/projects/foo/notes.md`. Always starts with `/`. Paths are case-sensitive and unique within a store. Maximum 1,024 bytes.
17571800
1758 - `type: "memory"`
1759
17601801 - `updated_at: string`
17611802
17621803 A timestamp in RFC 3339 format
from line 1864
18231864
18241865 - `string`
18251866
1826 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
1867 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
18271868
18281869 - `"message-batches-2024-09-24"`
18291870
from line 1912
18711912
18721913 - `"user-profiles-2026-08-18"`
18731914
1915 - `"user-profiles-2026-09-04"`
1916
18741917 - `"advisor-tool-2026-03-01"`
18751918
18761919 - `"managed-agents-2026-04-01"`
from line 1956
19131956
19141957 - `"mid-conversation-system-clear-at-2026-08-21"`
19151958
1959- `"anthropic-workspace-id": optional string`
1960
19161961#### Body parameters
19171962
19181963- `content: optional string or null`
from line 1986
19411986
19421987 A `memory` object: a single text document at a hierarchical path inside a memory store. The `content` field is populated when `view=full` and `null` when `view=basic`; the `content_size_bytes` and `content_sha256` fields are always populated so sync clients can diff without fetching content. Memories are addressed by their `mem_...` ID; the path is the create key and can be changed via update.
19431988
1989 - `type: "memory"`
1990
19441991 - `id: string`
19451992
19461993 Unique identifier for this memory (a `mem_...` value). Stable across renames; use this ID, not the path, to read, update, or delete the memory.
from line 2020
19732020
19742021 Hierarchical path of the memory within the store, e.g. `/projects/foo/notes.md`. Always starts with `/`. Paths are case-sensitive and unique within a store. Maximum 1,024 bytes.
19752022
1976 - `type: "memory"`
1977
19782023 - `updated_at: string`
19792024
19802025 A timestamp in RFC 3339 format
from line 2084
20392084
20402085 - `string`
20412086
2042 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
2087 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
20432088
20442089 - `"message-batches-2024-09-24"`
20452090
from line 2132
20872132
20882133 - `"user-profiles-2026-08-18"`
20892134
2135 - `"user-profiles-2026-09-04"`
2136
20902137 - `"advisor-tool-2026-03-01"`
20912138
20922139 - `"managed-agents-2026-04-01"`
from line 2176
21292176
21302177 - `"mid-conversation-system-clear-at-2026-08-21"`
21312178
2179- `"anthropic-workspace-id": optional string`
2180
21322181#### Returns
21332182
21342183- `BetaManagedAgentsDeletedMemory object`
from line 2184
21352184
21362185 Tombstone returned by [Delete a memory](/docs/en/api/beta/memory_stores/memories/delete). Deleting a memory does not erase its version history: its versions remain listable via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) while they are retained (each version is kept for at least the version retention period after it was written, unless the store itself is deleted).
21372186
2187 - `type: "memory_deleted"`
2188
21382189 - `id: string`
21392190
21402191 ID of the deleted memory (a `mem_...` value).
21412192
2142 - `type: "memory_deleted"`
2143
21442193#### Example
21452194
21462195```bash
from line 2287
22382287
22392288 - `string`
22402289
2241 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
2290 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
22422291
22432292 - `"message-batches-2024-09-24"`
22442293
from line 2335
22862335
22872336 - `"user-profiles-2026-08-18"`
22882337
2338 - `"user-profiles-2026-09-04"`
2339
22892340 - `"advisor-tool-2026-03-01"`
22902341
22912342 - `"managed-agents-2026-04-01"`
from line 2379
23282379
23292380 - `"mid-conversation-system-clear-at-2026-08-21"`
23302381
2382- `"anthropic-workspace-id": optional string`
2383
23312384#### Returns
23322385
23332386- `data: optional array of BetaManagedAgentsMemoryVersion`
from line 2387
23342387
23352388 One page of `memory_version` objects, ordered by `created_at` descending (newest first), with `id` as tiebreak.
23362389
2390 - `type: "memory_version"`
2391
23372392 - `id: string`
23382393
23392394 Unique identifier for this version (a `memver_...` value).
from line 2417
23622417
23632418 - `"deleted"`
23642419
2365 - `type: "memory_version"`
2366
23672420 - `content: optional string or null`
23682421
23692422 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 2433
23802433
23812434 - `created_by: optional BetaManagedAgentsActor`
23822435
2383 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).
2436 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).
23842437
23852438 - `BetaManagedAgentsSessionActor object`
23862439
23872440 Attribution for a write made by an agent during a session, through the mounted filesystem at `/mnt/memory/`.
23882441
2442 - `type: "session_actor"`
2443
23892444 - `session_id: string`
23902445
2391 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.
2446 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.
23922447
23932448 minLength: 1
23942449
2395 - `type: "session_actor"`
2396
23972450 - `BetaManagedAgentsAPIActor object`
23982451
23992452 Attribution for a write made directly via the public API (outside of any session).
24002453
2454 - `type: "api_actor"`
2455
24012456 - `api_key_id: string`
24022457
24032458 ID of the API key that performed the write. This identifies the key, not the secret.
from line 2459
24042459
24052460 minLength: 1
24062461
2407 - `type: "api_actor"`
2408
24092462 - `BetaManagedAgentsUserActor object`
24102463
24112464 Attribution for a write made by a human user through the Anthropic Console.
from line 2475
24222475
24232476 Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation.
24242477
2478 - `type: "service_account_actor"`
2479
24252480 - `service_account_id: string`
24262481
24272482 ID of the service account that performed the write (a `svac_...` value).
from line 2483
24282483
24292484 minLength: 1
24302485
2431 - `type: "service_account_actor"`
2432
24332486 - `path: optional string or null`
24342487
24352488 The memory's path at the time of this write. `null` if and only if `redacted_at` is set.
from line 2495
24422495
24432496 - `redacted_by: optional BetaManagedAgentsActor`
24442497
2445 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).
2498 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).
24462499
24472500- `next_page: optional string or null`
24482501
from line 2571
25182571
25192572 - `string`
25202573
2521 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
2574 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
25222575
25232576 - `"message-batches-2024-09-24"`
25242577
from line 2619
25662619
25672620 - `"user-profiles-2026-08-18"`
25682621
2622 - `"user-profiles-2026-09-04"`
2623
25692624 - `"advisor-tool-2026-03-01"`
25702625
25712626 - `"managed-agents-2026-04-01"`
from line 2663
26082663
26092664 - `"mid-conversation-system-clear-at-2026-08-21"`
26102665
2666- `"anthropic-workspace-id": optional string`
2667
26112668#### Returns
26122669
26132670- `BetaManagedAgentsMemoryVersion object`
from line 2671
26142671
26152672 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.
26162673
2674 - `type: "memory_version"`
2675
26172676 - `id: string`
26182677
26192678 Unique identifier for this version (a `memver_...` value).
from line 2701
26422701
26432702 - `"deleted"`
26442703
2645 - `type: "memory_version"`
2646
26472704 - `content: optional string or null`
26482705
26492706 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 2717
26602717
26612718 - `created_by: optional BetaManagedAgentsActor`
26622719
2663 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).
2720 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).
26642721
26652722 - `BetaManagedAgentsSessionActor object`
26662723
26672724 Attribution for a write made by an agent during a session, through the mounted filesystem at `/mnt/memory/`.
26682725
2726 - `type: "session_actor"`
2727
26692728 - `session_id: string`
26702729
2671 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.
2730 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.
26722731
26732732 minLength: 1
26742733
2675 - `type: "session_actor"`
2676
26772734 - `BetaManagedAgentsAPIActor object`
26782735
26792736 Attribution for a write made directly via the public API (outside of any session).
26802737
2738 - `type: "api_actor"`
2739
26812740 - `api_key_id: string`
26822741
26832742 ID of the API key that performed the write. This identifies the key, not the secret.
from line 2743
26842743
26852744 minLength: 1
26862745
2687 - `type: "api_actor"`
2688
26892746 - `BetaManagedAgentsUserActor object`
26902747
26912748 Attribution for a write made by a human user through the Anthropic Console.
from line 2759
27022759
27032760 Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation.
27042761
2762 - `type: "service_account_actor"`
2763
27052764 - `service_account_id: string`
27062765
27072766 ID of the service account that performed the write (a `svac_...` value).
from line 2767
27082767
27092768 minLength: 1
27102769
2711 - `type: "service_account_actor"`
2712
27132770 - `path: optional string or null`
27142771
27152772 The memory's path at the time of this write. `null` if and only if `redacted_at` is set.
from line 2779
27222779
27232780 - `redacted_by: optional BetaManagedAgentsActor`
27242781
2725 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).
2782 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).
27262783
27272784#### Example
27282785
from line 2836
27792836
27802837 - `string`
27812838
2782 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
2839 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
27832840
27842841 - `"message-batches-2024-09-24"`
27852842
from line 2884
28272884
28282885 - `"user-profiles-2026-08-18"`
28292886
2887 - `"user-profiles-2026-09-04"`
2888
28302889 - `"advisor-tool-2026-03-01"`
28312890
28322891 - `"managed-agents-2026-04-01"`
from line 2928
28692928
28702929 - `"mid-conversation-system-clear-at-2026-08-21"`
28712930
2931- `"anthropic-workspace-id": optional string`
2932
28722933#### Returns
28732934
28742935- `BetaManagedAgentsMemoryVersion object`
from line 2936
28752936
28762937 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.
28772938
2939 - `type: "memory_version"`
2940
28782941 - `id: string`
28792942
28802943 Unique identifier for this version (a `memver_...` value).
from line 2966
29032966
29042967 - `"deleted"`
29052968
2906 - `type: "memory_version"`
2907
29082969 - `content: optional string or null`
29092970
29102971 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 2982
29212982
29222983 - `created_by: optional BetaManagedAgentsActor`
29232984
2924 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).
2985 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).
29252986
29262987 - `BetaManagedAgentsSessionActor object`
29272988
29282989 Attribution for a write made by an agent during a session, through the mounted filesystem at `/mnt/memory/`.
29292990
2991 - `type: "session_actor"`
2992
29302993 - `session_id: string`
29312994
2932 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.
2995 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.
29332996
29342997 minLength: 1
29352998
2936 - `type: "session_actor"`
2937
29382999 - `BetaManagedAgentsAPIActor object`
29393000
29403001 Attribution for a write made directly via the public API (outside of any session).
29413002
3003 - `type: "api_actor"`
3004
29423005 - `api_key_id: string`
29433006
29443007 ID of the API key that performed the write. This identifies the key, not the secret.
from line 3008
29453008
29463009 minLength: 1
29473010
2948 - `type: "api_actor"`
2949
29503011 - `BetaManagedAgentsUserActor object`
29513012
29523013 Attribution for a write made by a human user through the Anthropic Console.
from line 3024
29633024
29643025 Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation.
29653026
3027 - `type: "service_account_actor"`
3028
29663029 - `service_account_id: string`
29673030
29683031 ID of the service account that performed the write (a `svac_...` value).
from line 3032
29693032
29703033 minLength: 1
29713034
2972 - `type: "service_account_actor"`
2973
29743035 - `path: optional string or null`
29753036
29763037 The memory's path at the time of this write. `null` if and only if `redacted_at` is set.
from line 3044
29833044
29843045 - `redacted_by: optional BetaManagedAgentsActor`
29853046
2986 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).
3047 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).
29873048
29883049#### Example
29893050