What this read moved
176–200 of 519This capture is too large to show at once. Changes 176-200 of 519 are below, significant first; the rest are on the following screens.
api/beta/environments/work/update Changed · +20 / -11 lines
from line 1
1---
2title: Update Work Item
3url: https://platform.claude.com/docs/en/api/beta/environments/work/update
4---
5
16# Update Work Item
27
38**POST** `/v1/environments/{environment_id}/work/{work_id}`
from line 25
2025
2126 - `string`
2227
23 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
28 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
2429
2530 - `"message-batches-2024-09-24"`
2631
from line 73
6873
6974 - `"user-profiles-2026-08-18"`
7075
76 - `"user-profiles-2026-09-04"`
77
7178 - `"advisor-tool-2026-03-01"`
7279
7380 - `"managed-agents-2026-04-01"`
from line 117
110117
111118 - `"mid-conversation-system-clear-at-2026-08-21"`
112119
120- `"anthropic-workspace-id": optional string`
121
113122## Body parameters
114123
115124- `metadata: map[string]`
from line 135
126135 receive new messages. The environment worker polls for work to execute in a
127136 self-hosted sandbox.
128137
138 - `type: "work"`
139
140 The type of object (always 'work')
141
142 default: work
143
129144 - `id: string`
130145
131146 Work identifier (e.g., 'work_...')
from line 157
142157
143158 The actual work to be performed
144159
145 - `id: string`
146
147 Session identifier (e.g., 'session_...')
148
149160 - `type: "session"`
150161
151162 Type of work data
152163
164 - `id: string`
165
166 Session identifier (e.g., 'session_...')
167
153168 - `environment_id: string`
154169
155170 Environment identifier this work belongs to (e.g., `env_...`)
from line 206
191206 - `stopped_at: string or null`
192207
193208 RFC 3339 timestamp when work execution stopped
194
195 - `type: "work"`
196
197 The type of object (always 'work')
198
199 default: work
200209
201210## Example
202211
api/beta/files Changed · +91 / -66 lines
from line 1
1---
2title: Files
3url: https://platform.claude.com/docs/en/api/beta/files
4---
5
16# Files
27
38## Upload File
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 (form-data)
108117
109118- `file: string`
110119
111 The file to upload
120 The file to upload. Only the final path component of the part's `filename` is kept; an absent or empty `filename` is replaced with `unnamed` plus the extension for the file's stored `mime_type`, when known.
112121
113122 format: binary
114123
from line 131
122131
123132- `BetaFileMetadata object`
124133
134 - `type: "file"`
135
136 Object type.
137
138 For files, this is always `"file"`.
139
125140 - `id: string`
126141
127142 Unique object identifier.
from line 167
152167
153168 minimum: 0
154169
155 - `type: "file"`
156
157 Object type.
158
159 For files, this is always `"file"`.
160
161170 - `downloadable: optional boolean`
162171
163172 Whether the file can be downloaded.
from line 183
174183
175184 The scope of this file, indicating the context in which it was created (e.g., a session).
176185
177 - `id: string`
178
179 The ID of the scoping resource (e.g., the session ID).
180
181186 - `type: "session"`
182187
183188 The type of scope (e.g., `"session"`).
184189
190 - `id: string`
191
192 The ID of the scoping resource (e.g., the session ID).
193
185194### Example
186195
187196```bash
from line 256
247256
248257 - `string`
249258
250 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
259 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
251260
252261 - `"message-batches-2024-09-24"`
253262
from line 304
295304
296305 - `"user-profiles-2026-08-18"`
297306
307 - `"user-profiles-2026-09-04"`
308
298309 - `"advisor-tool-2026-03-01"`
299310
300311 - `"managed-agents-2026-04-01"`
from line 348
337348
338349 - `"mid-conversation-system-clear-at-2026-08-21"`
339350
351- `"anthropic-workspace-id": optional string`
352
340353### Returns
341354
342355- `data: array of BetaFileMetadata`
from line 356
343356
344357 List of file metadata objects.
345358
359 - `type: "file"`
360
361 Object type.
362
363 For files, this is always `"file"`.
364
346365 - `id: string`
347366
348367 Unique object identifier.
from line 392
373392
374393 minimum: 0
375394
376 - `type: "file"`
377
378 Object type.
379
380 For files, this is always `"file"`.
381
382395 - `downloadable: optional boolean`
383396
384397 Whether the file can be downloaded.
from line 408
395408
396409 The scope of this file, indicating the context in which it was created (e.g., a session).
397410
398 - `id: string`
399
400 The ID of the scoping resource (e.g., the session ID).
401
402411 - `type: "session"`
403412
404413 The type of scope (e.g., `"session"`).
405414
415 - `id: string`
416
417 The ID of the scoping resource (e.g., the session ID).
418
406419- `next_page: optional string or null`
407420
408421 Opaque cursor for the next page. Supply as `?page=` to fetch the next page; null when there are no more results.
from line 472
459472
460473 - `string`
461474
462 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
475 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
463476
464477 - `"message-batches-2024-09-24"`
465478
from line 520
507520
508521 - `"user-profiles-2026-08-18"`
509522
523 - `"user-profiles-2026-09-04"`
524
510525 - `"advisor-tool-2026-03-01"`
511526
512527 - `"managed-agents-2026-04-01"`
from line 564
549564
550565 - `"mid-conversation-system-clear-at-2026-08-21"`
551566
567- `"anthropic-workspace-id": optional string`
568
552569### Example
553570
554571```bash
from line 594
577594
578595 - `string`
579596
580 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
597 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
581598
582599 - `"message-batches-2024-09-24"`
583600
from line 642
625642
626643 - `"user-profiles-2026-08-18"`
627644
645 - `"user-profiles-2026-09-04"`
646
628647 - `"advisor-tool-2026-03-01"`
629648
630649 - `"managed-agents-2026-04-01"`
from line 686
667686
668687 - `"mid-conversation-system-clear-at-2026-08-21"`
669688
689- `"anthropic-workspace-id": optional string`
690
670691### Returns
671692
672693- `BetaFileMetadata object`
673694
695 - `type: "file"`
696
697 Object type.
698
699 For files, this is always `"file"`.
700
674701 - `id: string`
675702
676703 Unique object identifier.
from line 728
701728
702729 minimum: 0
703730
704 - `type: "file"`
705
706 Object type.
707
708 For files, this is always `"file"`.
709
710731 - `downloadable: optional boolean`
711732
712733 Whether the file can be downloaded.
from line 744
723744
724745 The scope of this file, indicating the context in which it was created (e.g., a session).
725746
726 - `id: string`
727
728 The ID of the scoping resource (e.g., the session ID).
729
730747 - `type: "session"`
731748
732749 The type of scope (e.g., `"session"`).
733750
751 - `id: string`
752
753 The ID of the scoping resource (e.g., the session ID).
754
734755### Example
735756
736757```bash
from line 799
778799
779800 - `string`
780801
781 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
802 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
782803
783804 - `"message-batches-2024-09-24"`
784805
from line 847
826847
827848 - `"user-profiles-2026-08-18"`
828849
850 - `"user-profiles-2026-09-04"`
851
829852 - `"advisor-tool-2026-03-01"`
830853
831854 - `"managed-agents-2026-04-01"`
from line 891
868891
869892 - `"mid-conversation-system-clear-at-2026-08-21"`
870893
894- `"anthropic-workspace-id": optional string`
895
871896### Returns
872897
873898- `BetaDeletedFile object`
874899
875 - `id: string`
876
877 ID of the deleted file.
878
879900 - `type: optional "file_deleted"`
880901
881902 Deleted object type.
from line 905
884905
885906 default: file_deleted
886907
908 - `id: string`
909
910 ID of the deleted file.
911
887912### Example
888913
889914```bash
from line 933
908933
909934- `BetaDeletedFile object`
910935
911 - `id: string`
912
913 ID of the deleted file.
914
915936 - `type: optional "file_deleted"`
916937
917938 Deleted object type.
from line 941
920941
921942 default: file_deleted
922943
944 - `id: string`
945
946 ID of the deleted file.
947
923948### Beta File Metadata
924949
925950- `BetaFileMetadata object`
926951
952 - `type: "file"`
953
954 Object type.
955
956 For files, this is always `"file"`.
957
927958 - `id: string`
928959
929960 Unique object identifier.
from line 985
954985
955986 minimum: 0
956987
957 - `type: "file"`
958
959 Object type.
960
961 For files, this is always `"file"`.
962
963988 - `downloadable: optional boolean`
964989
965990 Whether the file can be downloaded.
from line 1001
9761001
9771002 The scope of this file, indicating the context in which it was created (e.g., a session).
9781003
979 - `id: string`
980
981 The ID of the scoping resource (e.g., the session ID).
982
9831004 - `type: "session"`
9841005
9851006 The type of scope (e.g., `"session"`).
9861007
1008 - `id: string`
1009
1010 The ID of the scoping resource (e.g., the session ID).
1011
9871012### Beta File Scope
9881013
9891014- `BetaFileScope object`
9901015
991 - `id: string`
992
993 The ID of the scoping resource (e.g., the session ID).
994
9951016 - `type: "session"`
9961017
9971018 The type of scope (e.g., `"session"`).
1019
1020 - `id: string`
1021
1022 The ID of the scoping resource (e.g., the session ID).
9981023
api/beta/files/delete Changed · +14 / -5 lines
from line 1
1---
2title: Delete File
3url: https://platform.claude.com/docs/en/api/beta/files/delete
4---
5
16# Delete File
27
38**DELETE** `/v1/files/{file_id}`
from line 23
1823
1924 - `string`
2025
21 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
26 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
2227
2328 - `"message-batches-2024-09-24"`
2429
from line 71
6671
6772 - `"user-profiles-2026-08-18"`
6873
74 - `"user-profiles-2026-09-04"`
75
6976 - `"advisor-tool-2026-03-01"`
7077
7178 - `"managed-agents-2026-04-01"`
from line 115
108115
109116 - `"mid-conversation-system-clear-at-2026-08-21"`
110117
118- `"anthropic-workspace-id": optional string`
119
111120## Returns
112121
113122- `BetaDeletedFile object`
114123
115 - `id: string`
116
117 ID of the deleted file.
118
119124 - `type: optional "file_deleted"`
120125
121126 Deleted object type.
from line 128
123128 For file deletion, this is always `"file_deleted"`.
124129
125130 default: file_deleted
131
132 - `id: string`
133
134 ID of the deleted file.
126135
127136## Example
128137
api/beta/files/download Changed · +10 / -1 lines
from line 1
1---
2title: Download File
3url: https://platform.claude.com/docs/en/api/beta/files/download
4---
5
16# Download File
27
38**GET** `/v1/files/{file_id}/content`
from line 23
1823
1924 - `string`
2025
21 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
26 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
2227
2328 - `"message-batches-2024-09-24"`
2429
from line 71
6671
6772 - `"user-profiles-2026-08-18"`
6873
74 - `"user-profiles-2026-09-04"`
75
6976 - `"advisor-tool-2026-03-01"`
7077
7178 - `"managed-agents-2026-04-01"`
from line 114
107114 - `"thinking-binding-controls-2026-08-01"`
108115
109116 - `"mid-conversation-system-clear-at-2026-08-21"`
117
118- `"anthropic-workspace-id": optional string`
110119
111120## Example
112121
api/beta/files/list Changed · +20 / -11 lines
from line 1
1---
2title: List Files
3url: https://platform.claude.com/docs/en/api/beta/files/list
4---
5
16# List Files
27
38**GET** `/v1/files`
from line 39
3439
3540 - `string`
3641
37 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
42 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
3843
3944 - `"message-batches-2024-09-24"`
4045
from line 87
8287
8388 - `"user-profiles-2026-08-18"`
8489
90 - `"user-profiles-2026-09-04"`
91
8592 - `"advisor-tool-2026-03-01"`
8693
8794 - `"managed-agents-2026-04-01"`
from line 131
124131
125132 - `"mid-conversation-system-clear-at-2026-08-21"`
126133
134- `"anthropic-workspace-id": optional string`
135
127136## Returns
128137
129138- `data: array of BetaFileMetadata`
from line 139
130139
131140 List of file metadata objects.
132141
142 - `type: "file"`
143
144 Object type.
145
146 For files, this is always `"file"`.
147
133148 - `id: string`
134149
135150 Unique object identifier.
from line 175
160175
161176 minimum: 0
162177
163 - `type: "file"`
164
165 Object type.
166
167 For files, this is always `"file"`.
168
169178 - `downloadable: optional boolean`
170179
171180 Whether the file can be downloaded.
from line 191
182191
183192 The scope of this file, indicating the context in which it was created (e.g., a session).
184193
185 - `id: string`
186
187 The ID of the scoping resource (e.g., the session ID).
188
189194 - `type: "session"`
190195
191196 The type of scope (e.g., `"session"`).
197
198 - `id: string`
199
200 The ID of the scoping resource (e.g., the session ID).
192201
193202- `next_page: optional string or null`
194203
api/beta/files/retrieve_metadata Changed · +20 / -11 lines
from line 1
1---
2title: Get File Metadata
3url: https://platform.claude.com/docs/en/api/beta/files/retrieve_metadata
4---
5
16# Get File Metadata
27
38**GET** `/v1/files/{file_id}`
from line 23
1823
1924 - `string`
2025
21 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
26 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
2227
2328 - `"message-batches-2024-09-24"`
2429
from line 71
6671
6772 - `"user-profiles-2026-08-18"`
6873
74 - `"user-profiles-2026-09-04"`
75
6976 - `"advisor-tool-2026-03-01"`
7077
7178 - `"managed-agents-2026-04-01"`
from line 115
108115
109116 - `"mid-conversation-system-clear-at-2026-08-21"`
110117
118- `"anthropic-workspace-id": optional string`
119
111120## Returns
112121
113122- `BetaFileMetadata object`
114123
124 - `type: "file"`
125
126 Object type.
127
128 For files, this is always `"file"`.
129
115130 - `id: string`
116131
117132 Unique object identifier.
from line 157
142157
143158 minimum: 0
144159
145 - `type: "file"`
146
147 Object type.
148
149 For files, this is always `"file"`.
150
151160 - `downloadable: optional boolean`
152161
153162 Whether the file can be downloaded.
from line 173
164173
165174 The scope of this file, indicating the context in which it was created (e.g., a session).
166175
167 - `id: string`
168
169 The ID of the scoping resource (e.g., the session ID).
170
171176 - `type: "session"`
172177
173178 The type of scope (e.g., `"session"`).
179
180 - `id: string`
181
182 The ID of the scoping resource (e.g., the session ID).
174183
175184## Example
176185
api/beta/files/upload Changed · +21 / -12 lines
from line 1
1---
2title: Upload File
3url: https://platform.claude.com/docs/en/api/beta/files/upload
4---
5
16# Upload File
27
38**POST** `/v1/files`
from line 17
1217
1318 - `string`
1419
15 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
20 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
1621
1722 - `"message-batches-2024-09-24"`
1823
from line 65
6065
6166 - `"user-profiles-2026-08-18"`
6267
68 - `"user-profiles-2026-09-04"`
69
6370 - `"advisor-tool-2026-03-01"`
6471
6572 - `"managed-agents-2026-04-01"`
from line 109
102109
103110 - `"mid-conversation-system-clear-at-2026-08-21"`
104111
112- `"anthropic-workspace-id": optional string`
113
105114## Body parameters (form-data)
106115
107116- `file: string`
108117
109 The file to upload
118 The file to upload. Only the final path component of the part's `filename` is kept; an absent or empty `filename` is replaced with `unnamed` plus the extension for the file's stored `mime_type`, when known.
110119
111120 format: binary
112121
from line 129
120129
121130- `BetaFileMetadata object`
122131
132 - `type: "file"`
133
134 Object type.
135
136 For files, this is always `"file"`.
137
123138 - `id: string`
124139
125140 Unique object identifier.
from line 165
150165
151166 minimum: 0
152167
153 - `type: "file"`
154
155 Object type.
156
157 For files, this is always `"file"`.
158
159168 - `downloadable: optional boolean`
160169
161170 Whether the file can be downloaded.
from line 181
172181
173182 The scope of this file, indicating the context in which it was created (e.g., a session).
174183
175 - `id: string`
176
177 The ID of the scoping resource (e.g., the session ID).
178
179184 - `type: "session"`
180185
181186 The type of scope (e.g., `"session"`).
187
188 - `id: string`
189
190 The ID of the scoping resource (e.g., the session ID).
182191
183192## Example
184193
api/beta/memory_stores Changed · +136 / -75 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
api/beta/memory_stores/archive Changed · +12 / -3 lines
from line 1
1---
2title: Archive a memory store
3url: https://platform.claude.com/docs/en/api/beta/memory_stores/archive
4---
5
16# Archive a memory store
27
38**POST** `/v1/memory_stores/{memory_store_id}/archive`
from line 21
1621
1722 - `string`
1823
19 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
24 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
2025
2126 - `"message-batches-2024-09-24"`
2227
from line 69
6469
6570 - `"user-profiles-2026-08-18"`
6671
72 - `"user-profiles-2026-09-04"`
73
6774 - `"advisor-tool-2026-03-01"`
6875
6976 - `"managed-agents-2026-04-01"`
from line 113
106113
107114 - `"mid-conversation-system-clear-at-2026-08-21"`
108115
116- `"anthropic-workspace-id": optional string`
117
109118## Returns
110119
111120- `BetaManagedAgentsMemoryStore object`
from line 121
112121
113122 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.
114123
124 - `type: "memory_store"`
125
115126 - `id: string`
116127
117128 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 136
125136 - `name: string`
126137
127138 Human-readable name for the store. 1–255 characters. The store's mount-path slug under `/mnt/memory/` is derived from this name.
128
129 - `type: "memory_store"`
130139
131140 - `updated_at: string`
132141
api/beta/memory_stores/create Changed · +12 / -3 lines
from line 1
1---
2title: Create a memory store
3url: https://platform.claude.com/docs/en/api/beta/memory_stores/create
4---
5
16# Create a memory store
27
38**POST** `/v1/memory_stores`
from line 17
1217
1318 - `string`
1419
15 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
20 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
1621
1722 - `"message-batches-2024-09-24"`
1823
from line 65
6065
6166 - `"user-profiles-2026-08-18"`
6267
68 - `"user-profiles-2026-09-04"`
69
6370 - `"advisor-tool-2026-03-01"`
6471
6572 - `"managed-agents-2026-04-01"`
from line 109
102109
103110 - `"mid-conversation-system-clear-at-2026-08-21"`
104111
112- `"anthropic-workspace-id": optional string`
113
105114## Body parameters
106115
107116- `name: string`
from line 135
126135
127136 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.
128137
138 - `type: "memory_store"`
139
129140 - `id: string`
130141
131142 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 150
139150 - `name: string`
140151
141152 Human-readable name for the store. 1–255 characters. The store's mount-path slug under `/mnt/memory/` is derived from this name.
142
143 - `type: "memory_store"`
144153
145154 - `updated_at: string`
146155
api/beta/memory_stores/delete Changed · +12 / -3 lines
from line 1
1---
2title: Delete a memory store
3url: https://platform.claude.com/docs/en/api/beta/memory_stores/delete
4---
5
16# Delete a memory store
27
38**DELETE** `/v1/memory_stores/{memory_store_id}`
from line 21
1621
1722 - `string`
1823
19 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
24 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
2025
2126 - `"message-batches-2024-09-24"`
2227
from line 69
6469
6570 - `"user-profiles-2026-08-18"`
6671
72 - `"user-profiles-2026-09-04"`
73
6774 - `"advisor-tool-2026-03-01"`
6875
6976 - `"managed-agents-2026-04-01"`
from line 113
106113
107114 - `"mid-conversation-system-clear-at-2026-08-21"`
108115
116- `"anthropic-workspace-id": optional string`
117
109118## Returns
110119
111120- `BetaManagedAgentsDeletedMemoryStore object`
from line 121
112121
113122 Confirmation that a `memory_store` was deleted.
114123
124 - `type: "memory_store_deleted"`
125
115126 - `id: string`
116127
117128 ID of the deleted memory store (a `memstore_...` identifier). The store and all its memories and versions are no longer retrievable.
118
119 - `type: "memory_store_deleted"`
120129
121130## Example
122131
api/beta/memory_stores/list Changed · +12 / -3 lines
from line 1
1---
2title: List memory stores
3url: https://platform.claude.com/docs/en/api/beta/memory_stores/list
4---
5
16# List memory stores
27
38**GET** `/v1/memory_stores`
from line 45
4045
4146 - `string`
4247
43 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
48 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
4449
4550 - `"message-batches-2024-09-24"`
4651
from line 93
8893
8994 - `"user-profiles-2026-08-18"`
9095
96 - `"user-profiles-2026-09-04"`
97
9198 - `"advisor-tool-2026-03-01"`
9299
93100 - `"managed-agents-2026-04-01"`
from line 137
130137
131138 - `"mid-conversation-system-clear-at-2026-08-21"`
132139
140- `"anthropic-workspace-id": optional string`
141
133142## Returns
134143
135144- `data: optional array of BetaManagedAgentsMemoryStore`
from line 145
136145
137146 Memory stores on this page, newest first. Empty when there are no stores matching the filters.
138147
148 - `type: "memory_store"`
149
139150 - `id: string`
140151
141152 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 160
149160 - `name: string`
150161
151162 Human-readable name for the store. 1–255 characters. The store's mount-path slug under `/mnt/memory/` is derived from this name.
152
153 - `type: "memory_store"`
154163
155164 - `updated_at: string`
156165
api/beta/memory_stores/memories Changed · +88 / -63 lines
from line 1
1---
2title: Memories
3url: https://platform.claude.com/docs/en/api/beta/memory_stores/memories
4---
5
16# Memories
27
38## Create a memory
from line 33
2833
2934 - `string`
3035
31 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
36 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
3237
3338 - `"message-batches-2024-09-24"`
3439
from line 81
7681
7782 - `"user-profiles-2026-08-18"`
7883
84 - `"user-profiles-2026-09-04"`
85
7986 - `"advisor-tool-2026-03-01"`
8087
8188 - `"managed-agents-2026-04-01"`
from line 125
118125
119126 - `"mid-conversation-system-clear-at-2026-08-21"`
120127
128- `"anthropic-workspace-id": optional string`
129
121130### Body parameters
122131
123132- `content: string or null`
from line 145
136145
137146 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.
138147
148 - `type: "memory"`
149
139150 - `id: string`
140151
141152 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 179
168179
169180 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.
170181
171 - `type: "memory"`
172
173182 - `updated_at: string`
174183
175184 A timestamp in RFC 3339 format
from line 268
259268
260269 - `string`
261270
262 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
271 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
263272
264273 - `"message-batches-2024-09-24"`
265274
from line 316
307316
308317 - `"user-profiles-2026-08-18"`
309318
319 - `"user-profiles-2026-09-04"`
320
310321 - `"advisor-tool-2026-03-01"`
311322
312323 - `"managed-agents-2026-04-01"`
from line 360
349360
350361 - `"mid-conversation-system-clear-at-2026-08-21"`
351362
363- `"anthropic-workspace-id": optional string`
364
352365### Returns
353366
354367- `data: optional array of BetaManagedAgentsMemoryListItem`
from line 372
359372
360373 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.
361374
375 - `type: "memory"`
376
362377 - `id: string`
363378
364379 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 406
391406
392407 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.
393408
394 - `type: "memory"`
395
396409 - `updated_at: string`
397410
398411 A timestamp in RFC 3339 format
from line 420
407420
408421 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.
409422
423 - `type: "memory_prefix"`
424
410425 - `path: string`
411426
412427 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.
413428
414 - `type: "memory_prefix"`
415
416429- `next_page: optional string or null`
417430
418431 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 491
478491
479492 - `string`
480493
481 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
494 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
482495
483496 - `"message-batches-2024-09-24"`
484497
from line 539
526539
527540 - `"user-profiles-2026-08-18"`
528541
542 - `"user-profiles-2026-09-04"`
543
529544 - `"advisor-tool-2026-03-01"`
530545
531546 - `"managed-agents-2026-04-01"`
from line 583
568583
569584 - `"mid-conversation-system-clear-at-2026-08-21"`
570585
586- `"anthropic-workspace-id": optional string`
587
571588### Returns
572589
573590- `BetaManagedAgentsMemory object`
from line 591
574591
575592 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.
576593
594 - `type: "memory"`
595
577596 - `id: string`
578597
579598 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 625
606625
607626 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.
608627
609 - `type: "memory"`
610
611628 - `updated_at: string`
612629
613630 A timestamp in RFC 3339 format
from line 691
674691
675692 - `string`
676693
677 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
694 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
678695
679696 - `"message-batches-2024-09-24"`
680697
from line 739
722739
723740 - `"user-profiles-2026-08-18"`
724741
742 - `"user-profiles-2026-09-04"`
743
725744 - `"advisor-tool-2026-03-01"`
726745
727746 - `"managed-agents-2026-04-01"`
from line 783
764783
765784 - `"mid-conversation-system-clear-at-2026-08-21"`
766785
786- `"anthropic-workspace-id": optional string`
787
767788### Body parameters
768789
769790- `content: optional string or null`
from line 813
792813
793814 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.
794815
816 - `type: "memory"`
817
795818 - `id: string`
796819
797820 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 847
824847
825848 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.
826849
827 - `type: "memory"`
828
829850 - `updated_at: string`
830851
831852 A timestamp in RFC 3339 format
from line 911
890911
891912 - `string`
892913
893 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
914 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
894915
895916 - `"message-batches-2024-09-24"`
896917
from line 959
938959
939960 - `"user-profiles-2026-08-18"`
940961
962 - `"user-profiles-2026-09-04"`
963
941964 - `"advisor-tool-2026-03-01"`
942965
943966 - `"managed-agents-2026-04-01"`
from line 1003
9801003
9811004 - `"mid-conversation-system-clear-at-2026-08-21"`
9821005
1006- `"anthropic-workspace-id": optional string`
1007
9831008### Returns
9841009
9851010- `BetaManagedAgentsDeletedMemory object`
from line 1011
9861011
9871012 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).
9881013
1014 - `type: "memory_deleted"`
1015
9891016 - `id: string`
9901017
9911018 ID of the deleted memory (a `mem_...` value).
9921019
993 - `type: "memory_deleted"`
994
9951020### Example
9961021
9971022```bash
from line 1064
10391064
10401065 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).
10411066
1067 - `type: "memory_deleted"`
1068
10421069 - `id: string`
10431070
10441071 ID of the deleted memory (a `mem_...` value).
10451072
1046 - `type: "memory_deleted"`
1047
10481073### Beta Managed Agents Error
10491074
10501075- `BetaManagedAgentsError = BetaInvalidRequestError or BetaAuthenticationError or BetaBillingError or 9 more`
from line 1076
10511076
10521077 - `BetaInvalidRequestError object`
10531078
1054 - `message: string`
1055
1056 default: Invalid request
1057
10581079 - `type: "invalid_request_error"`
10591080
10601081 default: invalid_request_error
10611082
1062 - `BetaAuthenticationError object`
1063
10641083 - `message: string`
10651084
1066 default: Authentication error
1085 default: Invalid request
10671086
1087 - `BetaAuthenticationError object`
1088
10681089 - `type: "authentication_error"`
10691090
10701091 default: authentication_error
10711092
1072 - `BetaBillingError object`
1073
10741093 - `message: string`
10751094
1076 default: Billing error
1095 default: Authentication error
10771096
1097 - `BetaBillingError object`
1098
10781099 - `type: "billing_error"`
10791100
10801101 default: billing_error
10811102
1082 - `BetaPermissionError object`
1083
10841103 - `message: string`
10851104
1086 default: Permission denied
1105 default: Billing error
10871106
1107 - `BetaPermissionError object`
1108
10881109 - `type: "permission_error"`
10891110
10901111 default: permission_error
10911112
1092 - `BetaNotFoundError object`
1093
10941113 - `message: string`
10951114
1096 default: Not found
1115 default: Permission denied
10971116
1117 - `BetaNotFoundError object`
1118
10981119 - `type: "not_found_error"`
10991120
11001121 default: not_found_error
11011122
1102 - `BetaRateLimitError object`
1103
11041123 - `message: string`
11051124
1106 default: Rate limited
1125 default: Not found
11071126
1127 - `BetaRateLimitError object`
1128
11081129 - `type: "rate_limit_error"`
11091130
11101131 default: rate_limit_error
11111132
1112 - `BetaGatewayTimeoutError object`
1113
11141133 - `message: string`
11151134
1116 default: Request timeout
1135 default: Rate limited
11171136
1137 - `BetaGatewayTimeoutError object`
1138
11181139 - `type: "timeout_error"`
11191140
11201141 default: timeout_error
11211142
1122 - `BetaAPIError object`
1123
11241143 - `message: string`
11251144
1126 default: Internal server error
1145 default: Request timeout
11271146
1147 - `BetaAPIError object`
1148
11281149 - `type: "api_error"`
11291150
11301151 default: api_error
11311152
1132 - `BetaOverloadedError object`
1133
11341153 - `message: string`
11351154
1136 default: Overloaded
1155 default: Internal server error
11371156
1157 - `BetaOverloadedError object`
1158
11381159 - `type: "overloaded_error"`
11391160
11401161 default: overloaded_error
11411162
1163 - `message: string`
1164
1165 default: Overloaded
1166
11421167 - `BetaManagedAgentsMemoryPreconditionFailedError object`
11431168
11441169 - `type: "memory_precondition_failed_error"`
from line 1192
11671192
11681193 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.
11691194
1195 - `type: "memory"`
1196
11701197 - `id: string`
11711198
11721199 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 1226
11991226
12001227 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.
12011228
1202 - `type: "memory"`
1203
12041229 - `updated_at: string`
12051230
12061231 A timestamp in RFC 3339 format
from line 1246
12211246
12221247 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.
12231248
1249 - `type: "memory"`
1250
12241251 - `id: string`
12251252
12261253 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 1280
12531280
12541281 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.
12551282
1256 - `type: "memory"`
1257
12581283 - `updated_at: string`
12591284
12601285 A timestamp in RFC 3339 format
from line 1294
12691294
12701295 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.
12711296
1297 - `type: "memory_prefix"`
1298
12721299 - `path: string`
12731300
12741301 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.
12751302
1276 - `type: "memory_prefix"`
1277
12781303### Beta Managed Agents Memory Path Conflict Error
12791304
12801305- `BetaManagedAgentsMemoryPathConflictError object`
from line 1326
13011326
13021327 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.
13031328
1329 - `type: "memory_prefix"`
1330
13041331 - `path: string`
13051332
13061333 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.
1307
1308 - `type: "memory_prefix"`
13091334
13101335### Beta Managed Agents Memory View
13111336
api/beta/memory_stores/memories/create Changed · +12 / -3 lines
from line 1
1---
2title: Create a memory
3url: https://platform.claude.com/docs/en/api/beta/memory_stores/memories/create
4---
5
16# Create a memory
27
38**POST** `/v1/memory_stores/{memory_store_id}/memories`
from line 31
2631
2732 - `string`
2833
29 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
34 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
3035
3136 - `"message-batches-2024-09-24"`
3237
from line 79
7479
7580 - `"user-profiles-2026-08-18"`
7681
82 - `"user-profiles-2026-09-04"`
83
7784 - `"advisor-tool-2026-03-01"`
7885
7986 - `"managed-agents-2026-04-01"`
from line 123
116123
117124 - `"mid-conversation-system-clear-at-2026-08-21"`
118125
126- `"anthropic-workspace-id": optional string`
127
119128## Body parameters
120129
121130- `content: string or null`
from line 143
134143
135144 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.
136145
146 - `type: "memory"`
147
137148 - `id: string`
138149
139150 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 176
165176 - `path: string`
166177
167178 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.
168
169 - `type: "memory"`
170179
171180 - `updated_at: string`
172181
api/beta/memory_stores/memories/delete Changed · +12 / -3 lines
from line 1
1---
2title: Delete a memory
3url: https://platform.claude.com/docs/en/api/beta/memory_stores/memories/delete
4---
5
16# Delete a memory
27
38**DELETE** `/v1/memory_stores/{memory_store_id}/memories/{memory_id}`
from line 29
2429
2530 - `string`
2631
27 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
32 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
2833
2934 - `"message-batches-2024-09-24"`
3035
from line 77
7277
7378 - `"user-profiles-2026-08-18"`
7479
80 - `"user-profiles-2026-09-04"`
81
7582 - `"advisor-tool-2026-03-01"`
7683
7784 - `"managed-agents-2026-04-01"`
from line 121
114121
115122 - `"mid-conversation-system-clear-at-2026-08-21"`
116123
124- `"anthropic-workspace-id": optional string`
125
117126## Returns
118127
119128- `BetaManagedAgentsDeletedMemory object`
from line 129
120129
121130 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).
122131
132 - `type: "memory_deleted"`
133
123134 - `id: string`
124135
125136 ID of the deleted memory (a `mem_...` value).
126
127 - `type: "memory_deleted"`
128137
129138## Example
130139
api/beta/memory_stores/memories/list Changed · +14 / -5 lines
from line 1
1---
2title: List memories
3url: https://platform.claude.com/docs/en/api/beta/memory_stores/memories/list
4---
5
16# List memories
27
38**GET** `/v1/memory_stores/{memory_store_id}/memories`
from line 51
4651
4752 - `string`
4853
49 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
54 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
5055
5156 - `"message-batches-2024-09-24"`
5257
from line 99
9499
95100 - `"user-profiles-2026-08-18"`
96101
102 - `"user-profiles-2026-09-04"`
103
97104 - `"advisor-tool-2026-03-01"`
98105
99106 - `"managed-agents-2026-04-01"`
from line 143
136143
137144 - `"mid-conversation-system-clear-at-2026-08-21"`
138145
146- `"anthropic-workspace-id": optional string`
147
139148## Returns
140149
141150- `data: optional array of BetaManagedAgentsMemoryListItem`
from line 155
146155
147156 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.
148157
158 - `type: "memory"`
159
149160 - `id: string`
150161
151162 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 189
178189
179190 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.
180191
181 - `type: "memory"`
182
183192 - `updated_at: string`
184193
185194 A timestamp in RFC 3339 format
from line 203
194203
195204 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.
196205
206 - `type: "memory_prefix"`
207
197208 - `path: string`
198209
199210 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.
200
201 - `type: "memory_prefix"`
202211
203212- `next_page: optional string or null`
204213
api/beta/memory_stores/memories/retrieve Changed · +12 / -3 lines
from line 1
1---
2title: Retrieve a memory
3url: https://platform.claude.com/docs/en/api/beta/memory_stores/memories/retrieve
4---
5
16# Retrieve a memory
27
38**GET** `/v1/memory_stores/{memory_store_id}/memories/{memory_id}`
from line 33
2833
2934 - `string`
3035
31 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
36 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
3237
3338 - `"message-batches-2024-09-24"`
3439
from line 81
7681
7782 - `"user-profiles-2026-08-18"`
7883
84 - `"user-profiles-2026-09-04"`
85
7986 - `"advisor-tool-2026-03-01"`
8087
8188 - `"managed-agents-2026-04-01"`
from line 125
118125
119126 - `"mid-conversation-system-clear-at-2026-08-21"`
120127
128- `"anthropic-workspace-id": optional string`
129
121130## Returns
122131
123132- `BetaManagedAgentsMemory object`
from line 133
124133
125134 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.
126135
136 - `type: "memory"`
137
127138 - `id: string`
128139
129140 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 166
155166 - `path: string`
156167
157168 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.
158
159 - `type: "memory"`
160169
161170 - `updated_at: string`
162171
api/beta/memory_stores/memories/update Changed · +12 / -3 lines
from line 1
1---
2title: Update a memory
3url: https://platform.claude.com/docs/en/api/beta/memory_stores/memories/update
4---
5
16# Update a memory
27
38**POST** `/v1/memory_stores/{memory_store_id}/memories/{memory_id}`
from line 33
2833
2934 - `string`
3035
31 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
36 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
3237
3338 - `"message-batches-2024-09-24"`
3439
from line 81
7681
7782 - `"user-profiles-2026-08-18"`
7883
84 - `"user-profiles-2026-09-04"`
85
7986 - `"advisor-tool-2026-03-01"`
8087
8188 - `"managed-agents-2026-04-01"`
from line 125
118125
119126 - `"mid-conversation-system-clear-at-2026-08-21"`
120127
128- `"anthropic-workspace-id": optional string`
129
121130## Body parameters
122131
123132- `content: optional string or null`
from line 155
146155
147156 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.
148157
158 - `type: "memory"`
159
149160 - `id: string`
150161
151162 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 188
177188 - `path: string`
178189
179190 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.
180
181 - `type: "memory"`
182191
183192 - `updated_at: string`
184193
api/beta/memory_stores/memory_versions Changed · +87 / -70 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
api/beta/memory_stores/memory_versions/list Changed · +21 / -12 lines
from line 1
1---
2title: List memory versions
3url: https://platform.claude.com/docs/en/api/beta/memory_stores/memory_versions/list
4---
5
16# List memory versions
27
38**GET** `/v1/memory_stores/{memory_store_id}/memory_versions`
from line 79
7479
7580 - `string`
7681
77 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
82 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
7883
7984 - `"message-batches-2024-09-24"`
8085
from line 127
122127
123128 - `"user-profiles-2026-08-18"`
124129
130 - `"user-profiles-2026-09-04"`
131
125132 - `"advisor-tool-2026-03-01"`
126133
127134 - `"managed-agents-2026-04-01"`
from line 171
164171
165172 - `"mid-conversation-system-clear-at-2026-08-21"`
166173
174- `"anthropic-workspace-id": optional string`
175
167176## Returns
168177
169178- `data: optional array of BetaManagedAgentsMemoryVersion`
from line 179
170179
171180 One page of `memory_version` objects, ordered by `created_at` descending (newest first), with `id` as tiebreak.
172181
182 - `type: "memory_version"`
183
173184 - `id: string`
174185
175186 Unique identifier for this version (a `memver_...` value).
from line 209
198209
199210 - `"deleted"`
200211
201 - `type: "memory_version"`
202
203212 - `content: optional string or null`
204213
205214 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 225
216225
217226 - `created_by: optional BetaManagedAgentsActor`
218227
219 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).
228 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).
220229
221230 - `BetaManagedAgentsSessionActor object`
222231
223232 Attribution for a write made by an agent during a session, through the mounted filesystem at `/mnt/memory/`.
224233
234 - `type: "session_actor"`
235
225236 - `session_id: string`
226237
227 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.
238 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.
228239
229240 minLength: 1
230241
231 - `type: "session_actor"`
232
233242 - `BetaManagedAgentsAPIActor object`
234243
235244 Attribution for a write made directly via the public API (outside of any session).
236245
246 - `type: "api_actor"`
247
237248 - `api_key_id: string`
238249
239250 ID of the API key that performed the write. This identifies the key, not the secret.
from line 251
240251
241252 minLength: 1
242253
243 - `type: "api_actor"`
244
245254 - `BetaManagedAgentsUserActor object`
246255
247256 Attribution for a write made by a human user through the Anthropic Console.
from line 267
258267
259268 Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation.
260269
270 - `type: "service_account_actor"`
271
261272 - `service_account_id: string`
262273
263274 ID of the service account that performed the write (a `svac_...` value).
from line 275
264275
265276 minLength: 1
266277
267 - `type: "service_account_actor"`
268
269278 - `path: optional string or null`
270279
271280 The memory's path at the time of this write. `null` if and only if `redacted_at` is set.
from line 287
278287
279288 - `redacted_by: optional BetaManagedAgentsActor`
280289
281 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).
290 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).
282291
283292- `next_page: optional string or null`
284293
api/beta/memory_stores/memory_versions/redact Changed · +23 / -14 lines
from line 1
1---
2title: Redact a memory version
3url: https://platform.claude.com/docs/en/api/beta/memory_stores/memory_versions/redact
4---
5
16# Redact a memory version
27
38**POST** `/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}/redact`
from line 23
1823
1924 - `string`
2025
21 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
26 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
2227
2328 - `"message-batches-2024-09-24"`
2429
from line 71
6671
6772 - `"user-profiles-2026-08-18"`
6873
74 - `"user-profiles-2026-09-04"`
75
6976 - `"advisor-tool-2026-03-01"`
7077
7178 - `"managed-agents-2026-04-01"`
from line 115
108115
109116 - `"mid-conversation-system-clear-at-2026-08-21"`
110117
118- `"anthropic-workspace-id": optional string`
119
111120## Returns
112121
113122- `BetaManagedAgentsMemoryVersion object`
from line 123
114123
115124 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.
116125
126 - `type: "memory_version"`
127
117128 - `id: string`
118129
119130 Unique identifier for this version (a `memver_...` value).
from line 153
142153
143154 - `"deleted"`
144155
145 - `type: "memory_version"`
146
147156 - `content: optional string or null`
148157
149158 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 169
160169
161170 - `created_by: optional BetaManagedAgentsActor`
162171
163 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).
172 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).
164173
165174 - `BetaManagedAgentsSessionActor object`
166175
167176 Attribution for a write made by an agent during a session, through the mounted filesystem at `/mnt/memory/`.
168177
178 - `type: "session_actor"`
179
169180 - `session_id: string`
170181
171 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.
182 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.
172183
173184 minLength: 1
174185
175 - `type: "session_actor"`
176
177186 - `BetaManagedAgentsAPIActor object`
178187
179188 Attribution for a write made directly via the public API (outside of any session).
180189
190 - `type: "api_actor"`
191
181192 - `api_key_id: string`
182193
183194 ID of the API key that performed the write. This identifies the key, not the secret.
from line 195
184195
185196 minLength: 1
186197
187 - `type: "api_actor"`
188
189198 - `BetaManagedAgentsUserActor object`
190199
191200 Attribution for a write made by a human user through the Anthropic Console.
from line 211
202211
203212 Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation.
204213
214 - `type: "service_account_actor"`
215
205216 - `service_account_id: string`
206217
207218 ID of the service account that performed the write (a `svac_...` value).
from line 219
208219
209220 minLength: 1
210221
211 - `type: "service_account_actor"`
212
213222 - `path: optional string or null`
214223
215224 The memory's path at the time of this write. `null` if and only if `redacted_at` is set.
from line 231
222231
223232 - `redacted_by: optional BetaManagedAgentsActor`
224233
225 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).
234 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).
226235
227236## Example
228237
api/beta/memory_stores/memory_versions/retrieve Changed · +23 / -14 lines
from line 1
1---
2title: Retrieve a memory version
3url: https://platform.claude.com/docs/en/api/beta/memory_stores/memory_versions/retrieve
4---
5
16# Retrieve a memory version
27
38**GET** `/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}`
from line 33
2833
2934 - `string`
3035
31 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
36 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
3237
3338 - `"message-batches-2024-09-24"`
3439
from line 81
7681
7782 - `"user-profiles-2026-08-18"`
7883
84 - `"user-profiles-2026-09-04"`
85
7986 - `"advisor-tool-2026-03-01"`
8087
8188 - `"managed-agents-2026-04-01"`
from line 125
118125
119126 - `"mid-conversation-system-clear-at-2026-08-21"`
120127
128- `"anthropic-workspace-id": optional string`
129
121130## Returns
122131
123132- `BetaManagedAgentsMemoryVersion object`
from line 133
124133
125134 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.
126135
136 - `type: "memory_version"`
137
127138 - `id: string`
128139
129140 Unique identifier for this version (a `memver_...` value).
from line 163
152163
153164 - `"deleted"`
154165
155 - `type: "memory_version"`
156
157166 - `content: optional string or null`
158167
159168 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 179
170179
171180 - `created_by: optional BetaManagedAgentsActor`
172181
173 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).
182 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).
174183
175184 - `BetaManagedAgentsSessionActor object`
176185
177186 Attribution for a write made by an agent during a session, through the mounted filesystem at `/mnt/memory/`.
178187
188 - `type: "session_actor"`
189
179190 - `session_id: string`
180191
181 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.
192 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.
182193
183194 minLength: 1
184195
185 - `type: "session_actor"`
186
187196 - `BetaManagedAgentsAPIActor object`
188197
189198 Attribution for a write made directly via the public API (outside of any session).
190199
200 - `type: "api_actor"`
201
191202 - `api_key_id: string`
192203
193204 ID of the API key that performed the write. This identifies the key, not the secret.
from line 205
194205
195206 minLength: 1
196207
197 - `type: "api_actor"`
198
199208 - `BetaManagedAgentsUserActor object`
200209
201210 Attribution for a write made by a human user through the Anthropic Console.
from line 221
212221
213222 Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation.
214223
224 - `type: "service_account_actor"`
225
215226 - `service_account_id: string`
216227
217228 ID of the service account that performed the write (a `svac_...` value).
from line 229
218229
219230 minLength: 1
220231
221 - `type: "service_account_actor"`
222
223232 - `path: optional string or null`
224233
225234 The memory's path at the time of this write. `null` if and only if `redacted_at` is set.
from line 241
232241
233242 - `redacted_by: optional BetaManagedAgentsActor`
234243
235 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).
244 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).
236245
237246## Example
238247
api/beta/memory_stores/retrieve Changed · +12 / -3 lines
from line 1
1---
2title: Retrieve a memory store
3url: https://platform.claude.com/docs/en/api/beta/memory_stores/retrieve
4---
5
16# Retrieve a memory store
27
38**GET** `/v1/memory_stores/{memory_store_id}`
from line 21
1621
1722 - `string`
1823
19 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
24 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
2025
2126 - `"message-batches-2024-09-24"`
2227
from line 69
6469
6570 - `"user-profiles-2026-08-18"`
6671
72 - `"user-profiles-2026-09-04"`
73
6774 - `"advisor-tool-2026-03-01"`
6875
6976 - `"managed-agents-2026-04-01"`
from line 113
106113
107114 - `"mid-conversation-system-clear-at-2026-08-21"`
108115
116- `"anthropic-workspace-id": optional string`
117
109118## Returns
110119
111120- `BetaManagedAgentsMemoryStore object`
from line 121
112121
113122 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.
114123
124 - `type: "memory_store"`
125
115126 - `id: string`
116127
117128 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 136
125136 - `name: string`
126137
127138 Human-readable name for the store. 1–255 characters. The store's mount-path slug under `/mnt/memory/` is derived from this name.
128
129 - `type: "memory_store"`
130139
131140 - `updated_at: string`
132141
api/beta/memory_stores/update Changed · +12 / -3 lines
from line 1
1---
2title: Update a memory store
3url: https://platform.claude.com/docs/en/api/beta/memory_stores/update
4---
5
16# Update a memory store
27
38**POST** `/v1/memory_stores/{memory_store_id}`
from line 21
1621
1722 - `string`
1823
19 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
24 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
2025
2126 - `"message-batches-2024-09-24"`
2227
from line 69
6469
6570 - `"user-profiles-2026-08-18"`
6671
72 - `"user-profiles-2026-09-04"`
73
6774 - `"advisor-tool-2026-03-01"`
6875
6976 - `"managed-agents-2026-04-01"`
from line 113
106113
107114 - `"mid-conversation-system-clear-at-2026-08-21"`
108115
116- `"anthropic-workspace-id": optional string`
117
109118## Body parameters
110119
111120- `description: optional string or null`
from line 139
130139
131140 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.
132141
142 - `type: "memory_store"`
143
133144 - `id: string`
134145
135146 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 154
143154 - `name: string`
144155
145156 Human-readable name for the store. 1–255 characters. The store's mount-path slug under `/mnt/memory/` is derived from this name.
146
147 - `type: "memory_store"`
148157
149158 - `updated_at: string`
150159
api/beta/messages Changed · +8591 / -8520 lines
This page is larger than the 256 KiB this site keeps, so one side of the diff below stops where the stored text does.
Nothing in the body moved in this read. What changed is above.