Memory Stores changedapi/beta/memory_stores
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+136added
Lines−75removed
From line
1
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits25to this page, all time
The whole hunk
from line 1, old and new numbered
/
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
No line in this hunk matches that.