One read of Claude Developer Platformapi-20260825T033708Z
377 pages moved out of 612 read.
Pages moved
377
significant first
Pages read
612
in this capture
Captured
03:37 UTC
Corpus hash
7d98cae5bb87
corpus-hash
What this read moved
176-200 of 377, page 8 of 16This capture is too large to show at once. Changes 176-200 of 377 are below, significant first; the rest are on the following screens.
api/beta/environments/work/update Changed · +15 / -22 lines
# Update Work Item ## Path parameters ## Headers ## Body parameters ## Returns ## Example ### Response (200) ## Update Work Item ### Path Parameters ### Header Parameters ### Body Parameters ### Returns ### Example #### Response
from line 1
1---
2title: Update Work Item
3url: https://platform.claude.com/docs/en/api/beta/environments/work/update
4---
1# Update Work Item
52
6## Update Work Item
3**POST** `/v1/environments/{environment_id}/work/{work_id}`
74
8**post** `/v1/environments/{environment_id}/work/{work_id}`
9
105Note: these endpoints are called automatically by the pre-built environment worker provided in the SDKs and CLI, for orchestrating sessions with self-hosted sandbox environments. They are included here as a reference; you do not need to invoke them directly.
116
127Update work item metadata with merge semantics.
138
14### Path Parameters
9## Path parameters
1510
1611- `environment_id: string`
1712
1813- `work_id: string`
1914
20### Header Parameters
15## Headers
2116
2217- `"anthropic-beta": optional array of AnthropicBeta`
2318
from line 90
9590
9691 - `"mid-conversation-tool-changes-2026-07-01"`
9792
98### Body Parameters
93## Body parameters
9994
10095- `metadata: map[string]`
10196
10297 Metadata patch. Set a key to a string to upsert it, or to null to delete it. Omit the field to preserve existing metadata.
10398
104### Returns
99## Returns
105100
106- `BetaSelfHostedWork object { id, acknowledged_at, created_at, 10 more }`
101- `BetaSelfHostedWork object`
107102
108103 Work resource representing a unit of work in a self-hosted environment.
109104
from line 130
135130
136131 Type of work data
137132
138 - `"session"`
139
140133 - `environment_id: string`
141134
142135 Environment identifier this work belongs to (e.g., `env_...`)
from line 176
183176
184177 The type of object (always 'work')
185178
186 - `"work"`
179 default: work
187180
188### Example
181## Example
189182
190```http
183```bash
191184curl https://api.anthropic.com/v1/environments/$ENVIRONMENT_ID/work/$WORK_ID \
192185 -H 'Content-Type: application/json' \
193186 -H 'anthropic-version: 2023-06-01' \
from line 193
200193 }'
201194```
202195
203#### Response
196### Response (200)
204197
205198```json
206199{
api/beta/files Changed · +84 / -55 lines
### Headers ### Body parameters (form-data) #### Response (200) ### Query parameters ### Headers #### Response (200) ### Path parameters ### Headers ### Path parameters ### Headers #### Response (200) ### Path parameters ### Headers #### Response (200) ## Domain types ### Header Parameters #### Response ### Query Parameters ### Header Parameters #### Response ### Path Parameters ### Header Parameters ### Path Parameters ### Header Parameters #### Response ### Path Parameters ### Header Parameters #### Response ## Domain Types
from line 1
1---
2title: Files
3url: https://platform.claude.com/docs/en/api/beta/files
4---
5
61# Files
72
83## Upload File
94
10**post** `/v1/files`
5**POST** `/v1/files`
116
127Upload File
138
14### Header Parameters
9### Headers
1510
1611- `"anthropic-beta": optional array of AnthropicBeta`
1712
from line 84
8984
9085 - `"mid-conversation-tool-changes-2026-07-01"`
9186
87### Body parameters (form-data)
88
89- `file: string`
90
91 The file to upload
92
93 format: binary
94
9295### Returns
9396
94- `BetaFileMetadata object { id, created_at, filename, 5 more }`
97- `BetaFileMetadata object`
9598
9699 - `id: string`
97100
from line 106
103106
104107 RFC 3339 datetime string representing when the file was created.
105108
109 format: date-time
110
106111 - `filename: string`
107112
108113 Original filename of the uploaded file.
109114
115 maxLength: 500, minLength: 1
116
110117 - `mime_type: string`
111118
112119 MIME type of the file.
113120
121 maxLength: 255, minLength: 1
122
114123 - `size_bytes: number`
115124
116125 Size of the file in bytes.
117126
127 minimum: 0
128
118129 - `type: "file"`
119130
120131 Object type.
from line 132
121132
122133 For files, this is always `"file"`.
123134
124 - `"file"`
125
126135 - `downloadable: optional boolean`
127136
128137 Whether the file can be downloaded.
129138
139 default: false
140
130141 - `scope: optional BetaFileScope or null`
131142
132143 The scope of this file, indicating the context in which it was created (e.g., a session).
from line 150
139150
140151 The type of scope (e.g., `"session"`).
141152
142 - `"session"`
143
144153### Example
145154
146```http
155```bash
147156curl https://api.anthropic.com/v1/files \
148157 -H 'Content-Type: multipart/form-data' \
149158 -H 'anthropic-version: 2023-06-01' \
from line 161
152161 -F 'file=@/path/to/file'
153162```
154163
155#### Response
164#### Response (200)
156165
157166```json
158167{
from line 181
172181
173182## List Files
174183
175**get** `/v1/files`
184**GET** `/v1/files`
176185
177186List Files
178187
179### Query Parameters
188### Query parameters
180189
181190- `after_id: optional string`
182191
from line 201
192201
193202 Defaults to `20`. Ranges from `1` to `1000`.
194203
204 default: 20, maximum: 1000, minimum: 1
205
195206- `scope_id: optional string`
196207
197208 Filter by scope ID. Only returns files associated with the specified scope (e.g., a session ID).
198209
199### Header Parameters
210### Headers
200211
201212- `"anthropic-beta": optional array of AnthropicBeta`
202213
from line 301
290301
291302 RFC 3339 datetime string representing when the file was created.
292303
304 format: date-time
305
293306 - `filename: string`
294307
295308 Original filename of the uploaded file.
296309
310 maxLength: 500, minLength: 1
311
297312 - `mime_type: string`
298313
299314 MIME type of the file.
300315
316 maxLength: 255, minLength: 1
317
301318 - `size_bytes: number`
302319
303320 Size of the file in bytes.
304321
322 minimum: 0
323
305324 - `type: "file"`
306325
307326 Object type.
from line 327
308327
309328 For files, this is always `"file"`.
310329
311 - `"file"`
312
313330 - `downloadable: optional boolean`
314331
315332 Whether the file can be downloaded.
316333
334 default: false
335
317336 - `scope: optional BetaFileScope or null`
318337
319338 The scope of this file, indicating the context in which it was created (e.g., a session).
from line 345
326345
327346 The type of scope (e.g., `"session"`).
328347
329 - `"session"`
330
331348- `first_id: optional string or null`
332349
333350 ID of the first file in this page of results.
from line 353
336353
337354 Whether there are more results available.
338355
356 default: false
357
339358- `last_id: optional string or null`
340359
341360 ID of the last file in this page of results.
from line 361
342361
343362### Example
344363
345```http
364```bash
346365curl https://api.anthropic.com/v1/files \
347366 -H 'anthropic-version: 2023-06-01' \
348367 -H 'anthropic-beta: files-api-2025-04-14' \
from line 368
349368 -H "X-Api-Key: $ANTHROPIC_API_KEY"
350369```
351370
352#### Response
371#### Response (200)
353372
354373```json
355374{
from line 395
376395
377396## Download File
378397
379**get** `/v1/files/{file_id}/content`
398**GET** `/v1/files/{file_id}/content`
380399
381400Download File
382401
383### Path Parameters
402### Path parameters
384403
385404- `file_id: string`
386405
387406 ID of the File.
388407
389### Header Parameters
408### Headers
390409
391410- `"anthropic-beta": optional array of AnthropicBeta`
392411
from line 485
466485
467486### Example
468487
469```http
488```bash
470489curl https://api.anthropic.com/v1/files/$FILE_ID/content \
471490 -H 'anthropic-version: 2023-06-01' \
472491 -H 'anthropic-beta: files-api-2025-04-14' \
from line 494
475494
476495## Get File Metadata
477496
478**get** `/v1/files/{file_id}`
497**GET** `/v1/files/{file_id}`
479498
480499Get File Metadata
481500
482### Path Parameters
501### Path parameters
483502
484503- `file_id: string`
485504
486505 ID of the File.
487506
488### Header Parameters
507### Headers
489508
490509- `"anthropic-beta": optional array of AnthropicBeta`
491510
from line 584
565584
566585### Returns
567586
568- `BetaFileMetadata object { id, created_at, filename, 5 more }`
587- `BetaFileMetadata object`
569588
570589 - `id: string`
571590
from line 596
577596
578597 RFC 3339 datetime string representing when the file was created.
579598
599 format: date-time
600
580601 - `filename: string`
581602
582603 Original filename of the uploaded file.
583604
605 maxLength: 500, minLength: 1
606
584607 - `mime_type: string`
585608
586609 MIME type of the file.
587610
611 maxLength: 255, minLength: 1
612
588613 - `size_bytes: number`
589614
590615 Size of the file in bytes.
591616
617 minimum: 0
618
592619 - `type: "file"`
593620
594621 Object type.
from line 622
595622
596623 For files, this is always `"file"`.
597624
598 - `"file"`
599
600625 - `downloadable: optional boolean`
601626
602627 Whether the file can be downloaded.
603628
629 default: false
630
604631 - `scope: optional BetaFileScope or null`
605632
606633 The scope of this file, indicating the context in which it was created (e.g., a session).
from line 640
613640
614641 The type of scope (e.g., `"session"`).
615642
616 - `"session"`
617
618643### Example
619644
620```http
645```bash
621646curl https://api.anthropic.com/v1/files/$FILE_ID \
622647 -H 'anthropic-version: 2023-06-01' \
623648 -H 'anthropic-beta: files-api-2025-04-14' \
from line 649
624649 -H "X-Api-Key: $ANTHROPIC_API_KEY"
625650```
626651
627#### Response
652#### Response (200)
628653
629654```json
630655{
from line 669
644669
645670## Delete File
646671
647**delete** `/v1/files/{file_id}`
672**DELETE** `/v1/files/{file_id}`
648673
649674Delete File
650675
651### Path Parameters
676### Path parameters
652677
653678- `file_id: string`
654679
655680 ID of the File.
656681
657### Header Parameters
682### Headers
658683
659684- `"anthropic-beta": optional array of AnthropicBeta`
660685
from line 759
734759
735760### Returns
736761
737- `BetaDeletedFile object { id, type }`
762- `BetaDeletedFile object`
738763
739764 - `id: string`
740765
from line 771
746771
747772 For file deletion, this is always `"file_deleted"`.
748773
749 - `"file_deleted"`
774 default: file_deleted
750775
751776### Example
752777
753```http
778```bash
754779curl https://api.anthropic.com/v1/files/$FILE_ID \
755780 -X DELETE \
756781 -H 'anthropic-version: 2023-06-01' \
from line 783
758783 -H "X-Api-Key: $ANTHROPIC_API_KEY"
759784```
760785
761#### Response
786#### Response (200)
762787
763788```json
764789{
from line 792
767792}
768793```
769794
770## Domain Types
795## Domain types
771796
772797### Beta Deleted File
773798
774- `BetaDeletedFile object { id, type }`
799- `BetaDeletedFile object`
775800
776801 - `id: string`
777802
from line 808
783808
784809 For file deletion, this is always `"file_deleted"`.
785810
786 - `"file_deleted"`
811 default: file_deleted
787812
788813### Beta File Metadata
789814
790- `BetaFileMetadata object { id, created_at, filename, 5 more }`
815- `BetaFileMetadata object`
791816
792817 - `id: string`
793818
from line 824
799824
800825 RFC 3339 datetime string representing when the file was created.
801826
827 format: date-time
828
802829 - `filename: string`
803830
804831 Original filename of the uploaded file.
805832
833 maxLength: 500, minLength: 1
834
806835 - `mime_type: string`
807836
808837 MIME type of the file.
809838
839 maxLength: 255, minLength: 1
840
810841 - `size_bytes: number`
811842
812843 Size of the file in bytes.
813844
845 minimum: 0
846
814847 - `type: "file"`
815848
816849 Object type.
from line 850
817850
818851 For files, this is always `"file"`.
819852
820 - `"file"`
821
822853 - `downloadable: optional boolean`
823854
824855 Whether the file can be downloaded.
825856
857 default: false
858
826859 - `scope: optional BetaFileScope or null`
827860
828861 The scope of this file, indicating the context in which it was created (e.g., a session).
from line 868
835868
836869 The type of scope (e.g., `"session"`).
837870
838 - `"session"`
839
840871### Beta File Scope
841872
842- `BetaFileScope object { id, type }`
873- `BetaFileScope object`
843874
844875 - `id: string`
845876
from line 879
848879 - `type: "session"`
849880
850881 The type of scope (e.g., `"session"`).
851
852 - `"session"`
853882
api/beta/files/delete Changed · +10 / -15 lines
# Delete File ## Path parameters ## Headers ## Returns ## Example ### Response (200) ## Delete File ### Path Parameters ### Header Parameters ### Returns ### Example #### Response
from line 1
1---
2title: Delete File
3url: https://platform.claude.com/docs/en/api/beta/files/delete
4---
1# Delete File
52
6## Delete File
3**DELETE** `/v1/files/{file_id}`
74
8**delete** `/v1/files/{file_id}`
9
105Delete File
116
12### Path Parameters
7## Path parameters
138
149- `file_id: string`
1510
1611 ID of the File.
1712
18### Header Parameters
13## Headers
1914
2015- `"anthropic-beta": optional array of AnthropicBeta`
2116
from line 88
9388
9489 - `"mid-conversation-tool-changes-2026-07-01"`
9590
96### Returns
91## Returns
9792
98- `BetaDeletedFile object { id, type }`
93- `BetaDeletedFile object`
9994
10095 - `id: string`
10196
from line 102
107102
108103 For file deletion, this is always `"file_deleted"`.
109104
110 - `"file_deleted"`
105 default: file_deleted
111106
112### Example
107## Example
113108
114```http
109```bash
115110curl https://api.anthropic.com/v1/files/$FILE_ID \
116111 -X DELETE \
117112 -H 'anthropic-version: 2023-06-01' \
from line 114
119114 -H "X-Api-Key: $ANTHROPIC_API_KEY"
120115```
121116
122#### Response
117### Response (200)
123118
124119```json
125120{
api/beta/files/download Changed · +6 / -11 lines
# Download File ## Path parameters ## Headers ## Example ## Download File ### Path Parameters ### Header Parameters ### Example
from line 1
1---
2title: Download File
3url: https://platform.claude.com/docs/en/api/beta/files/download
4---
1# Download File
52
6## Download File
3**GET** `/v1/files/{file_id}/content`
74
8**get** `/v1/files/{file_id}/content`
9
105Download File
116
12### Path Parameters
7## Path parameters
138
149- `file_id: string`
1510
1611 ID of the File.
1712
18### Header Parameters
13## Headers
1914
2015- `"anthropic-beta": optional array of AnthropicBeta`
2116
from line 88
9388
9489 - `"mid-conversation-tool-changes-2026-07-01"`
9590
96### Example
91## Example
9792
98```http
93```bash
9994curl https://api.anthropic.com/v1/files/$FILE_ID/content \
10095 -H 'anthropic-version: 2023-06-01' \
10196 -H 'anthropic-beta: files-api-2025-04-14' \
api/beta/files/list Changed · +24 / -19 lines
# List Files ## Query parameters ## Headers ## Returns ## Example ### Response (200) ## List Files ### Query Parameters ### Header Parameters ### Returns ### Example #### Response
from line 1
1---
2title: List Files
3url: https://platform.claude.com/docs/en/api/beta/files/list
4---
1# List Files
52
6## List Files
3**GET** `/v1/files`
74
8**get** `/v1/files`
9
105List Files
116
12### Query Parameters
7## Query parameters
138
149- `after_id: optional string`
1510
from line 20
2520
2621 Defaults to `20`. Ranges from `1` to `1000`.
2722
23 default: 20, maximum: 1000, minimum: 1
24
2825- `scope_id: optional string`
2926
3027 Filter by scope ID. Only returns files associated with the specified scope (e.g., a session ID).
3128
32### Header Parameters
29## Headers
3330
3431- `"anthropic-beta": optional array of AnthropicBeta`
3532
from line 104
107104
108105 - `"mid-conversation-tool-changes-2026-07-01"`
109106
110### Returns
107## Returns
111108
112109- `data: array of BetaFileMetadata`
113110
from line 120
123120
124121 RFC 3339 datetime string representing when the file was created.
125122
123 format: date-time
124
126125 - `filename: string`
127126
128127 Original filename of the uploaded file.
129128
129 maxLength: 500, minLength: 1
130
130131 - `mime_type: string`
131132
132133 MIME type of the file.
133134
135 maxLength: 255, minLength: 1
136
134137 - `size_bytes: number`
135138
136139 Size of the file in bytes.
137140
141 minimum: 0
142
138143 - `type: "file"`
139144
140145 Object type.
from line 146
141146
142147 For files, this is always `"file"`.
143148
144 - `"file"`
145
146149 - `downloadable: optional boolean`
147150
148151 Whether the file can be downloaded.
149152
153 default: false
154
150155 - `scope: optional BetaFileScope or null`
151156
152157 The scope of this file, indicating the context in which it was created (e.g., a session).
from line 164
159164
160165 The type of scope (e.g., `"session"`).
161166
162 - `"session"`
163
164167- `first_id: optional string or null`
165168
166169 ID of the first file in this page of results.
from line 172
169172
170173 Whether there are more results available.
171174
175 default: false
176
172177- `last_id: optional string or null`
173178
174179 ID of the last file in this page of results.
175180
176### Example
181## Example
177182
178```http
183```bash
179184curl https://api.anthropic.com/v1/files \
180185 -H 'anthropic-version: 2023-06-01' \
181186 -H 'anthropic-beta: files-api-2025-04-14' \
from line 187
182187 -H "X-Api-Key: $ANTHROPIC_API_KEY"
183188```
184189
185#### Response
190### Response (200)
186191
187192```json
188193{
api/beta/files/retrieve_metadata Changed · +19 / -18 lines
# Get File Metadata ## Path parameters ## Headers ## Returns ## Example ### Response (200) ## Get File Metadata ### Path Parameters ### Header Parameters ### Returns ### Example #### Response
from line 1
1---
2title: Get File Metadata
3url: https://platform.claude.com/docs/en/api/beta/files/retrieve_metadata
4---
1# Get File Metadata
52
6## Get File Metadata
3**GET** `/v1/files/{file_id}`
74
8**get** `/v1/files/{file_id}`
9
105Get File Metadata
116
12### Path Parameters
7## Path parameters
138
149- `file_id: string`
1510
1611 ID of the File.
1712
18### Header Parameters
13## Headers
1914
2015- `"anthropic-beta": optional array of AnthropicBeta`
2116
from line 88
9388
9489 - `"mid-conversation-tool-changes-2026-07-01"`
9590
96### Returns
91## Returns
9792
98- `BetaFileMetadata object { id, created_at, filename, 5 more }`
93- `BetaFileMetadata object`
9994
10095 - `id: string`
10196
from line 102
107102
108103 RFC 3339 datetime string representing when the file was created.
109104
105 format: date-time
106
110107 - `filename: string`
111108
112109 Original filename of the uploaded file.
113110
111 maxLength: 500, minLength: 1
112
114113 - `mime_type: string`
115114
116115 MIME type of the file.
117116
117 maxLength: 255, minLength: 1
118
118119 - `size_bytes: number`
119120
120121 Size of the file in bytes.
121122
123 minimum: 0
124
122125 - `type: "file"`
123126
124127 Object type.
from line 128
125128
126129 For files, this is always `"file"`.
127130
128 - `"file"`
129
130131 - `downloadable: optional boolean`
131132
132133 Whether the file can be downloaded.
133134
135 default: false
136
134137 - `scope: optional BetaFileScope or null`
135138
136139 The scope of this file, indicating the context in which it was created (e.g., a session).
from line 146
143146
144147 The type of scope (e.g., `"session"`).
145148
146 - `"session"`
149## Example
147150
148### Example
149
150```http
151```bash
151152curl https://api.anthropic.com/v1/files/$FILE_ID \
152153 -H 'anthropic-version: 2023-06-01' \
153154 -H 'anthropic-beta: files-api-2025-04-14' \
from line 155
154155 -H "X-Api-Key: $ANTHROPIC_API_KEY"
155156```
156157
157#### Response
158### Response (200)
158159
159160```json
160161{
api/beta/files/upload Changed · +26 / -17 lines
# Upload File ## Headers ## Body parameters (form-data) ## Returns ## Example ### Response (200) ## Upload File ### Header Parameters ### Returns ### Example #### Response
from line 1
1---
2title: Upload File
3url: https://platform.claude.com/docs/en/api/beta/files/upload
4---
1# Upload File
52
6## Upload File
3**POST** `/v1/files`
74
8**post** `/v1/files`
9
105Upload File
116
12### Header Parameters
7## Headers
138
149- `"anthropic-beta": optional array of AnthropicBeta`
1510
from line 82
8782
8883 - `"mid-conversation-tool-changes-2026-07-01"`
8984
90### Returns
85## Body parameters (form-data)
9186
92- `BetaFileMetadata object { id, created_at, filename, 5 more }`
87- `file: string`
9388
89 The file to upload
90
91 format: binary
92
93## Returns
94
95- `BetaFileMetadata object`
96
9497 - `id: string`
9598
9699 Unique object identifier.
from line 104
101104
102105 RFC 3339 datetime string representing when the file was created.
103106
107 format: date-time
108
104109 - `filename: string`
105110
106111 Original filename of the uploaded file.
107112
113 maxLength: 500, minLength: 1
114
108115 - `mime_type: string`
109116
110117 MIME type of the file.
111118
119 maxLength: 255, minLength: 1
120
112121 - `size_bytes: number`
113122
114123 Size of the file in bytes.
115124
125 minimum: 0
126
116127 - `type: "file"`
117128
118129 Object type.
from line 130
119130
120131 For files, this is always `"file"`.
121132
122 - `"file"`
123
124133 - `downloadable: optional boolean`
125134
126135 Whether the file can be downloaded.
127136
137 default: false
138
128139 - `scope: optional BetaFileScope or null`
129140
130141 The scope of this file, indicating the context in which it was created (e.g., a session).
from line 148
137148
138149 The type of scope (e.g., `"session"`).
139150
140 - `"session"`
151## Example
141152
142### Example
143
144```http
153```bash
145154curl https://api.anthropic.com/v1/files \
146155 -H 'Content-Type: multipart/form-data' \
147156 -H 'anthropic-version: 2023-06-01' \
from line 159
150159 -F 'file=@/path/to/file'
151160```
152161
153#### Response
162### Response (200)
154163
155164```json
156165{
api/beta/memory_stores Changed · +444 / -929 lines
### Headers ### Body parameters #### Response (200) ### Query parameters ### Headers #### Response (200) ### Path parameters ### Headers #### Response (200) ### Path parameters ### Headers ### Body parameters #### Response (200) ### Path parameters ### Headers #### Response (200) ### Path parameters ### Headers #### Response (200) ## Domain types ## Memory Stores › Memories ### Create a memory #### Path parameters #### Query parameters #### Headers #### Body parameters #### Returns #### Example ##### Response (200) ### List memories #### Path parameters #### Query parameters #### Headers #### Returns #### Example ##### Response (200) ### Retrieve a memory #### Path parameters #### Query parameters #### Headers #### Returns #### Example ##### Response (200) ### Update a memory #### Path parameters #### Query parameters #### Headers #### Body parameters #### Returns #### Example ##### Response (200) ### Delete a memory #### Path parameters #### Query parameters #### Headers #### Returns #### Example ##### Response (200) ## Memory Stores › Memory Versions ### List memory versions #### Path parameters #### Query parameters #### Headers #### Returns #### Example ##### Response (200) ### Retrieve a memory version #### Path parameters #### Query parameters #### Headers #### Returns #### Example ##### Response (200) ### Redact a memory version #### Path parameters #### Headers #### Returns #### Example ##### Response (200) ### Header Parameters ### Body Parameters #### Response ### Query Parameters ### Header Parameters #### Response ### Path Parameters ### Header Parameters #### Response ### Path Parameters ### Header Parameters ### Body Parameters #### Response ### Path Parameters ### Header Parameters #### Response ### Path Parameters ### Header Parameters #### Response ## Domain Types # Memories ## Create a memory ### Path Parameters ### Query Parameters ### Header Parameters ### Body Parameters #### Response ## List memories ### Path Parameters ### Query Parameters ### Header Parameters #### Response ## Retrieve a memory ### Path Parameters ### Query Parameters ### Header Parameters #### Response ## Update a memory ### Path Parameters ### Query Parameters ### Header Parameters ### Body Parameters #### Response ## Delete a memory ### Path Parameters ### Query Parameters ### Header Parameters #### Response ## Domain Types ### Beta Managed Agents Conflict Error ### Beta Managed Agents Content Sha256 Precondition ### Beta Managed Agents Deleted Memory ### Beta Managed Agents Error ### Beta Managed Agents Memory ### Beta Managed Agents Memory List Item ### Beta Managed Agents Memory Path Conflict Error ### Beta Managed Agents Memory Precondition Failed Error ### Beta Managed Agents Memory Prefix ### Beta Managed Agents Memory View ### Beta Managed Agents Precondition # Memory Versions ## List memory versions ### Path Parameters ### Query Parameters ### Header Parameters #### Response ## Retrieve a memory version ### Path Parameters ### Query Parameters ### Header Parameters #### Response ## Redact a memory version ### Path Parameters ### Header Parameters #### Response ## Domain Types ### Beta Managed Agents Actor ### Beta Managed Agents API Actor ### Beta Managed Agents Memory Version ### Beta Managed Agents Memory Version Operation ### Beta Managed Agents Service Account Actor ### Beta Managed Agents Session Actor ### Beta Managed Agents User Actor
The two sides of this change are more than 400 edits apart, too far apart to line up, so this is the differ's own diff of it and the words inside a line are not marked.
from line 1
1---
2title: Memory Stores
3url: https://platform.claude.com/docs/en/api/beta/memory_stores
4---
5
61# Memory Stores
72
83## Create a memory store
94
10**post** `/v1/memory_stores`
5**POST** `/v1/memory_stores`
116
127Create a memory store
138
14### Header Parameters
9### Headers
1510
1611- `"anthropic-beta": optional array of AnthropicBeta`
1712
from line 84
8984
9085 - `"mid-conversation-tool-changes-2026-07-01"`
9186
92### Body Parameters
87### Body parameters
9388
9489- `name: string`
9590
9691 Human-readable name for the store. Required; 1–255 characters; no control characters. The mount-path slug under `/mnt/memory/` is derived from this name (lowercased, non-alphanumeric runs collapsed to a hyphen). Names need not be unique within a workspace.
9792
93 minLength: 1, maxLength: 255
94
9895- `description: optional string`
9996
10097 Free-text description of what the store contains, up to 1024 characters. Included in the agent's system prompt when the store is attached, so word it to be useful to the agent.
10198
99 maxLength: 1024
100
102101- `metadata: optional map[string]`
103102
104103 Arbitrary key-value tags for your own bookkeeping (such as the end user a store belongs to). Up to 16 pairs; keys 1–64 characters; values up to 512 characters. Not visible to the agent.
105104
106105### Returns
107106
108- `BetaManagedAgentsMemoryStore object { id, created_at, name, 5 more }`
107- `BetaManagedAgentsMemoryStore object`
109108
110109 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.
111110
from line 116
117116
118117 A timestamp in RFC 3339 format
119118
119 format: date-time
120
120121 - `name: string`
121122
122123 Human-readable name for the store. 1–255 characters. The store's mount-path slug under `/mnt/memory/` is derived from this name.
123124
124125 - `type: "memory_store"`
125126
126 - `"memory_store"`
127
128127 - `updated_at: string`
129128
130129 A timestamp in RFC 3339 format
131130
131 format: date-time
132
132133 - `archived_at: optional string or null`
133134
134135 A timestamp in RFC 3339 format
135136
137 format: date-time
138
136139 - `description: optional string`
137140
138141 Free-text description of what the store contains, up to 1024 characters. Included in the agent's system prompt when the store is attached, so word it to be useful to the agent. Empty string when unset.
from line 146
143146
144147### Example
145148
146```http
149```bash
147150curl https://api.anthropic.com/v1/memory_stores \
148151 -H 'Content-Type: application/json' \
149152 -H 'anthropic-version: 2023-06-01' \
from line 157
154157 }'
155158```
156159
157#### Response
160#### Response (200)
158161
159162```json
160163{
from line 176
173176
174177## List memory stores
175178
176**get** `/v1/memory_stores`
179**GET** `/v1/memory_stores`
177180
178181List memory stores
179182
180### Query Parameters
183### Query parameters
181184
182185- `"created_at[gte]": optional string`
183186
184187 Return only stores whose `created_at` is at or after this time (inclusive). Sent on the wire as `created_at[gte]`.
185188
189 format: date-time
190
186191- `"created_at[lte]": optional string`
187192
188193 Return only stores whose `created_at` is at or before this time (inclusive). Sent on the wire as `created_at[lte]`.
189194
195 format: date-time
196
190197- `include_archived: optional boolean`
191198
192199 When `true`, archived stores are included in the results. Defaults to `false` (archived stores are excluded).
from line 202
195202
196203 Maximum number of stores to return per page. Must be between 1 and 100. Defaults to 20 when omitted.
197204
205 format: int32
206
198207- `page: optional string`
199208
200209 Opaque pagination cursor (a `page_...` value). Pass the `next_page` value from a previous response to fetch the next page; omit for the first page.
201210
202### Header Parameters
211### Headers
203212
204213- `"anthropic-beta": optional array of AnthropicBeta`
205214
from line 300
291300
292301 A timestamp in RFC 3339 format
293302
303 format: date-time
304
294305 - `name: string`
295306
296307 Human-readable name for the store. 1–255 characters. The store's mount-path slug under `/mnt/memory/` is derived from this name.
297308
298309 - `type: "memory_store"`
299310
300 - `"memory_store"`
301
302311 - `updated_at: string`
303312
304313 A timestamp in RFC 3339 format
305314
315 format: date-time
316
306317 - `archived_at: optional string or null`
307318
308319 A timestamp in RFC 3339 format
309320
321 format: date-time
322
310323 - `description: optional string`
311324
312325 Free-text description of what the store contains, up to 1024 characters. Included in the agent's system prompt when the store is attached, so word it to be useful to the agent. Empty string when unset.
from line 334
321334
322335### Example
323336
324```http
337```bash
325338curl https://api.anthropic.com/v1/memory_stores \
326339 -H 'anthropic-version: 2023-06-01' \
327340 -H 'anthropic-beta: agent-memory-2026-07-22' \
328341 -H "X-Api-Key: $ANTHROPIC_API_KEY"
329342```
330343
331#### Response
344#### Response (200)
332345
333346```json
334347{
from line 365
352365
353366## Retrieve a memory store
354367
355**get** `/v1/memory_stores/{memory_store_id}`
368**GET** `/v1/memory_stores/{memory_store_id}`
356369
357370Retrieve a memory store
358371
359### Path Parameters
372### Path parameters
360373
361374- `memory_store_id: string`
362375
363### Header Parameters
376### Headers
364377
365378- `"anthropic-beta": optional array of AnthropicBeta`
366379
from line 453
440453
441454### Returns
442455
443- `BetaManagedAgentsMemoryStore object { id, created_at, name, 5 more }`
456- `BetaManagedAgentsMemoryStore object`
444457
445458 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.
446459
from line 465
452465
453466 A timestamp in RFC 3339 format
454467
468 format: date-time
469
455470 - `name: string`
456471
457472 Human-readable name for the store. 1–255 characters. The store's mount-path slug under `/mnt/memory/` is derived from this name.
458473
459474 - `type: "memory_store"`
460475
461 - `"memory_store"`
462
463476 - `updated_at: string`
464477
465478 A timestamp in RFC 3339 format
466479
480 format: date-time
481
467482 - `archived_at: optional string or null`
468483
469484 A timestamp in RFC 3339 format
470485
486 format: date-time
487
471488 - `description: optional string`
472489
473490 Free-text description of what the store contains, up to 1024 characters. Included in the agent's system prompt when the store is attached, so word it to be useful to the agent. Empty string when unset.
from line 495
478495
479496### Example
480497
481```http
498```bash
482499curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID \
483500 -H 'anthropic-version: 2023-06-01' \
484501 -H 'anthropic-beta: agent-memory-2026-07-22' \
485502 -H "X-Api-Key: $ANTHROPIC_API_KEY"
486503```
487504
488#### Response
505#### Response (200)
489506
490507```json
491508{
from line 521
504521
505522## Update a memory store
506523
507**post** `/v1/memory_stores/{memory_store_id}`
524**POST** `/v1/memory_stores/{memory_store_id}`
508525
509526Update a memory store
510527
511### Path Parameters
528### Path parameters
512529
513530- `memory_store_id: string`
514531
515### Header Parameters
532### Headers
516533
517534- `"anthropic-beta": optional array of AnthropicBeta`
518535
from line 607
590607
591608 - `"mid-conversation-tool-changes-2026-07-01"`
592609
593### Body Parameters
610### Body parameters
594611
595612- `description: optional string or null`
596613
597614 New description for the store, up to 1024 characters. Pass an empty string to clear it.
598615
616 maxLength: 1024
617
599618- `metadata: optional map[string] or null`
600619
601620 Metadata patch. Set a key to a string to upsert it, or to null to delete it. Omit the field to preserve. The stored bag is limited to 16 keys (up to 64 chars each) with values up to 512 chars.
from line 623
604623
605624 New human-readable name for the store. 1–255 characters; no control characters. Renaming changes the slug used for the store's `mount_path` in sessions created after the update.
606625
626 minLength: 1, maxLength: 255
627
607628### Returns
608629
609- `BetaManagedAgentsMemoryStore object { id, created_at, name, 5 more }`
630- `BetaManagedAgentsMemoryStore object`
610631
611632 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.
612633
from line 639
618639
619640 A timestamp in RFC 3339 format
620641
642 format: date-time
643
621644 - `name: string`
622645
623646 Human-readable name for the store. 1–255 characters. The store's mount-path slug under `/mnt/memory/` is derived from this name.
624647
625648 - `type: "memory_store"`
626649
627 - `"memory_store"`
628
629650 - `updated_at: string`
630651
631652 A timestamp in RFC 3339 format
632653
654 format: date-time
655
633656 - `archived_at: optional string or null`
634657
635658 A timestamp in RFC 3339 format
636659
660 format: date-time
661
637662 - `description: optional string`
638663
639664 Free-text description of what the store contains, up to 1024 characters. Included in the agent's system prompt when the store is attached, so word it to be useful to the agent. Empty string when unset.
from line 669
644669
645670### Example
646671
647```http
672```bash
648673curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID \
649674 -H 'Content-Type: application/json' \
650675 -H 'anthropic-version: 2023-06-01' \
from line 678
653678 -d '{}'
654679```
655680
656#### Response
681#### Response (200)
657682
658683```json
659684{
from line 697
672697
673698## Delete a memory store
674699
675**delete** `/v1/memory_stores/{memory_store_id}`
700**DELETE** `/v1/memory_stores/{memory_store_id}`
676701
677702Delete a memory store
678703
679### Path Parameters
704### Path parameters
680705
681706- `memory_store_id: string`
682707
683### Header Parameters
708### Headers
684709
685710- `"anthropic-beta": optional array of AnthropicBeta`
686711
from line 785
760785
761786### Returns
762787
763- `BetaManagedAgentsDeletedMemoryStore object { id, type }`
788- `BetaManagedAgentsDeletedMemoryStore object`
764789
765790 Confirmation that a `memory_store` was deleted.
766791
from line 795
770795
771796 - `type: "memory_store_deleted"`
772797
773 - `"memory_store_deleted"`
774
775798### Example
776799
777```http
800```bash
778801curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID \
779802 -X DELETE \
780803 -H 'anthropic-version: 2023-06-01' \
from line 805
782805 -H "X-Api-Key: $ANTHROPIC_API_KEY"
783806```
784807
785#### Response
808#### Response (200)
786809
787810```json
788811{
from line 816
793816
794817## Archive a memory store
795818
796**post** `/v1/memory_stores/{memory_store_id}/archive`
819**POST** `/v1/memory_stores/{memory_store_id}/archive`
797820
798821Archive a memory store
799822
800### Path Parameters
823### Path parameters
801824
802825- `memory_store_id: string`
803826
804### Header Parameters
827### Headers
805828
806829- `"anthropic-beta": optional array of AnthropicBeta`
807830
from line 904
881904
882905### Returns
883906
884- `BetaManagedAgentsMemoryStore object { id, created_at, name, 5 more }`
907- `BetaManagedAgentsMemoryStore object`
885908
886909 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.
887910
from line 916
893916
894917 A timestamp in RFC 3339 format
895918
919 format: date-time
920
896921 - `name: string`
897922
898923 Human-readable name for the store. 1–255 characters. The store's mount-path slug under `/mnt/memory/` is derived from this name.
899924
900925 - `type: "memory_store"`
901926
902 - `"memory_store"`
903
904927 - `updated_at: string`
905928
906929 A timestamp in RFC 3339 format
907930
931 format: date-time
932
908933 - `archived_at: optional string or null`
909934
910935 A timestamp in RFC 3339 format
911936
937 format: date-time
938
912939 - `description: optional string`
913940
914941 Free-text description of what the store contains, up to 1024 characters. Included in the agent's system prompt when the store is attached, so word it to be useful to the agent. Empty string when unset.
from line 946
919946
920947### Example
921948
922```http
949```bash
923950curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/archive \
924951 -X POST \
925952 -H 'anthropic-version: 2023-06-01' \
from line 954
927954 -H "X-Api-Key: $ANTHROPIC_API_KEY"
928955```
929956
930#### Response
957#### Response (200)
931958
932959```json
933960{
from line 971
944971}
945972```
946973
947## Domain Types
974## Domain types
948975
949976### Beta Managed Agents Deleted Memory Store
950977
951- `BetaManagedAgentsDeletedMemoryStore object { id, type }`
978- `BetaManagedAgentsDeletedMemoryStore object`
952979
953980 Confirmation that a `memory_store` was deleted.
954981
from line 985
958985
959986 - `type: "memory_store_deleted"`
960987
961 - `"memory_store_deleted"`
962
963988### Beta Managed Agents Memory Store
964989
965- `BetaManagedAgentsMemoryStore object { id, created_at, name, 5 more }`
990- `BetaManagedAgentsMemoryStore object`
966991
967992 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.
968993
from line 999
974999
9751000 A timestamp in RFC 3339 format
9761001
1002 format: date-time
1003
9771004 - `name: string`
9781005
9791006 Human-readable name for the store. 1–255 characters. The store's mount-path slug under `/mnt/memory/` is derived from this name.
9801007
9811008 - `type: "memory_store"`
9821009
983 - `"memory_store"`
984
9851010 - `updated_at: string`
9861011
9871012 A timestamp in RFC 3339 format
9881013
1014 format: date-time
1015
9891016 - `archived_at: optional string or null`
9901017
9911018 A timestamp in RFC 3339 format
9921019
1020 format: date-time
1021
9931022 - `description: optional string`
9941023
9951024 Free-text description of what the store contains, up to 1024 characters. Included in the agent's system prompt when the store is attached, so word it to be useful to the agent. Empty string when unset.
from line 1027
9981027
9991028 Arbitrary key-value tags for your own bookkeeping (such as the end user a store belongs to). Up to 16 pairs; keys 1–64 characters; values up to 512 characters. Returned on retrieve/list but not filterable.
10001029
1001# Memories
1002
1003## Create a memory
1004
1005**post** `/v1/memory_stores/{memory_store_id}/memories`
1030## Memory Stores › Memories
1031
1032### Create a memory
1033
1034**POST** `/v1/memory_stores/{memory_store_id}/memories`
10061035
10071036Create a memory
10081037
1009### Path Parameters
1038#### Path parameters
10101039
10111040- `memory_store_id: string`
10121041
1013### Query Parameters
1042#### Query parameters
10141043
10151044- `view: optional BetaManagedAgentsMemoryView`
10161045
from line 1049
10201049
10211050 - `"full"`
10221051
1023### Header Parameters
1052#### Headers
10241053
10251054- `"anthropic-beta": optional array of AnthropicBeta`
10261055
from line 1127
10981127
10991128 - `"mid-conversation-tool-changes-2026-07-01"`
11001129
1101### Body Parameters
1130#### Body parameters
11021131
11031132- `content: string or null`
11041133
from line 1137
11081137
11091138 Hierarchical path for the new memory, e.g. `/projects/foo/notes.md`. Must start with `/`, contain at least one non-empty segment, and be at most 1,024 bytes. Must not contain empty segments, `.` or `..` segments, control or format characters, and must be NFC-normalized. Paths are case-sensitive.
11101139
1111### Returns
1112
1113- `BetaManagedAgentsMemory object { id, content_sha256, content_size_bytes, 7 more }`
1140 minLength: 2, maxLength: 1024
1141
1142#### Returns
1143
1144- `BetaManagedAgentsMemory object`
11141145
11151146 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.
11161147
from line 1157
11261157
11271158 Size of `content` in bytes (the UTF-8 plaintext length). Always populated, regardless of `view`.
11281159
1160 format: int32
1161
11291162 - `created_at: string`
11301163
11311164 A timestamp in RFC 3339 format
11321165
1166 format: date-time
1167
11331168 - `memory_store_id: string`
11341169
11351170 ID of the memory store this memory belongs to (a `memstore_...` value).
from line 1179
11441179
11451180 - `type: "memory"`
11461181
1147 - `"memory"`
1148
11491182 - `updated_at: string`
11501183
11511184 A timestamp in RFC 3339 format
11521185
1186 format: date-time
1187
11531188 - `content: optional string or null`
11541189
11551190 The memory's UTF-8 text content. Populated when `view=full`; `null` when `view=basic`. Maximum 100 kB (102,400 bytes).
11561191
1157### Example
1158
1159```http
1192#### Example
1193
1194```bash
11601195curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memories \
11611196 -H 'Content-Type: application/json' \
11621197 -H 'anthropic-version: 2023-06-01' \
from line 1203
11681203 }'
11691204```
11701205
1171#### Response
1206##### Response (200)
11721207
11731208```json
11741209{
from line 1220
11851220}
11861221```
11871222
1188## List memories
1189
1190**get** `/v1/memory_stores/{memory_store_id}/memories`
1223### List memories
1224
1225**GET** `/v1/memory_stores/{memory_store_id}/memories`
11911226
11921227List memories
11931228
1194### Path Parameters
1229#### Path parameters
11951230
11961231- `memory_store_id: string`
11971232
1198### Query Parameters
1233#### Query parameters
11991234
12001235- `depth: optional number`
12011236
12021237 `0` (or omitted) returns all descendants below `path_prefix` (recursive). `1` returns immediate children only; deeper entries roll up as `memory_prefix` items. `depth=1` behaves like `ls`; omitting `depth` behaves like `find`.
12031238
1239 format: int32
1240
12041241- `limit: optional number`
12051242
12061243 Maximum number of items to return per page. Must be between 1 and 100. Defaults to 20 when omitted. Capped at 20 when `view=full`. Both `memory` and `memory_prefix` items count toward the limit.
12071244
1245 format: int32
1246
12081247- `page: optional string`
12091248
12101249 Opaque pagination cursor (a `page_...` value). Pass the `next_page` value from a previous response to fetch the next page; omit for the first page.
from line 1260
12211260
12221261 - `"full"`
12231262
1224### Header Parameters
1263#### Headers
12251264
12261265- `"anthropic-beta": optional array of AnthropicBeta`
12271266
from line 1338
12991338
13001339 - `"mid-conversation-tool-changes-2026-07-01"`
13011340
1302### Returns
1341#### Returns
13031342
13041343- `data: optional array of BetaManagedAgentsMemoryListItem`
13051344
13061345 One page of results. Each item is either a `memory` object or, when `depth` was set, a `memory_prefix` rollup marker. Items are returned in a stable, server-defined order.
13071346
1308 - `BetaManagedAgentsMemory object { id, content_sha256, content_size_bytes, 7 more }`
1347 - `BetaManagedAgentsMemory object`
13091348
13101349 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.
13111350
from line 1360
13211360
13221361 Size of `content` in bytes (the UTF-8 plaintext length). Always populated, regardless of `view`.
13231362
1363 format: int32
1364
13241365 - `created_at: string`
13251366
13261367 A timestamp in RFC 3339 format
13271368
1369 format: date-time
1370
13281371 - `memory_store_id: string`
13291372
13301373 ID of the memory store this memory belongs to (a `memstore_...` value).
from line 1382
13391382
13401383 - `type: "memory"`
13411384
1342 - `"memory"`
1343
13441385 - `updated_at: string`
13451386
13461387 A timestamp in RFC 3339 format
13471388
1389 format: date-time
1390
13481391 - `content: optional string or null`
13491392
13501393 The memory's UTF-8 text content. Populated when `view=full`; `null` when `view=basic`. Maximum 100 kB (102,400 bytes).
13511394
1352 - `BetaManagedAgentsMemoryPrefix object { path, type }`
1395 - `BetaManagedAgentsMemoryPrefix object`
13531396
13541397 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.
13551398
from line 1402
13591402
13601403 - `type: "memory_prefix"`
13611404
1362 - `"memory_prefix"`
1363
13641405- `next_page: optional string or null`
13651406
13661407 Opaque cursor for the next page (a `page_...` value), or `null` if there are no more results. Pass as `page` on the next request.
13671408
1368### Example
1369
1370```http
1409#### Example
1410
1411```bash
13711412curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memories \
13721413 -H 'anthropic-version: 2023-06-01' \
13731414 -H 'anthropic-beta: agent-memory-2026-07-22' \
13741415 -H "X-Api-Key: $ANTHROPIC_API_KEY"
13751416```
13761417
1377#### Response
1418##### Response (200)
13781419
13791420```json
13801421{
from line 1437
13961437}
13971438```
13981439
1399## Retrieve a memory
1400
1401**get** `/v1/memory_stores/{memory_store_id}/memories/{memory_id}`
1440### Retrieve a memory
1441
1442**GET** `/v1/memory_stores/{memory_store_id}/memories/{memory_id}`
14021443
14031444Retrieve a memory
14041445
1405### Path Parameters
1446#### Path parameters
14061447
14071448- `memory_store_id: string`
14081449
14091450- `memory_id: string`
14101451
1411### Query Parameters
1452#### Query parameters
14121453
14131454- `view: optional BetaManagedAgentsMemoryView`
14141455
from line 1459
14181459
14191460 - `"full"`
14201461
1421### Header Parameters
1462#### Headers
14221463
14231464- `"anthropic-beta": optional array of AnthropicBeta`
14241465
from line 1537
14961537
14971538 - `"mid-conversation-tool-changes-2026-07-01"`
14981539
1499### Returns
1500
1501- `BetaManagedAgentsMemory object { id, content_sha256, content_size_bytes, 7 more }`
1540#### Returns
1541
1542- `BetaManagedAgentsMemory object`
15021543
15031544 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.
15041545
from line 1555
15141555
15151556 Size of `content` in bytes (the UTF-8 plaintext length). Always populated, regardless of `view`.
15161557
1558 format: int32
1559
15171560 - `created_at: string`
15181561
15191562 A timestamp in RFC 3339 format
15201563
1564 format: date-time
1565
15211566 - `memory_store_id: string`
15221567
15231568 ID of the memory store this memory belongs to (a `memstore_...` value).
from line 1577
15321577
15331578 - `type: "memory"`
15341579
1535 - `"memory"`
1536
15371580 - `updated_at: string`
15381581
15391582 A timestamp in RFC 3339 format
15401583
1584 format: date-time
1585
15411586 - `content: optional string or null`
15421587
15431588 The memory's UTF-8 text content. Populated when `view=full`; `null` when `view=basic`. Maximum 100 kB (102,400 bytes).
15441589
1545### Example
1546
1547```http
1590#### Example
1591
1592```bash
15481593curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memories/$MEMORY_ID \
15491594 -H 'anthropic-version: 2023-06-01' \
15501595 -H 'anthropic-beta: agent-memory-2026-07-22' \
15511596 -H "X-Api-Key: $ANTHROPIC_API_KEY"
15521597```
15531598
1554#### Response
1599##### Response (200)
15551600
15561601```json
15571602{
from line 1613
15681613}
15691614```
15701615
1571## Update a memory
1572
1573**post** `/v1/memory_stores/{memory_store_id}/memories/{memory_id}`
1616### Update a memory
1617
1618**POST** `/v1/memory_stores/{memory_store_id}/memories/{memory_id}`
15741619
15751620Update a memory
15761621
1577### Path Parameters
1622#### Path parameters
15781623
15791624- `memory_store_id: string`
15801625
15811626- `memory_id: string`
15821627
1583### Query Parameters
1628#### Query parameters
15841629
15851630- `view: optional BetaManagedAgentsMemoryView`
15861631
from line 1635
15901635
15911636 - `"full"`
15921637
1593### Header Parameters
1638#### Headers
15941639
15951640- `"anthropic-beta": optional array of AnthropicBeta`
15961641
from line 1713
16681713
16691714 - `"mid-conversation-tool-changes-2026-07-01"`
16701715
1671### Body Parameters
1716#### Body parameters
16721717
16731718- `content: optional string or null`
16741719
from line 1723
16781723
16791724 New path for the memory (a rename). Must start with `/`, contain at least one non-empty segment, and be at most 1,024 bytes. Must not contain empty segments, `.` or `..` segments, control or format characters, and must be NFC-normalized. Paths are case-sensitive. The memory's `id` is preserved across renames. Omit to leave the path unchanged.
16801725
1726 minLength: 2, maxLength: 1024
1727
16811728- `precondition: optional BetaManagedAgentsPrecondition`
16821729
16831730 Optimistic-concurrency precondition: the update applies only if the memory's stored `content_sha256` equals the supplied value. On mismatch, the request returns `memory_precondition_failed_error` (HTTP 409); re-read the memory and retry against the fresh state. If the precondition fails but the stored state already exactly matches the requested `content` and `path`, the server returns 200 instead of 409.
16841731
16851732 - `type: "content_sha256"`
16861733
1687 - `"content_sha256"`
1688
16891734 - `content_sha256: optional string`
16901735
16911736 Expected `content_sha256` of the stored memory (64 lowercase hexadecimal characters). Typically the `content_sha256` returned by a prior read or list call. Because the server applies no content normalization, clients can also compute this locally as the SHA-256 of the UTF-8 content bytes.
16921737
1693### Returns
1694
1695- `BetaManagedAgentsMemory object { id, content_sha256, content_size_bytes, 7 more }`
1738#### Returns
1739
1740- `BetaManagedAgentsMemory object`
16961741
16971742 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.
16981743
from line 1753
17081753
17091754 Size of `content` in bytes (the UTF-8 plaintext length). Always populated, regardless of `view`.
17101755
1756 format: int32
1757
17111758 - `created_at: string`
17121759
17131760 A timestamp in RFC 3339 format
17141761
1762 format: date-time
1763
17151764 - `memory_store_id: string`
17161765
17171766 ID of the memory store this memory belongs to (a `memstore_...` value).
from line 1775
17261775
17271776 - `type: "memory"`
17281777
1729 - `"memory"`
1730
17311778 - `updated_at: string`
17321779
17331780 A timestamp in RFC 3339 format
17341781
1782 format: date-time
1783
17351784 - `content: optional string or null`
17361785
17371786 The memory's UTF-8 text content. Populated when `view=full`; `null` when `view=basic`. Maximum 100 kB (102,400 bytes).
17381787
1739### Example
1740
1741```http
1788#### Example
1789
1790```bash
17421791curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memories/$MEMORY_ID \
17431792 -H 'Content-Type: application/json' \
17441793 -H 'anthropic-version: 2023-06-01' \
from line 1796
17471796 -d '{}'
17481797```
17491798
1750#### Response
1799##### Response (200)
17511800
17521801```json
17531802{
from line 1813
17641813}
17651814```
17661815
1767## Delete a memory
1768
1769**delete** `/v1/memory_stores/{memory_store_id}/memories/{memory_id}`
1816### Delete a memory
1817
1818**DELETE** `/v1/memory_stores/{memory_store_id}/memories/{memory_id}`
17701819
17711820Delete a memory
17721821
1773### Path Parameters
1822#### Path parameters
17741823
17751824- `memory_store_id: string`
17761825
17771826- `memory_id: string`
17781827
1779### Query Parameters
1828#### Query parameters
17801829
17811830- `expected_content_sha256: optional string`
17821831
17831832 Query parameter for expected_content_sha256
17841833
1785### Header Parameters
1834#### Headers
17861835
17871836- `"anthropic-beta": optional array of AnthropicBeta`
17881837
from line 1909
18601909
18611910 - `"mid-conversation-tool-changes-2026-07-01"`
18621911
1863### Returns
1864
1865- `BetaManagedAgentsDeletedMemory object { id, type }`
1912#### Returns
1913
1914- `BetaManagedAgentsDeletedMemory object`
18661915
18671916 Tombstone returned by [Delete a memory](/docs/en/api/beta/memory_stores/memories/delete). The memory's version history persists and remains listable via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) until the store itself is deleted.
18681917
from line 1921
18721921
18731922 - `type: "memory_deleted"`
18741923
1875 - `"memory_deleted"`
1876
1877### Example
1878
1879```http
1924#### Example
1925
1926```bash
18801927curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memories/$MEMORY_ID \
18811928 -X DELETE \
18821929 -H 'anthropic-version: 2023-06-01' \
from line 1931
18841931 -H "X-Api-Key: $ANTHROPIC_API_KEY"
18851932```
18861933
1887#### Response
1934##### Response (200)
18881935
18891936```json
18901937{
from line 1940
18931940}
18941941```
18951942
1896## Domain Types
1897
1898### Beta Managed Agents Conflict Error
1899
1900- `BetaManagedAgentsConflictError object { type, message }`
1901
1902 - `type: "conflict_error"`
1903
1904 - `"conflict_error"`
1905
1906 - `message: optional string`
1907
1908### Beta Managed Agents Content Sha256 Precondition
1909
1910- `BetaManagedAgentsContentSha256Precondition object { type, content_sha256 }`
1911
1912 Optimistic-concurrency precondition: the update applies only if the memory's stored `content_sha256` equals the supplied value. On mismatch, the request returns `memory_precondition_failed_error` (HTTP 409); re-read the memory and retry against the fresh state. If the precondition fails but the stored state already exactly matches the requested `content` and `path`, the server returns 200 instead of 409.
1913
1914 - `type: "content_sha256"`
1915
1916 - `"content_sha256"`
1917
1918 - `content_sha256: optional string`
1919
1920 Expected `content_sha256` of the stored memory (64 lowercase hexadecimal characters). Typically the `content_sha256` returned by a prior read or list call. Because the server applies no content normalization, clients can also compute this locally as the SHA-256 of the UTF-8 content bytes.
1921
1922### Beta Managed Agents Deleted Memory
1923
1924- `BetaManagedAgentsDeletedMemory object { id, type }`
1925
1926 Tombstone returned by [Delete a memory](/docs/en/api/beta/memory_stores/memories/delete). The memory's version history persists and remains listable via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) until the store itself is deleted.
1943## Memory Stores › Memory Versions
1944
1945### List memory versions
1946
1947**GET** `/v1/memory_stores/{memory_store_id}/memory_versions`
1948
1949List memory versions
1950
1951#### Path parameters
1952
1953- `memory_store_id: string`
1954
1955#### Query parameters
1956
1957- `api_key_id: optional string`
1958
1959 Query parameter for api_key_id
1960
1961- `"created_at[gte]": optional string`
1962
1963 Return versions created at or after this time (inclusive).
1964
1965 format: date-time
1966
1967- `"created_at[lte]": optional string`
1968
1969 Return versions created at or before this time (inclusive).
1970
1971 format: date-time
1972
1973- `limit: optional number`
1974
1975 Query parameter for limit
1976
1977 format: int32
1978
1979- `memory_id: optional string`
1980
1981 Query parameter for memory_id
1982
1983- `operation: optional BetaManagedAgentsMemoryVersionOperation`
1984
1985 Query parameter for operation
1986
1987 - `"created"`
1988
1989 - `"modified"`
1990
1991 - `"deleted"`
1992
1993- `page: optional string`
1994
1995 Query parameter for page
1996
1997- `service_account_id: optional string`
1998
1999 Query parameter for service_account_id
2000
2001- `session_id: optional string`
2002
2003 Query parameter for session_id
2004
2005- `view: optional BetaManagedAgentsMemoryView`
2006
2007 Query parameter for view
2008
2009 - `"basic"`
2010
2011 - `"full"`
2012
2013#### Headers
2014
2015- `"anthropic-beta": optional array of AnthropicBeta`
2016
2017 Optional header to specify the beta version(s) you want to use.
2018
2019 - `string`
2020
2021 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
2022
2023 - `"message-batches-2024-09-24"`
2024
2025 - `"prompt-caching-2024-07-31"`
2026
2027 - `"computer-use-2024-10-22"`
2028
2029 - `"computer-use-2025-01-24"`
2030
2031 - `"pdfs-2024-09-25"`
2032
2033 - `"token-counting-2024-11-01"`
2034
2035 - `"token-efficient-tools-2025-02-19"`
2036
2037 - `"output-128k-2025-02-19"`
2038
2039 - `"files-api-2025-04-14"`
2040
2041 - `"mcp-client-2025-04-04"`
2042
2043 - `"mcp-client-2025-11-20"`
2044
2045 - `"dev-full-thinking-2025-05-14"`
2046
2047 - `"interleaved-thinking-2025-05-14"`
2048
2049 - `"code-execution-2025-05-22"`
2050
2051 - `"extended-cache-ttl-2025-04-11"`
2052
2053 - `"context-1m-2025-08-07"`
2054
2055 - `"context-management-2025-06-27"`
2056
2057 - `"model-context-window-exceeded-2025-08-26"`
2058
2059 - `"skills-2025-10-02"`
2060
2061 - `"fast-mode-2026-02-01"`
2062
2063 - `"output-300k-2026-03-24"`
2064
2065 - `"user-profiles-2026-03-24"`
2066
2067 - `"user-profiles-2026-08-18"`
2068
2069 - `"advisor-tool-2026-03-01"`
2070
2071 - `"managed-agents-2026-04-01"`
2072
2073 - `"cache-diagnosis-2026-04-07"`
2074
2075 - `"dreaming-2026-04-21"`
2076
2077 - `"thinking-token-count-2026-05-13"`
2078
2079 - `"server-side-fallback-2026-06-01"`
2080
2081 - `"server-side-fallback-2026-07-01"`
2082
2083 - `"fallback-credit-2026-06-01"`
2084
2085 - `"fallback-credit-2026-07-01"`
2086
2087 - `"agent-memory-2026-07-22"`
2088
2089 - `"mid-conversation-tool-changes-2026-07-01"`
2090
2091#### Returns
2092
2093- `data: optional array of BetaManagedAgentsMemoryVersion`
2094
2095 One page of `memory_version` objects, ordered by `created_at` descending (newest first), with `id` as tiebreak.
19272096
19282097 - `id: string`
19292098
1930 ID of the deleted memory (a `mem_...` value).
1931
1932 - `type: "memory_deleted"`
1933
1934 - `"memory_deleted"`
1935
1936### Beta Managed Agents Error
1937
1938- `BetaManagedAgentsError = BetaInvalidRequestError or BetaAuthenticationError or BetaBillingError or 9 more`
1939
1940 - `BetaInvalidRequestError object { message, type }`
1941
1942 - `message: string`
1943
1944 - `type: "invalid_request_error"`
1945
1946 - `"invalid_request_error"`
1947
1948 - `BetaAuthenticationError object { message, type }`
1949
1950 - `message: string`
1951
1952 - `type: "authentication_error"`
1953
1954 - `"authentication_error"`
1955
1956 - `BetaBillingError object { message, type }`
1957
1958 - `message: string`
1959
1960 - `type: "billing_error"`
1961
1962 - `"billing_error"`
1963
1964 - `BetaPermissionError object { message, type }`
1965
1966 - `message: string`
1967
1968 - `type: "permission_error"`
1969
1970 - `"permission_error"`
1971
1972 - `BetaNotFoundError object { message, type }`
1973
1974 - `message: string`
1975
1976 - `type: "not_found_error"`
1977
1978 - `"not_found_error"`
1979
1980 - `BetaRateLimitError object { message, type }`
1981
1982 - `message: string`
1983
1984 - `type: "rate_limit_error"`
1985
1986 - `"rate_limit_error"`
1987
1988 - `BetaGatewayTimeoutError object { message, type }`
1989
1990 - `message: string`
1991
1992 - `type: "timeout_error"`
1993
1994 - `"timeout_error"`
1995
1996 - `BetaAPIError object { message, type }`
1997
1998 - `message: string`
1999
2000 - `type: "api_error"`
2001
2002 - `"api_error"`
2003
2004 - `BetaOverloadedError object { message, type }`
2005
2006 - `message: string`
2007
2008 - `type: "overloaded_error"`
2009
2010 - `"overloaded_error"`
2011
2012 - `BetaManagedAgentsMemoryPreconditionFailedError object { type, message }`
2013
2014 - `type: "memory_precondition_failed_error"`
2015
2016 - `"memory_precondition_failed_error"`
2017
2018 - `message: optional string`
2019
2020 - `BetaManagedAgentsMemoryPathConflictError object { type, conflicting_memory_id, conflicting_path, message }`
2021
2022 - `type: "memory_path_conflict_error"`
2023
2024 - `"memory_path_conflict_error"`
2025
2026 - `conflicting_memory_id: optional string`
2027
2028 - `conflicting_path: optional string`
2029
2030 - `message: optional string`
2031
2032 - `BetaManagedAgentsConflictError object { type, message }`
2033
2034 - `type: "conflict_error"`
2035
2036 - `"conflict_error"`
2037
2038 - `message: optional string`
2039
2040### Beta Managed Agents Memory
2041
2042- `BetaManagedAgentsMemory object { id, content_sha256, content_size_bytes, 7 more }`
2043
2044 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.
2045
2046 - `id: string`
2047
2048 Unique identifier for this memory (a `mem_...` value). Stable across renames; use this ID, not the path, to read, update, or delete the memory.
2049
2050 - `content_sha256: string`
2051
2052 Lowercase hex SHA-256 digest of the UTF-8 `content` bytes (64 characters). The server applies no normalization, so clients can compute the same hash locally for staleness checks and as the value for a `content_sha256` precondition on update. Always populated, regardless of `view`.
2053
2054 - `content_size_bytes: number`
2055
2056 Size of `content` in bytes (the UTF-8 plaintext length). Always populated, regardless of `view`.
2099 Unique identifier for this version (a `memver_...` value).
20572100
20582101 - `created_at: string`
20592102
20602103 A timestamp in RFC 3339 format
20612104
2105 format: date-time
2106
2107 - `memory_id: string`
2108
2109 ID of the memory this version snapshots (a `mem_...` value). Remains valid after the memory is deleted; pass it as `memory_id` to [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) to retrieve the full lineage including the `deleted` row.
2110
20622111 - `memory_store_id: string`
20632112
2064 ID of the memory store this memory belongs to (a `memstore_...` value).
2065
2066 - `memory_version_id: string`
2067
2068 ID of the `memory_version` representing this memory's current content (a `memver_...` value). This is the authoritative head pointer; `memory_version` objects do not carry an `is_latest` flag, so compare against this field instead. Enumerate the full history via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list).
2069
2070 - `path: string`
2071
2072 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.
2073
2074 - `type: "memory"`
2075
2076 - `"memory"`
2077
2078 - `updated_at: string`
2079
2080 A timestamp in RFC 3339 format
2113 ID of the memory store this version belongs to (a `memstore_...` value).
2114
2115 - `operation: BetaManagedAgentsMemoryVersionOperation`
2116
2117 The kind of mutation a `memory_version` records. Every non-no-op mutation to a memory appends exactly one version row with one of these values.
2118
2119 - `"created"`
2120
2121 - `"modified"`
2122
2123 - `"deleted"`
2124
2125 - `type: "memory_version"`
20812126
20822127 - `content: optional string or null`
20832128
2084 The memory's UTF-8 text content. Populated when `view=full`; `null` when `view=basic`. Maximum 100 kB (102,400 bytes).
2085
2086### Beta Managed Agents Memory List Item
2087
2088- `BetaManagedAgentsMemoryListItem = BetaManagedAgentsMemory or BetaManagedAgentsMemoryPrefix`
2089
2090 One item in a [List memories](/docs/en/api/beta/memory_stores/memories/list) response: either a `memory` object or, when `depth` is set, a `memory_prefix` rollup marker.
2091
2092 - `BetaManagedAgentsMemory object { id, content_sha256, content_size_bytes, 7 more }`
2093
2094 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.
2095
2096 - `id: string`
2097
2098 Unique identifier for this memory (a `mem_...` value). Stable across renames; use this ID, not the path, to read, update, or delete the memory.
2099
2100 - `content_sha256: string`
2101
2102 Lowercase hex SHA-256 digest of the UTF-8 `content` bytes (64 characters). The server applies no normalization, so clients can compute the same hash locally for staleness checks and as the value for a `content_sha256` precondition on update. Always populated, regardless of `view`.
2103
2104 - `content_size_bytes: number`
2105
2106 Size of `content` in bytes (the UTF-8 plaintext length). Always populated, regardless of `view`.
2107
2108 - `created_at: string`
2109
2110 A timestamp in RFC 3339 format
2111
2112 - `memory_store_id: string`
2113
2114 ID of the memory store this memory belongs to (a `memstore_...` value).
2115
2116 - `memory_version_id: string`
2117
2118 ID of the `memory_version` representing this memory's current content (a `memver_...` value). This is the authoritative head pointer; `memory_version` objects do not carry an `is_latest` flag, so compare against this field instead. Enumerate the full history via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list).
2119
2120 - `path: string`
2121
2122 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.
2123
2124 - `type: "memory"`
2125
2126 - `"memory"`
2127
2128 - `updated_at: string`
2129
2130 A timestamp in RFC 3339 format
2131
2132 - `content: optional string or null`
2133
2134 The memory's UTF-8 text content. Populated when `view=full`; `null` when `view=basic`. Maximum 100 kB (102,400 bytes).
2135
2136 - `BetaManagedAgentsMemoryPrefix object { path, type }`
2137
2138 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.
2139
2140 - `path: string`
2141
2142 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.
2143
2144 - `type: "memory_prefix"`
2145
2146 - `"memory_prefix"`
2147
2148### Beta Managed Agents Memory Path Conflict Error
2149
2150- `BetaManagedAgentsMemoryPathConflictError object { type, conflicting_memory_id, conflicting_path, message }`
2151
2152 - `type: "memory_path_conflict_error"`
2153
2154 - `"memory_path_conflict_error"`
2155
2156 - `conflicting_memory_id: optional string`
2157
2158 - `conflicting_path: optional string`
2159
2160 - `message: optional string`
2161
2162### Beta Managed Agents Memory Precondition Failed Error
2163
2164- `BetaManagedAgentsMemoryPreconditionFailedError object { type, message }`
2165
2166 - `type: "memory_precondition_failed_error"`
2167
2168 - `"memory_precondition_failed_error"`
2169
2170 - `message: optional string`
2171
2172### Beta Managed Agents Memory Prefix
2173
2174- `BetaManagedAgentsMemoryPrefix object { path, type }`
2175
2176 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.
2177
2178 - `path: string`
2179
2180 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.
2181
2182 - `type: "memory_prefix"`
2183
2184 - `"memory_prefix"`
2185
2186### Beta Managed Agents Memory View
2187
2188- `BetaManagedAgentsMemoryView = "basic" or "full"`
2189
2190 Selects which projection of a `memory` or `memory_version` the server returns. `basic` returns the object with `content` set to `null`; `full` populates `content`. When omitted, the default is endpoint-specific: retrieve operations default to `full`; list, create, and update operations default to `basic`. Listing with `view=full` caps `limit` at 20.
2191
2192 - `"basic"`
2193
2194 - `"full"`
2195
2196### Beta Managed Agents Precondition
2197
2198- `BetaManagedAgentsPrecondition object { type, content_sha256 }`
2199
2200 Optimistic-concurrency precondition: the update applies only if the memory's stored `content_sha256` equals the supplied value. On mismatch, the request returns `memory_precondition_failed_error` (HTTP 409); re-read the memory and retry against the fresh state. If the precondition fails but the stored state already exactly matches the requested `content` and `path`, the server returns 200 instead of 409.
2201
2202 - `type: "content_sha256"`
2203
2204 - `"content_sha256"`
2205
2206 - `content_sha256: optional string`
2207
2208 Expected `content_sha256` of the stored memory (64 lowercase hexadecimal characters). Typically the `content_sha256` returned by a prior read or list call. Because the server applies no content normalization, clients can also compute this locally as the SHA-256 of the UTF-8 content bytes.
2209
2210# Memory Versions
2211
2212## List memory versions
2213
2214**get** `/v1/memory_stores/{memory_store_id}/memory_versions`
2215
2216List memory versions
2217
2218### Path Parameters
2219
2220- `memory_store_id: string`
2221
2222### Query Parameters
2223
2224- `api_key_id: optional string`
2225
2226 Query parameter for api_key_id
2227
2228- `"created_at[gte]": optional string`
2229
2230 Return versions created at or after this time (inclusive).
2231
2232- `"created_at[lte]": optional string`
2233
2234 Return versions created at or before this time (inclusive).
2235
2236- `limit: optional number`
2237
2238 Query parameter for limit
2239
2240- `memory_id: optional string`
2241
2242 Query parameter for memory_id
2243
2244- `operation: optional BetaManagedAgentsMemoryVersionOperation`
2245
2246 Query parameter for operation
2247
2248 - `"created"`
2249
2250 - `"modified"`
2251
2252 - `"deleted"`
2253
2254- `page: optional string`
2255
2256 Query parameter for page
2257
2258- `service_account_id: optional string`
2259
2260 Query parameter for service_account_id
2261
2262- `session_id: optional string`
2263
2264 Query parameter for session_id
2265
2266- `view: optional BetaManagedAgentsMemoryView`
2267
2268 Query parameter for view
2269
2270 - `"basic"`
2271
2272 - `"full"`
2273
2274### Header Parameters
2275
2276- `"anthropic-beta": optional array of AnthropicBeta`
2277
2278 Optional header to specify the beta version(s) you want to use.
2279
2280 - `string`
2281
2282 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
2283
2284 - `"message-batches-2024-09-24"`
2285
2286 - `"prompt-caching-2024-07-31"`
2287
2288 - `"computer-use-2024-10-22"`
2289
2290 - `"computer-use-2025-01-24"`
2291
2292 - `"pdfs-2024-09-25"`
2293
2294 - `"token-counting-2024-11-01"`
2295
2296 - `"token-efficient-tools-2025-02-19"`
2297
2298 - `"output-128k-2025-02-19"`
2299
2300 - `"files-api-2025-04-14"`
2301
2302 - `"mcp-client-2025-04-04"`
2303
2304 - `"mcp-client-2025-11-20"`
2305
2306 - `"dev-full-thinking-2025-05-14"`
2307
2308 - `"interleaved-thinking-2025-05-14"`
2309
2310 - `"code-execution-2025-05-22"`
2311
2312 - `"extended-cache-ttl-2025-04-11"`
2313
2314 - `"context-1m-2025-08-07"`
2315
2316 - `"context-management-2025-06-27"`
2317
2318 - `"model-context-window-exceeded-2025-08-26"`
2319
2320 - `"skills-2025-10-02"`
2321
2322 - `"fast-mode-2026-02-01"`
2323
2324 - `"output-300k-2026-03-24"`
2325
2326 - `"user-profiles-2026-03-24"`
2327
2328 - `"user-profiles-2026-08-18"`
2329
2330 - `"advisor-tool-2026-03-01"`
2331
2332 - `"managed-agents-2026-04-01"`
2333
2334 - `"cache-diagnosis-2026-04-07"`
2335
2336 - `"dreaming-2026-04-21"`
2337
2338 - `"thinking-token-count-2026-05-13"`
2339
2340 - `"server-side-fallback-2026-06-01"`
2341
2342 - `"server-side-fallback-2026-07-01"`
2343
2344 - `"fallback-credit-2026-06-01"`
2345
2346 - `"fallback-credit-2026-07-01"`
2347
2348 - `"agent-memory-2026-07-22"`
2349
2350 - `"mid-conversation-tool-changes-2026-07-01"`
2351
2352### Returns
2353
2354- `data: optional array of BetaManagedAgentsMemoryVersion`
2355
2356 One page of `memory_version` objects, ordered by `created_at` descending (newest first), with `id` as tiebreak.
2357
2358 - `id: string`
2359
2360 Unique identifier for this version (a `memver_...` value).
2361
2362 - `created_at: string`
2363
2364 A timestamp in RFC 3339 format
2365
2366 - `memory_id: string`
2367
2368 ID of the memory this version snapshots (a `mem_...` value). Remains valid after the memory is deleted; pass it as `memory_id` to [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) to retrieve the full lineage including the `deleted` row.
2369
2370 - `memory_store_id: string`
2371
2372 ID of the memory store this version belongs to (a `memstore_...` value).
2373
2374 - `operation: BetaManagedAgentsMemoryVersionOperation`
2375
2376 The kind of mutation a `memory_version` records. Every non-no-op mutation to a memory appends exactly one version row with one of these values.
2377
2378 - `"created"`
2379
2380 - `"modified"`
2381
2382 - `"deleted"`
2383
2384 - `type: "memory_version"`
2385
2386 - `"memory_version"`
2387
2388 - `content: optional string or null`
2389
23902129 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.
23912130
23922131 - `content_sha256: optional string or null`
from line 2136
23972136
23982137 Size of `content` in bytes as of this version. `null` when `redacted_at` is set or `operation` is `deleted`. Populated regardless of `view` otherwise.
23992138
2139 format: int32
2140
24002141 - `created_by: optional BetaManagedAgentsActor`
24012142
24022143 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).
24032144
2404 - `BetaManagedAgentsSessionActor object { session_id, type }`
2145 - `BetaManagedAgentsSessionActor object`
24052146
24062147 Attribution for a write made by an agent during a session, through the mounted filesystem at `/mnt/memory/`.
24072148
from line 2150
24092150
24102151 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.
24112152
2153 minLength: 1
2154
24122155 - `type: "session_actor"`
24132156
2414 - `"session_actor"`
2415
2416 - `BetaManagedAgentsAPIActor object { api_key_id, type }`
2157 - `BetaManagedAgentsAPIActor object`
24172158
24182159 Attribution for a write made directly via the public API (outside of any session).
24192160
from line 2162
24212162
24222163 ID of the API key that performed the write. This identifies the key, not the secret.
24232164
2165 minLength: 1
2166
24242167 - `type: "api_actor"`
24252168
2426 - `"api_actor"`
2427
2428 - `BetaManagedAgentsUserActor object { type, user_id }`
2169 - `BetaManagedAgentsUserActor object`
24292170
24302171 Attribution for a write made by a human user through the Anthropic Console.
24312172
24322173 - `type: "user_actor"`
24332174
2434 - `"user_actor"`
2435
24362175 - `user_id: string`
24372176
24382177 ID of the user who performed the write (a `user_...` value).
24392178
2440 - `BetaManagedAgentsServiceAccountActor object { service_account_id, type }`
2179 minLength: 1
2180
2181 - `BetaManagedAgentsServiceAccountActor object`
24412182
24422183 Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation.
24432184
from line 2186
24452186
24462187 ID of the service account that performed the write (a `svac_...` value).
24472188
2189 minLength: 1
2190
24482191 - `type: "service_account_actor"`
24492192
2450 - `"service_account_actor"`
2451
24522193 - `path: optional string or null`
24532194
24542195 The memory's path at the time of this write. `null` if and only if `redacted_at` is set.
from line 2198
24572198
24582199 A timestamp in RFC 3339 format
24592200
2201 format: date-time
2202
24602203 - `redacted_by: optional BetaManagedAgentsActor`
24612204
24622205 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).
from line 2208
24652208
24662209 Opaque cursor for the next page (a `page_...` value), or `null` if there are no more results. Pass as `page` on the next request.
24672210
2468### Example
2469
2470```http
2211#### Example
2212
2213```bash
24712214curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memory_versions \
24722215 -H 'anthropic-version: 2023-06-01' \
24732216 -H 'anthropic-beta: agent-memory-2026-07-22' \
24742217 -H "X-Api-Key: $ANTHROPIC_API_KEY"
24752218```
24762219
2477#### Response
2220##### Response (200)
24782221
24792222```json
24802223{
from line 2248
25052248}
25062249```
25072250
2508## Retrieve a memory version
2509
2510**get** `/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}`
2251### Retrieve a memory version
2252
2253**GET** `/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}`
25112254
25122255Retrieve a memory version
25132256
2514### Path Parameters
2257#### Path parameters
25152258
25162259- `memory_store_id: string`
25172260
25182261- `memory_version_id: string`
25192262
2520### Query Parameters
2263#### Query parameters
25212264
25222265- `view: optional BetaManagedAgentsMemoryView`
25232266
from line 2270
25272270
25282271 - `"full"`
25292272
2530### Header Parameters
2273#### Headers
25312274
25322275- `"anthropic-beta": optional array of AnthropicBeta`
25332276
from line 2348
26052348
26062349 - `"mid-conversation-tool-changes-2026-07-01"`
26072350
2608### Returns
2609
2610- `BetaManagedAgentsMemoryVersion object { id, created_at, memory_id, 10 more }`
2351#### Returns
2352
2353- `BetaManagedAgentsMemoryVersion object`
26112354
26122355 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 persist after the memory 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.
26132356
from line 2362
26192362
26202363 A timestamp in RFC 3339 format
26212364
2365 format: date-time
2366
26222367 - `memory_id: string`
26232368
26242369 ID of the memory this version snapshots (a `mem_...` value). Remains valid after the memory is deleted; pass it as `memory_id` to [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) to retrieve the full lineage including the `deleted` row.
from line 2384
26392384
26402385 - `type: "memory_version"`
26412386
2642 - `"memory_version"`
2643
26442387 - `content: optional string or null`
26452388
26462389 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 2396
26532396
26542397 Size of `content` in bytes as of this version. `null` when `redacted_at` is set or `operation` is `deleted`. Populated regardless of `view` otherwise.
26552398
2399 format: int32
2400
26562401 - `created_by: optional BetaManagedAgentsActor`
26572402
26582403 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).
26592404
2660 - `BetaManagedAgentsSessionActor object { session_id, type }`
2405 - `BetaManagedAgentsSessionActor object`
26612406
26622407 Attribution for a write made by an agent during a session, through the mounted filesystem at `/mnt/memory/`.
26632408
from line 2410
26652410
26662411 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.
26672412
2413 minLength: 1
2414
26682415 - `type: "session_actor"`
26692416
2670 - `"session_actor"`
2671
2672 - `BetaManagedAgentsAPIActor object { api_key_id, type }`
2417 - `BetaManagedAgentsAPIActor object`
26732418
26742419 Attribution for a write made directly via the public API (outside of any session).
26752420
from line 2422
26772422
26782423 ID of the API key that performed the write. This identifies the key, not the secret.
26792424
2425 minLength: 1
2426
26802427 - `type: "api_actor"`
26812428
2682 - `"api_actor"`
2683
2684 - `BetaManagedAgentsUserActor object { type, user_id }`
2429 - `BetaManagedAgentsUserActor object`
26852430
26862431 Attribution for a write made by a human user through the Anthropic Console.
26872432
26882433 - `type: "user_actor"`
26892434
2690 - `"user_actor"`
2691
26922435 - `user_id: string`
26932436
26942437 ID of the user who performed the write (a `user_...` value).
26952438
2696 - `BetaManagedAgentsServiceAccountActor object { service_account_id, type }`
2439 minLength: 1
2440
2441 - `BetaManagedAgentsServiceAccountActor object`
26972442
26982443 Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation.
26992444
from line 2446
27012446
27022447 ID of the service account that performed the write (a `svac_...` value).
27032448
2449 minLength: 1
2450
27042451 - `type: "service_account_actor"`
27052452
2706 - `"service_account_actor"`
2707
27082453 - `path: optional string or null`
27092454
27102455 The memory's path at the time of this write. `null` if and only if `redacted_at` is set.
from line 2458
27132458
27142459 A timestamp in RFC 3339 format
27152460
2461 format: date-time
2462
27162463 - `redacted_by: optional BetaManagedAgentsActor`
27172464
27182465 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).
27192466
2720### Example
2721
2722```http
2467#### Example
2468
2469```bash
27232470curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memory_versions/$MEMORY_VERSION_ID \
27242471 -H 'anthropic-version: 2023-06-01' \
27252472 -H 'anthropic-beta: agent-memory-2026-07-22' \
27262473 -H "X-Api-Key: $ANTHROPIC_API_KEY"
27272474```
27282475
2729#### Response
2476##### Response (200)
27302477
27312478```json
27322479{
from line 2499
27522499}
27532500```
27542501
2755## Redact a memory version
2756
2757**post** `/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}/redact`
2502### Redact a memory version
2503
2504**POST** `/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}/redact`
27582505
27592506Redact a memory version
27602507
2761### Path Parameters
2508#### Path parameters
27622509
27632510- `memory_store_id: string`
27642511
27652512- `memory_version_id: string`
27662513
2767### Header Parameters
2514#### Headers
27682515
27692516- `"anthropic-beta": optional array of AnthropicBeta`
27702517
from line 2589
28422589
28432590 - `"mid-conversation-tool-changes-2026-07-01"`
28442591
2845### Returns
2846
2847- `BetaManagedAgentsMemoryVersion object { id, created_at, memory_id, 10 more }`
2592#### Returns
2593
2594- `BetaManagedAgentsMemoryVersion object`
28482595
28492596 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 persist after the memory 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.
28502597
from line 2603
28562603
28572604 A timestamp in RFC 3339 format
28582605
2606 format: date-time
2607
28592608 - `memory_id: string`
28602609
28612610 ID of the memory this version snapshots (a `mem_...` value). Remains valid after the memory is deleted; pass it as `memory_id` to [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) to retrieve the full lineage including the `deleted` row.
from line 2625
28762625
28772626 - `type: "memory_version"`
28782627
2879 - `"memory_version"`
2880
28812628 - `content: optional string or null`
28822629
28832630 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 2637
28902637
28912638 Size of `content` in bytes as of this version. `null` when `redacted_at` is set or `operation` is `deleted`. Populated regardless of `view` otherwise.
28922639
2640 format: int32
2641
28932642 - `created_by: optional BetaManagedAgentsActor`
28942643
28952644 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).
28962645
2897 - `BetaManagedAgentsSessionActor object { session_id, type }`
2646 - `BetaManagedAgentsSessionActor object`
28982647
28992648 Attribution for a write made by an agent during a session, through the mounted filesystem at `/mnt/memory/`.
29002649
from line 2651
29022651
29032652 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.
29042653
2654 minLength: 1
2655
29052656 - `type: "session_actor"`
29062657
2907 - `"session_actor"`
2908
2909 - `BetaManagedAgentsAPIActor object { api_key_id, type }`
2658 - `BetaManagedAgentsAPIActor object`
29102659
29112660 Attribution for a write made directly via the public API (outside of any session).
29122661
from line 2663
29142663
29152664 ID of the API key that performed the write. This identifies the key, not the secret.
29162665
2666 minLength: 1
2667
29172668 - `type: "api_actor"`
29182669
2919 - `"api_actor"`
2920
2921 - `BetaManagedAgentsUserActor object { type, user_id }`
2670 - `BetaManagedAgentsUserActor object`
29222671
29232672 Attribution for a write made by a human user through the Anthropic Console.
29242673
29252674 - `type: "user_actor"`
29262675
2927 - `"user_actor"`
2928
29292676 - `user_id: string`
29302677
29312678 ID of the user who performed the write (a `user_...` value).
29322679
2933 - `BetaManagedAgentsServiceAccountActor object { service_account_id, type }`
2680 minLength: 1
2681
2682 - `BetaManagedAgentsServiceAccountActor object`
29342683
29352684 Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation.
29362685
from line 2687
29382687
29392688 ID of the service account that performed the write (a `svac_...` value).
29402689
2690 minLength: 1
2691
29412692 - `type: "service_account_actor"`
29422693
2943 - `"service_account_actor"`
2944
29452694 - `path: optional string or null`
29462695
29472696 The memory's path at the time of this write. `null` if and only if `redacted_at` is set.
from line 2699
29502699
29512700 A timestamp in RFC 3339 format
29522701
2702 format: date-time
2703
29532704 - `redacted_by: optional BetaManagedAgentsActor`
29542705
29552706 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).
29562707
2957### Example
2958
2959```http
2708#### Example
2709
2710```bash
29602711curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memory_versions/$MEMORY_VERSION_ID/redact \
29612712 -X POST \
29622713 -H 'anthropic-version: 2023-06-01' \
from line 2715
29642715 -H "X-Api-Key: $ANTHROPIC_API_KEY"
29652716```
29662717
2967#### Response
2718##### Response (200)
29682719
29692720```json
29702721{
from line 2740
29892740 }
29902741}
29912742```
2992
2993## Domain Types
2994
2995### Beta Managed Agents Actor
2996
2997- `BetaManagedAgentsActor = BetaManagedAgentsSessionActor or BetaManagedAgentsAPIActor or BetaManagedAgentsUserActor or BetaManagedAgentsServiceAccountActor`
2998
2999 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).
3000
3001 - `BetaManagedAgentsSessionActor object { session_id, type }`
3002
3003 Attribution for a write made by an agent during a session, through the mounted filesystem at `/mnt/memory/`.
3004
3005 - `session_id: string`
3006
3007 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.
3008
3009 - `type: "session_actor"`
3010
3011 - `"session_actor"`
3012
3013 - `BetaManagedAgentsAPIActor object { api_key_id, type }`
3014
3015 Attribution for a write made directly via the public API (outside of any session).
3016
3017 - `api_key_id: string`
3018
3019 ID of the API key that performed the write. This identifies the key, not the secret.
3020
3021 - `type: "api_actor"`
3022
3023 - `"api_actor"`
3024
3025 - `BetaManagedAgentsUserActor object { type, user_id }`
3026
3027 Attribution for a write made by a human user through the Anthropic Console.
3028
3029 - `type: "user_actor"`
3030
3031 - `"user_actor"`
3032
3033 - `user_id: string`
3034
3035 ID of the user who performed the write (a `user_...` value).
3036
3037 - `BetaManagedAgentsServiceAccountActor object { service_account_id, type }`
3038
3039 Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation.
3040
3041 - `service_account_id: string`
3042
3043 ID of the service account that performed the write (a `svac_...` value).
3044
3045 - `type: "service_account_actor"`
3046
3047 - `"service_account_actor"`
3048
3049### Beta Managed Agents API Actor
3050
3051- `BetaManagedAgentsAPIActor object { api_key_id, type }`
3052
3053 Attribution for a write made directly via the public API (outside of any session).
3054
3055 - `api_key_id: string`
3056
3057 ID of the API key that performed the write. This identifies the key, not the secret.
3058
3059 - `type: "api_actor"`
3060
3061 - `"api_actor"`
3062
3063### Beta Managed Agents Memory Version
3064
3065- `BetaManagedAgentsMemoryVersion object { id, created_at, memory_id, 10 more }`
3066
3067 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 persist after the memory 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.
3068
3069 - `id: string`
3070
3071 Unique identifier for this version (a `memver_...` value).
3072
3073 - `created_at: string`
3074
3075 A timestamp in RFC 3339 format
3076
3077 - `memory_id: string`
3078
3079 ID of the memory this version snapshots (a `mem_...` value). Remains valid after the memory is deleted; pass it as `memory_id` to [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) to retrieve the full lineage including the `deleted` row.
3080
3081 - `memory_store_id: string`
3082
3083 ID of the memory store this version belongs to (a `memstore_...` value).
3084
3085 - `operation: BetaManagedAgentsMemoryVersionOperation`
3086
3087 The kind of mutation a `memory_version` records. Every non-no-op mutation to a memory appends exactly one version row with one of these values.
3088
3089 - `"created"`
3090
3091 - `"modified"`
3092
3093 - `"deleted"`
3094
3095 - `type: "memory_version"`
3096
3097 - `"memory_version"`
3098
3099 - `content: optional string or null`
3100
3101 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.
3102
3103 - `content_sha256: optional string or null`
3104
3105 Lowercase hex SHA-256 digest of `content` as of this version (64 characters). `null` when `redacted_at` is set or `operation` is `deleted`. Populated regardless of `view` otherwise.
3106
3107 - `content_size_bytes: optional number or null`
3108
3109 Size of `content` in bytes as of this version. `null` when `redacted_at` is set or `operation` is `deleted`. Populated regardless of `view` otherwise.
3110
3111 - `created_by: optional BetaManagedAgentsActor`
3112
3113 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).
3114
3115 - `BetaManagedAgentsSessionActor object { session_id, type }`
3116
3117 Attribution for a write made by an agent during a session, through the mounted filesystem at `/mnt/memory/`.
3118
3119 - `session_id: string`
3120
3121 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.
3122
3123 - `type: "session_actor"`
3124
3125 - `"session_actor"`
3126
3127 - `BetaManagedAgentsAPIActor object { api_key_id, type }`
3128
3129 Attribution for a write made directly via the public API (outside of any session).
3130
3131 - `api_key_id: string`
3132
3133 ID of the API key that performed the write. This identifies the key, not the secret.
3134
3135 - `type: "api_actor"`
3136
3137 - `"api_actor"`
3138
3139 - `BetaManagedAgentsUserActor object { type, user_id }`
3140
3141 Attribution for a write made by a human user through the Anthropic Console.
3142
3143 - `type: "user_actor"`
3144
3145 - `"user_actor"`
3146
3147 - `user_id: string`
3148
3149 ID of the user who performed the write (a `user_...` value).
3150
3151 - `BetaManagedAgentsServiceAccountActor object { service_account_id, type }`
3152
3153 Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation.
3154
3155 - `service_account_id: string`
3156
3157 ID of the service account that performed the write (a `svac_...` value).
3158
3159 - `type: "service_account_actor"`
3160
3161 - `"service_account_actor"`
3162
3163 - `path: optional string or null`
3164
3165 The memory's path at the time of this write. `null` if and only if `redacted_at` is set.
3166
3167 - `redacted_at: optional string or null`
3168
3169 A timestamp in RFC 3339 format
3170
3171 - `redacted_by: optional BetaManagedAgentsActor`
3172
3173 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).
3174
3175### Beta Managed Agents Memory Version Operation
3176
3177- `BetaManagedAgentsMemoryVersionOperation = "created" or "modified" or "deleted"`
3178
3179 The kind of mutation a `memory_version` records. Every non-no-op mutation to a memory appends exactly one version row with one of these values.
3180
3181 - `"created"`
3182
3183 - `"modified"`
3184
3185 - `"deleted"`
3186
3187### Beta Managed Agents Service Account Actor
3188
3189- `BetaManagedAgentsServiceAccountActor object { service_account_id, type }`
3190
3191 Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation.
3192
3193 - `service_account_id: string`
3194
3195 ID of the service account that performed the write (a `svac_...` value).
3196
3197 - `type: "service_account_actor"`
3198
3199 - `"service_account_actor"`
3200
3201### Beta Managed Agents Session Actor
3202
3203- `BetaManagedAgentsSessionActor object { session_id, type }`
3204
3205 Attribution for a write made by an agent during a session, through the mounted filesystem at `/mnt/memory/`.
3206
3207 - `session_id: string`
3208
3209 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.
3210
3211 - `type: "session_actor"`
3212
3213 - `"session_actor"`
3214
3215### Beta Managed Agents User Actor
3216
3217- `BetaManagedAgentsUserActor object { type, user_id }`
3218
3219 Attribution for a write made by a human user through the Anthropic Console.
3220
3221 - `type: "user_actor"`
3222
3223 - `"user_actor"`
3224
3225 - `user_id: string`
3226
3227 ID of the user who performed the write (a `user_...` value).
32282743
api/beta/memory_stores/archive Changed · +15 / -16 lines
# Archive a memory store ## Path parameters ## Headers ## Returns ## Example ### Response (200) ## Archive a memory store ### Path Parameters ### Header Parameters ### Returns ### Example #### Response
from line 1
1---
2title: Archive a memory store
3url: https://platform.claude.com/docs/en/api/beta/memory_stores/archive
4---
1# Archive a memory store
52
6## Archive a memory store
3**POST** `/v1/memory_stores/{memory_store_id}/archive`
74
8**post** `/v1/memory_stores/{memory_store_id}/archive`
9
105Archive a memory store
116
12### Path Parameters
7## Path parameters
138
149- `memory_store_id: string`
1510
16### Header Parameters
11## Headers
1712
1813- `"anthropic-beta": optional array of AnthropicBeta`
1914
from line 86
9186
9287 - `"mid-conversation-tool-changes-2026-07-01"`
9388
94### Returns
89## Returns
9590
96- `BetaManagedAgentsMemoryStore object { id, created_at, name, 5 more }`
91- `BetaManagedAgentsMemoryStore object`
9792
9893 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.
9994
from line 100
105100
106101 A timestamp in RFC 3339 format
107102
103 format: date-time
104
108105 - `name: string`
109106
110107 Human-readable name for the store. 1–255 characters. The store's mount-path slug under `/mnt/memory/` is derived from this name.
from line 108
111108
112109 - `type: "memory_store"`
113110
114 - `"memory_store"`
115
116111 - `updated_at: string`
117112
118113 A timestamp in RFC 3339 format
119114
115 format: date-time
116
120117 - `archived_at: optional string or null`
121118
122119 A timestamp in RFC 3339 format
123120
121 format: date-time
122
124123 - `description: optional string`
125124
126125 Free-text description of what the store contains, up to 1024 characters. Included in the agent's system prompt when the store is attached, so word it to be useful to the agent. Empty string when unset.
from line 128
129128
130129 Arbitrary key-value tags for your own bookkeeping (such as the end user a store belongs to). Up to 16 pairs; keys 1–64 characters; values up to 512 characters. Returned on retrieve/list but not filterable.
131130
132### Example
131## Example
133132
134```http
133```bash
135134curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/archive \
136135 -X POST \
137136 -H 'anthropic-version: 2023-06-01' \
from line 138
139138 -H "X-Api-Key: $ANTHROPIC_API_KEY"
140139```
141140
142#### Response
141### Response (200)
143142
144143```json
145144{
api/beta/memory_stores/create Changed · +19 / -16 lines
# Create a memory store ## Headers ## Body parameters ## Returns ## Example ### Response (200) ## Create a memory store ### Header Parameters ### Body Parameters ### Returns ### Example #### Response
from line 1
1---
2title: Create a memory store
3url: https://platform.claude.com/docs/en/api/beta/memory_stores/create
4---
1# Create a memory store
52
6## Create a memory store
3**POST** `/v1/memory_stores`
74
8**post** `/v1/memory_stores`
9
105Create a memory store
116
12### Header Parameters
7## Headers
138
149- `"anthropic-beta": optional array of AnthropicBeta`
1510
from line 82
8782
8883 - `"mid-conversation-tool-changes-2026-07-01"`
8984
90### Body Parameters
85## Body parameters
9186
9287- `name: string`
9388
9489 Human-readable name for the store. Required; 1–255 characters; no control characters. The mount-path slug under `/mnt/memory/` is derived from this name (lowercased, non-alphanumeric runs collapsed to a hyphen). Names need not be unique within a workspace.
9590
91 minLength: 1, maxLength: 255
92
9693- `description: optional string`
9794
9895 Free-text description of what the store contains, up to 1024 characters. Included in the agent's system prompt when the store is attached, so word it to be useful to the agent.
9996
97 maxLength: 1024
98
10099- `metadata: optional map[string]`
101100
102101 Arbitrary key-value tags for your own bookkeeping (such as the end user a store belongs to). Up to 16 pairs; keys 1–64 characters; values up to 512 characters. Not visible to the agent.
103102
104### Returns
103## Returns
105104
106- `BetaManagedAgentsMemoryStore object { id, created_at, name, 5 more }`
105- `BetaManagedAgentsMemoryStore object`
107106
108107 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.
109108
from line 114
115114
116115 A timestamp in RFC 3339 format
117116
117 format: date-time
118
118119 - `name: string`
119120
120121 Human-readable name for the store. 1–255 characters. The store's mount-path slug under `/mnt/memory/` is derived from this name.
from line 122
121122
122123 - `type: "memory_store"`
123124
124 - `"memory_store"`
125
126125 - `updated_at: string`
127126
128127 A timestamp in RFC 3339 format
129128
129 format: date-time
130
130131 - `archived_at: optional string or null`
131132
132133 A timestamp in RFC 3339 format
133134
135 format: date-time
136
134137 - `description: optional string`
135138
136139 Free-text description of what the store contains, up to 1024 characters. Included in the agent's system prompt when the store is attached, so word it to be useful to the agent. Empty string when unset.
from line 142
139142
140143 Arbitrary key-value tags for your own bookkeeping (such as the end user a store belongs to). Up to 16 pairs; keys 1–64 characters; values up to 512 characters. Returned on retrieve/list but not filterable.
141144
142### Example
145## Example
143146
144```http
147```bash
145148curl https://api.anthropic.com/v1/memory_stores \
146149 -H 'Content-Type: application/json' \
147150 -H 'anthropic-version: 2023-06-01' \
from line 155
152155 }'
153156```
154157
155#### Response
158### Response (200)
156159
157160```json
158161{
api/beta/memory_stores/delete Changed · +9 / -16 lines
# Delete a memory store ## Path parameters ## Headers ## Returns ## Example ### Response (200) ## Delete a memory store ### Path Parameters ### Header Parameters ### Returns ### Example #### Response
from line 1
1---
2title: Delete a memory store
3url: https://platform.claude.com/docs/en/api/beta/memory_stores/delete
4---
1# Delete a memory store
52
6## Delete a memory store
3**DELETE** `/v1/memory_stores/{memory_store_id}`
74
8**delete** `/v1/memory_stores/{memory_store_id}`
9
105Delete a memory store
116
12### Path Parameters
7## Path parameters
138
149- `memory_store_id: string`
1510
16### Header Parameters
11## Headers
1712
1813- `"anthropic-beta": optional array of AnthropicBeta`
1914
from line 86
9186
9287 - `"mid-conversation-tool-changes-2026-07-01"`
9388
94### Returns
89## Returns
9590
96- `BetaManagedAgentsDeletedMemoryStore object { id, type }`
91- `BetaManagedAgentsDeletedMemoryStore object`
9792
9893 Confirmation that a `memory_store` was deleted.
9994
from line 98
10398
10499 - `type: "memory_store_deleted"`
105100
106 - `"memory_store_deleted"`
101## Example
107102
108### Example
109
110```http
103```bash
111104curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID \
112105 -X DELETE \
113106 -H 'anthropic-version: 2023-06-01' \
from line 108
115108 -H "X-Api-Key: $ANTHROPIC_API_KEY"
116109```
117110
118#### Response
111### Response (200)
119112
120113```json
121114{
api/beta/memory_stores/list Changed · +20 / -15 lines
# List memory stores ## Query parameters ## Headers ## Returns ## Example ### Response (200) ## List memory stores ### Query Parameters ### Header Parameters ### Returns ### Example #### Response
from line 1
1---
2title: List memory stores
3url: https://platform.claude.com/docs/en/api/beta/memory_stores/list
4---
1# List memory stores
52
6## List memory stores
3**GET** `/v1/memory_stores`
74
8**get** `/v1/memory_stores`
9
105List memory stores
116
12### Query Parameters
7## Query parameters
138
149- `"created_at[gte]": optional string`
1510
1611 Return only stores whose `created_at` is at or after this time (inclusive). Sent on the wire as `created_at[gte]`.
1712
13 format: date-time
14
1815- `"created_at[lte]": optional string`
1916
2017 Return only stores whose `created_at` is at or before this time (inclusive). Sent on the wire as `created_at[lte]`.
2118
19 format: date-time
20
2221- `include_archived: optional boolean`
2322
2423 When `true`, archived stores are included in the results. Defaults to `false` (archived stores are excluded).
from line 26
2726
2827 Maximum number of stores to return per page. Must be between 1 and 100. Defaults to 20 when omitted.
2928
29 format: int32
30
3031- `page: optional string`
3132
3233 Opaque pagination cursor (a `page_...` value). Pass the `next_page` value from a previous response to fetch the next page; omit for the first page.
3334
34### Header Parameters
35## Headers
3536
3637- `"anthropic-beta": optional array of AnthropicBeta`
3738
from line 110
109110
110111 - `"mid-conversation-tool-changes-2026-07-01"`
111112
112### Returns
113## Returns
113114
114115- `data: optional array of BetaManagedAgentsMemoryStore`
115116
from line 124
123124
124125 A timestamp in RFC 3339 format
125126
127 format: date-time
128
126129 - `name: string`
127130
128131 Human-readable name for the store. 1–255 characters. The store's mount-path slug under `/mnt/memory/` is derived from this name.
from line 132
129132
130133 - `type: "memory_store"`
131134
132 - `"memory_store"`
133
134135 - `updated_at: string`
135136
136137 A timestamp in RFC 3339 format
137138
139 format: date-time
140
138141 - `archived_at: optional string or null`
139142
140143 A timestamp in RFC 3339 format
141144
145 format: date-time
146
142147 - `description: optional string`
143148
144149 Free-text description of what the store contains, up to 1024 characters. Included in the agent's system prompt when the store is attached, so word it to be useful to the agent. Empty string when unset.
from line 156
151156
152157 Opaque cursor for the next page (a `page_...` value). Pass as `page` on the next request. `null` when there are no more results.
153158
154### Example
159## Example
155160
156```http
161```bash
157162curl https://api.anthropic.com/v1/memory_stores \
158163 -H 'anthropic-version: 2023-06-01' \
159164 -H 'anthropic-beta: agent-memory-2026-07-22' \
from line 165
160165 -H "X-Api-Key: $ANTHROPIC_API_KEY"
161166```
162167
163#### Response
168### Response (200)
164169
165170```json
166171{
api/beta/memory_stores/memories Changed · +141 / -124 lines
### Path parameters ### Query parameters ### Headers ### Body parameters #### Response (200) ### Path parameters ### Query parameters ### Headers #### Response (200) ### Path parameters ### Query parameters ### Headers #### Response (200) ### Path parameters ### Query parameters ### Headers ### Body parameters #### Response (200) ### Path parameters ### Query parameters ### Headers #### Response (200) ## Domain types ### Path Parameters ### Query Parameters ### Header Parameters ### Body Parameters #### Response ### Path Parameters ### Query Parameters ### Header Parameters #### Response ### Path Parameters ### Query Parameters ### Header Parameters #### Response ### Path Parameters ### Query Parameters ### Header Parameters ### Body Parameters #### Response ### Path Parameters ### Query Parameters ### Header Parameters #### Response ## Domain Types
from line 1
1---
2title: Memories
3url: https://platform.claude.com/docs/en/api/beta/memory_stores/memories
4---
5
61# Memories
72
83## Create a memory
94
10**post** `/v1/memory_stores/{memory_store_id}/memories`
5**POST** `/v1/memory_stores/{memory_store_id}/memories`
116
127Create a memory
138
14### Path Parameters
9### Path parameters
1510
1611- `memory_store_id: string`
1712
18### Query Parameters
13### Query parameters
1914
2015- `view: optional BetaManagedAgentsMemoryView`
2116
from line 20
2520
2621 - `"full"`
2722
28### Header Parameters
23### Headers
2924
3025- `"anthropic-beta": optional array of AnthropicBeta`
3126
from line 98
10398
10499 - `"mid-conversation-tool-changes-2026-07-01"`
105100
106### Body Parameters
101### Body parameters
107102
108103- `content: string or null`
109104
from line 108
113108
114109 Hierarchical path for the new memory, e.g. `/projects/foo/notes.md`. Must start with `/`, contain at least one non-empty segment, and be at most 1,024 bytes. Must not contain empty segments, `.` or `..` segments, control or format characters, and must be NFC-normalized. Paths are case-sensitive.
115110
111 minLength: 2, maxLength: 1024
112
116113### Returns
117114
118- `BetaManagedAgentsMemory object { id, content_sha256, content_size_bytes, 7 more }`
115- `BetaManagedAgentsMemory object`
119116
120117 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.
121118
from line 128
131128
132129 Size of `content` in bytes (the UTF-8 plaintext length). Always populated, regardless of `view`.
133130
131 format: int32
132
134133 - `created_at: string`
135134
136135 A timestamp in RFC 3339 format
137136
137 format: date-time
138
138139 - `memory_store_id: string`
139140
140141 ID of the memory store this memory belongs to (a `memstore_...` value).
from line 150
149150
150151 - `type: "memory"`
151152
152 - `"memory"`
153
154153 - `updated_at: string`
155154
156155 A timestamp in RFC 3339 format
157156
157 format: date-time
158
158159 - `content: optional string or null`
159160
160161 The memory's UTF-8 text content. Populated when `view=full`; `null` when `view=basic`. Maximum 100 kB (102,400 bytes).
from line 162
161162
162163### Example
163164
164```http
165```bash
165166curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memories \
166167 -H 'Content-Type: application/json' \
167168 -H 'anthropic-version: 2023-06-01' \
from line 174
173174 }'
174175```
175176
176#### Response
177#### Response (200)
177178
178179```json
179180{
from line 193
192193
193194## List memories
194195
195**get** `/v1/memory_stores/{memory_store_id}/memories`
196**GET** `/v1/memory_stores/{memory_store_id}/memories`
196197
197198List memories
198199
199### Path Parameters
200### Path parameters
200201
201202- `memory_store_id: string`
202203
203### Query Parameters
204### Query parameters
204205
205206- `depth: optional number`
206207
207208 `0` (or omitted) returns all descendants below `path_prefix` (recursive). `1` returns immediate children only; deeper entries roll up as `memory_prefix` items. `depth=1` behaves like `ls`; omitting `depth` behaves like `find`.
208209
210 format: int32
211
209212- `limit: optional number`
210213
211214 Maximum number of items to return per page. Must be between 1 and 100. Defaults to 20 when omitted. Capped at 20 when `view=full`. Both `memory` and `memory_prefix` items count toward the limit.
212215
216 format: int32
217
213218- `page: optional string`
214219
215220 Opaque pagination cursor (a `page_...` value). Pass the `next_page` value from a previous response to fetch the next page; omit for the first page.
from line 231
226231
227232 - `"full"`
228233
229### Header Parameters
234### Headers
230235
231236- `"anthropic-beta": optional array of AnthropicBeta`
232237
from line 315
310315
311316 One page of results. Each item is either a `memory` object or, when `depth` was set, a `memory_prefix` rollup marker. Items are returned in a stable, server-defined order.
312317
313 - `BetaManagedAgentsMemory object { id, content_sha256, content_size_bytes, 7 more }`
318 - `BetaManagedAgentsMemory object`
314319
315320 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.
316321
from line 331
326331
327332 Size of `content` in bytes (the UTF-8 plaintext length). Always populated, regardless of `view`.
328333
334 format: int32
335
329336 - `created_at: string`
330337
331338 A timestamp in RFC 3339 format
332339
340 format: date-time
341
333342 - `memory_store_id: string`
334343
335344 ID of the memory store this memory belongs to (a `memstore_...` value).
from line 353
344353
345354 - `type: "memory"`
346355
347 - `"memory"`
348
349356 - `updated_at: string`
350357
351358 A timestamp in RFC 3339 format
352359
360 format: date-time
361
353362 - `content: optional string or null`
354363
355364 The memory's UTF-8 text content. Populated when `view=full`; `null` when `view=basic`. Maximum 100 kB (102,400 bytes).
356365
357 - `BetaManagedAgentsMemoryPrefix object { path, type }`
366 - `BetaManagedAgentsMemoryPrefix object`
358367
359368 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.
360369
from line 373
364373
365374 - `type: "memory_prefix"`
366375
367 - `"memory_prefix"`
368
369376- `next_page: optional string or null`
370377
371378 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 379
372379
373380### Example
374381
375```http
382```bash
376383curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memories \
377384 -H 'anthropic-version: 2023-06-01' \
378385 -H 'anthropic-beta: agent-memory-2026-07-22' \
from line 386
379386 -H "X-Api-Key: $ANTHROPIC_API_KEY"
380387```
381388
382#### Response
389#### Response (200)
383390
384391```json
385392{
from line 410
403410
404411## Retrieve a memory
405412
406**get** `/v1/memory_stores/{memory_store_id}/memories/{memory_id}`
413**GET** `/v1/memory_stores/{memory_store_id}/memories/{memory_id}`
407414
408415Retrieve a memory
409416
410### Path Parameters
417### Path parameters
411418
412419- `memory_store_id: string`
413420
414421- `memory_id: string`
415422
416### Query Parameters
423### Query parameters
417424
418425- `view: optional BetaManagedAgentsMemoryView`
419426
from line 430
423430
424431 - `"full"`
425432
426### Header Parameters
433### Headers
427434
428435- `"anthropic-beta": optional array of AnthropicBeta`
429436
from line 510
503510
504511### Returns
505512
506- `BetaManagedAgentsMemory object { id, content_sha256, content_size_bytes, 7 more }`
513- `BetaManagedAgentsMemory object`
507514
508515 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.
509516
from line 526
519526
520527 Size of `content` in bytes (the UTF-8 plaintext length). Always populated, regardless of `view`.
521528
529 format: int32
530
522531 - `created_at: string`
523532
524533 A timestamp in RFC 3339 format
525534
535 format: date-time
536
526537 - `memory_store_id: string`
527538
528539 ID of the memory store this memory belongs to (a `memstore_...` value).
from line 548
537548
538549 - `type: "memory"`
539550
540 - `"memory"`
541
542551 - `updated_at: string`
543552
544553 A timestamp in RFC 3339 format
545554
555 format: date-time
556
546557 - `content: optional string or null`
547558
548559 The memory's UTF-8 text content. Populated when `view=full`; `null` when `view=basic`. Maximum 100 kB (102,400 bytes).
from line 560
549560
550561### Example
551562
552```http
563```bash
553564curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memories/$MEMORY_ID \
554565 -H 'anthropic-version: 2023-06-01' \
555566 -H 'anthropic-beta: agent-memory-2026-07-22' \
from line 567
556567 -H "X-Api-Key: $ANTHROPIC_API_KEY"
557568```
558569
559#### Response
570#### Response (200)
560571
561572```json
562573{
from line 586
575586
576587## Update a memory
577588
578**post** `/v1/memory_stores/{memory_store_id}/memories/{memory_id}`
589**POST** `/v1/memory_stores/{memory_store_id}/memories/{memory_id}`
579590
580591Update a memory
581592
582### Path Parameters
593### Path parameters
583594
584595- `memory_store_id: string`
585596
586597- `memory_id: string`
587598
588### Query Parameters
599### Query parameters
589600
590601- `view: optional BetaManagedAgentsMemoryView`
591602
from line 606
595606
596607 - `"full"`
597608
598### Header Parameters
609### Headers
599610
600611- `"anthropic-beta": optional array of AnthropicBeta`
601612
from line 684
673684
674685 - `"mid-conversation-tool-changes-2026-07-01"`
675686
676### Body Parameters
687### Body parameters
677688
678689- `content: optional string or null`
679690
from line 694
683694
684695 New path for the memory (a rename). Must start with `/`, contain at least one non-empty segment, and be at most 1,024 bytes. Must not contain empty segments, `.` or `..` segments, control or format characters, and must be NFC-normalized. Paths are case-sensitive. The memory's `id` is preserved across renames. Omit to leave the path unchanged.
685696
697 minLength: 2, maxLength: 1024
698
686699- `precondition: optional BetaManagedAgentsPrecondition`
687700
688701 Optimistic-concurrency precondition: the update applies only if the memory's stored `content_sha256` equals the supplied value. On mismatch, the request returns `memory_precondition_failed_error` (HTTP 409); re-read the memory and retry against the fresh state. If the precondition fails but the stored state already exactly matches the requested `content` and `path`, the server returns 200 instead of 409.
from line 702
689702
690703 - `type: "content_sha256"`
691704
692 - `"content_sha256"`
693
694705 - `content_sha256: optional string`
695706
696707 Expected `content_sha256` of the stored memory (64 lowercase hexadecimal characters). Typically the `content_sha256` returned by a prior read or list call. Because the server applies no content normalization, clients can also compute this locally as the SHA-256 of the UTF-8 content bytes.
from line 708
697708
698709### Returns
699710
700- `BetaManagedAgentsMemory object { id, content_sha256, content_size_bytes, 7 more }`
711- `BetaManagedAgentsMemory object`
701712
702713 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.
703714
from line 724
713724
714725 Size of `content` in bytes (the UTF-8 plaintext length). Always populated, regardless of `view`.
715726
727 format: int32
728
716729 - `created_at: string`
717730
718731 A timestamp in RFC 3339 format
719732
733 format: date-time
734
720735 - `memory_store_id: string`
721736
722737 ID of the memory store this memory belongs to (a `memstore_...` value).
from line 746
731746
732747 - `type: "memory"`
733748
734 - `"memory"`
735
736749 - `updated_at: string`
737750
738751 A timestamp in RFC 3339 format
739752
753 format: date-time
754
740755 - `content: optional string or null`
741756
742757 The memory's UTF-8 text content. Populated when `view=full`; `null` when `view=basic`. Maximum 100 kB (102,400 bytes).
from line 758
743758
744759### Example
745760
746```http
761```bash
747762curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memories/$MEMORY_ID \
748763 -H 'Content-Type: application/json' \
749764 -H 'anthropic-version: 2023-06-01' \
from line 767
752767 -d '{}'
753768```
754769
755#### Response
770#### Response (200)
756771
757772```json
758773{
from line 786
771786
772787## Delete a memory
773788
774**delete** `/v1/memory_stores/{memory_store_id}/memories/{memory_id}`
789**DELETE** `/v1/memory_stores/{memory_store_id}/memories/{memory_id}`
775790
776791Delete a memory
777792
778### Path Parameters
793### Path parameters
779794
780795- `memory_store_id: string`
781796
782797- `memory_id: string`
783798
784### Query Parameters
799### Query parameters
785800
786801- `expected_content_sha256: optional string`
787802
788803 Query parameter for expected_content_sha256
789804
790### Header Parameters
805### Headers
791806
792807- `"anthropic-beta": optional array of AnthropicBeta`
793808
from line 882
867882
868883### Returns
869884
870- `BetaManagedAgentsDeletedMemory object { id, type }`
885- `BetaManagedAgentsDeletedMemory object`
871886
872887 Tombstone returned by [Delete a memory](/docs/en/api/beta/memory_stores/memories/delete). The memory's version history persists and remains listable via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) until the store itself is deleted.
873888
from line 892
877892
878893 - `type: "memory_deleted"`
879894
880 - `"memory_deleted"`
881
882895### Example
883896
884```http
897```bash
885898curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memories/$MEMORY_ID \
886899 -X DELETE \
887900 -H 'anthropic-version: 2023-06-01' \
from line 902
889902 -H "X-Api-Key: $ANTHROPIC_API_KEY"
890903```
891904
892#### Response
905#### Response (200)
893906
894907```json
895908{
from line 911
898911}
899912```
900913
901## Domain Types
914## Domain types
902915
903916### Beta Managed Agents Conflict Error
904917
905- `BetaManagedAgentsConflictError object { type, message }`
918- `BetaManagedAgentsConflictError object`
906919
907920 - `type: "conflict_error"`
908921
909 - `"conflict_error"`
910
911922 - `message: optional string`
912923
913924### Beta Managed Agents Content Sha256 Precondition
914925
915- `BetaManagedAgentsContentSha256Precondition object { type, content_sha256 }`
926- `BetaManagedAgentsContentSha256Precondition object`
916927
917928 Optimistic-concurrency precondition: the update applies only if the memory's stored `content_sha256` equals the supplied value. On mismatch, the request returns `memory_precondition_failed_error` (HTTP 409); re-read the memory and retry against the fresh state. If the precondition fails but the stored state already exactly matches the requested `content` and `path`, the server returns 200 instead of 409.
918929
919930 - `type: "content_sha256"`
920931
921 - `"content_sha256"`
922
923932 - `content_sha256: optional string`
924933
925934 Expected `content_sha256` of the stored memory (64 lowercase hexadecimal characters). Typically the `content_sha256` returned by a prior read or list call. Because the server applies no content normalization, clients can also compute this locally as the SHA-256 of the UTF-8 content bytes.
from line 935
926935
927936### Beta Managed Agents Deleted Memory
928937
929- `BetaManagedAgentsDeletedMemory object { id, type }`
938- `BetaManagedAgentsDeletedMemory object`
930939
931940 Tombstone returned by [Delete a memory](/docs/en/api/beta/memory_stores/memories/delete). The memory's version history persists and remains listable via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) until the store itself is deleted.
932941
from line 945
936945
937946 - `type: "memory_deleted"`
938947
939 - `"memory_deleted"`
940
941948### Beta Managed Agents Error
942949
943950- `BetaManagedAgentsError = BetaInvalidRequestError or BetaAuthenticationError or BetaBillingError or 9 more`
944951
945 - `BetaInvalidRequestError object { message, type }`
952 - `BetaInvalidRequestError object`
946953
947954 - `message: string`
948955
956 default: Invalid request
957
949958 - `type: "invalid_request_error"`
950959
951 - `"invalid_request_error"`
960 default: invalid_request_error
952961
953 - `BetaAuthenticationError object { message, type }`
962 - `BetaAuthenticationError object`
954963
955964 - `message: string`
956965
966 default: Authentication error
967
957968 - `type: "authentication_error"`
958969
959 - `"authentication_error"`
970 default: authentication_error
960971
961 - `BetaBillingError object { message, type }`
972 - `BetaBillingError object`
962973
963974 - `message: string`
964975
976 default: Billing error
977
965978 - `type: "billing_error"`
966979
967 - `"billing_error"`
980 default: billing_error
968981
969 - `BetaPermissionError object { message, type }`
982 - `BetaPermissionError object`
970983
971984 - `message: string`
972985
986 default: Permission denied
987
973988 - `type: "permission_error"`
974989
975 - `"permission_error"`
990 default: permission_error
976991
977 - `BetaNotFoundError object { message, type }`
992 - `BetaNotFoundError object`
978993
979994 - `message: string`
980995
996 default: Not found
997
981998 - `type: "not_found_error"`
982999
983 - `"not_found_error"`
1000 default: not_found_error
9841001
985 - `BetaRateLimitError object { message, type }`
1002 - `BetaRateLimitError object`
9861003
9871004 - `message: string`
9881005
1006 default: Rate limited
1007
9891008 - `type: "rate_limit_error"`
9901009
991 - `"rate_limit_error"`
1010 default: rate_limit_error
9921011
993 - `BetaGatewayTimeoutError object { message, type }`
1012 - `BetaGatewayTimeoutError object`
9941013
9951014 - `message: string`
9961015
1016 default: Request timeout
1017
9971018 - `type: "timeout_error"`
9981019
999 - `"timeout_error"`
1020 default: timeout_error
10001021
1001 - `BetaAPIError object { message, type }`
1022 - `BetaAPIError object`
10021023
10031024 - `message: string`
10041025
1026 default: Internal server error
1027
10051028 - `type: "api_error"`
10061029
1007 - `"api_error"`
1030 default: api_error
10081031
1009 - `BetaOverloadedError object { message, type }`
1032 - `BetaOverloadedError object`
10101033
10111034 - `message: string`
10121035
1036 default: Overloaded
1037
10131038 - `type: "overloaded_error"`
10141039
1015 - `"overloaded_error"`
1040 default: overloaded_error
10161041
1017 - `BetaManagedAgentsMemoryPreconditionFailedError object { type, message }`
1042 - `BetaManagedAgentsMemoryPreconditionFailedError object`
10181043
10191044 - `type: "memory_precondition_failed_error"`
10201045
1021 - `"memory_precondition_failed_error"`
1022
10231046 - `message: optional string`
10241047
1025 - `BetaManagedAgentsMemoryPathConflictError object { type, conflicting_memory_id, conflicting_path, message }`
1048 - `BetaManagedAgentsMemoryPathConflictError object`
10261049
10271050 - `type: "memory_path_conflict_error"`
10281051
1029 - `"memory_path_conflict_error"`
1030
10311052 - `conflicting_memory_id: optional string`
10321053
10331054 - `conflicting_path: optional string`
from line 1055
10341055
10351056 - `message: optional string`
10361057
1037 - `BetaManagedAgentsConflictError object { type, message }`
1058 - `BetaManagedAgentsConflictError object`
10381059
10391060 - `type: "conflict_error"`
10401061
1041 - `"conflict_error"`
1042
10431062 - `message: optional string`
10441063
10451064### Beta Managed Agents Memory
10461065
1047- `BetaManagedAgentsMemory object { id, content_sha256, content_size_bytes, 7 more }`
1066- `BetaManagedAgentsMemory object`
10481067
10491068 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.
10501069
from line 1079
10601079
10611080 Size of `content` in bytes (the UTF-8 plaintext length). Always populated, regardless of `view`.
10621081
1082 format: int32
1083
10631084 - `created_at: string`
10641085
10651086 A timestamp in RFC 3339 format
10661087
1088 format: date-time
1089
10671090 - `memory_store_id: string`
10681091
10691092 ID of the memory store this memory belongs to (a `memstore_...` value).
from line 1101
10781101
10791102 - `type: "memory"`
10801103
1081 - `"memory"`
1082
10831104 - `updated_at: string`
10841105
10851106 A timestamp in RFC 3339 format
10861107
1108 format: date-time
1109
10871110 - `content: optional string or null`
10881111
10891112 The memory's UTF-8 text content. Populated when `view=full`; `null` when `view=basic`. Maximum 100 kB (102,400 bytes).
from line 1117
10941117
10951118 One item in a [List memories](/docs/en/api/beta/memory_stores/memories/list) response: either a `memory` object or, when `depth` is set, a `memory_prefix` rollup marker.
10961119
1097 - `BetaManagedAgentsMemory object { id, content_sha256, content_size_bytes, 7 more }`
1120 - `BetaManagedAgentsMemory object`
10981121
10991122 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.
11001123
from line 1133
11101133
11111134 Size of `content` in bytes (the UTF-8 plaintext length). Always populated, regardless of `view`.
11121135
1136 format: int32
1137
11131138 - `created_at: string`
11141139
11151140 A timestamp in RFC 3339 format
11161141
1142 format: date-time
1143
11171144 - `memory_store_id: string`
11181145
11191146 ID of the memory store this memory belongs to (a `memstore_...` value).
from line 1155
11281155
11291156 - `type: "memory"`
11301157
1131 - `"memory"`
1132
11331158 - `updated_at: string`
11341159
11351160 A timestamp in RFC 3339 format
11361161
1162 format: date-time
1163
11371164 - `content: optional string or null`
11381165
11391166 The memory's UTF-8 text content. Populated when `view=full`; `null` when `view=basic`. Maximum 100 kB (102,400 bytes).
11401167
1141 - `BetaManagedAgentsMemoryPrefix object { path, type }`
1168 - `BetaManagedAgentsMemoryPrefix object`
11421169
11431170 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.
11441171
from line 1175
11481175
11491176 - `type: "memory_prefix"`
11501177
1151 - `"memory_prefix"`
1152
11531178### Beta Managed Agents Memory Path Conflict Error
11541179
1155- `BetaManagedAgentsMemoryPathConflictError object { type, conflicting_memory_id, conflicting_path, message }`
1180- `BetaManagedAgentsMemoryPathConflictError object`
11561181
11571182 - `type: "memory_path_conflict_error"`
11581183
1159 - `"memory_path_conflict_error"`
1160
11611184 - `conflicting_memory_id: optional string`
11621185
11631186 - `conflicting_path: optional string`
from line 1189
11661189
11671190### Beta Managed Agents Memory Precondition Failed Error
11681191
1169- `BetaManagedAgentsMemoryPreconditionFailedError object { type, message }`
1192- `BetaManagedAgentsMemoryPreconditionFailedError object`
11701193
11711194 - `type: "memory_precondition_failed_error"`
11721195
1173 - `"memory_precondition_failed_error"`
1174
11751196 - `message: optional string`
11761197
11771198### Beta Managed Agents Memory Prefix
11781199
1179- `BetaManagedAgentsMemoryPrefix object { path, type }`
1200- `BetaManagedAgentsMemoryPrefix object`
11801201
11811202 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.
11821203
from line 1207
11861207
11871208 - `type: "memory_prefix"`
11881209
1189 - `"memory_prefix"`
1190
11911210### Beta Managed Agents Memory View
11921211
11931212- `BetaManagedAgentsMemoryView = "basic" or "full"`
from line 1219
12001219
12011220### Beta Managed Agents Precondition
12021221
1203- `BetaManagedAgentsPrecondition object { type, content_sha256 }`
1222- `BetaManagedAgentsPrecondition object`
12041223
12051224 Optimistic-concurrency precondition: the update applies only if the memory's stored `content_sha256` equals the supplied value. On mismatch, the request returns `memory_precondition_failed_error` (HTTP 409); re-read the memory and retry against the fresh state. If the precondition fails but the stored state already exactly matches the requested `content` and `path`, the server returns 200 instead of 409.
12061225
12071226 - `type: "content_sha256"`
1208
1209 - `"content_sha256"`
12101227
12111228 - `content_sha256: optional string`
12121229
api/beta/memory_stores/memories/create Changed · +19 / -18 lines
# Create a memory ## Path parameters ## Query parameters ## Headers ## Body parameters ## Returns ## Example ### Response (200) ## Create a memory ### Path Parameters ### Query Parameters ### Header Parameters ### Body Parameters ### Returns ### Example #### Response
from line 1
1---
2title: Create a memory
3url: https://platform.claude.com/docs/en/api/beta/memory_stores/memories/create
4---
1# Create a memory
52
6## Create a memory
3**POST** `/v1/memory_stores/{memory_store_id}/memories`
74
8**post** `/v1/memory_stores/{memory_store_id}/memories`
9
105Create a memory
116
12### Path Parameters
7## Path parameters
138
149- `memory_store_id: string`
1510
16### Query Parameters
11## Query parameters
1712
1813- `view: optional BetaManagedAgentsMemoryView`
1914
from line 18
2318
2419 - `"full"`
2520
26### Header Parameters
21## Headers
2722
2823- `"anthropic-beta": optional array of AnthropicBeta`
2924
from line 96
10196
10297 - `"mid-conversation-tool-changes-2026-07-01"`
10398
104### Body Parameters
99## Body parameters
105100
106101- `content: string or null`
107102
from line 106
111106
112107 Hierarchical path for the new memory, e.g. `/projects/foo/notes.md`. Must start with `/`, contain at least one non-empty segment, and be at most 1,024 bytes. Must not contain empty segments, `.` or `..` segments, control or format characters, and must be NFC-normalized. Paths are case-sensitive.
113108
114### Returns
109 minLength: 2, maxLength: 1024
115110
116- `BetaManagedAgentsMemory object { id, content_sha256, content_size_bytes, 7 more }`
111## Returns
117112
113- `BetaManagedAgentsMemory object`
114
118115 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.
119116
120117 - `id: string`
from line 126
129126
130127 Size of `content` in bytes (the UTF-8 plaintext length). Always populated, regardless of `view`.
131128
129 format: int32
130
132131 - `created_at: string`
133132
134133 A timestamp in RFC 3339 format
135134
135 format: date-time
136
136137 - `memory_store_id: string`
137138
138139 ID of the memory store this memory belongs to (a `memstore_...` value).
from line 148
147148
148149 - `type: "memory"`
149150
150 - `"memory"`
151
152151 - `updated_at: string`
153152
154153 A timestamp in RFC 3339 format
155154
155 format: date-time
156
156157 - `content: optional string or null`
157158
158159 The memory's UTF-8 text content. Populated when `view=full`; `null` when `view=basic`. Maximum 100 kB (102,400 bytes).
159160
160### Example
161## Example
161162
162```http
163```bash
163164curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memories \
164165 -H 'Content-Type: application/json' \
165166 -H 'anthropic-version: 2023-06-01' \
from line 172
171172 }'
172173```
173174
174#### Response
175### Response (200)
175176
176177```json
177178{
api/beta/memory_stores/memories/delete Changed · +10 / -17 lines
# Delete a memory ## Path parameters ## Query parameters ## Headers ## Returns ## Example ### Response (200) ## Delete a memory ### Path Parameters ### Query Parameters ### Header Parameters ### Returns ### Example #### Response
from line 1
1---
2title: Delete a memory
3url: https://platform.claude.com/docs/en/api/beta/memory_stores/memories/delete
4---
1# Delete a memory
52
6## Delete a memory
3**DELETE** `/v1/memory_stores/{memory_store_id}/memories/{memory_id}`
74
8**delete** `/v1/memory_stores/{memory_store_id}/memories/{memory_id}`
9
105Delete a memory
116
12### Path Parameters
7## Path parameters
138
149- `memory_store_id: string`
1510
1611- `memory_id: string`
1712
18### Query Parameters
13## Query parameters
1914
2015- `expected_content_sha256: optional string`
2116
2217 Query parameter for expected_content_sha256
2318
24### Header Parameters
19## Headers
2520
2621- `"anthropic-beta": optional array of AnthropicBeta`
2722
from line 94
9994
10095 - `"mid-conversation-tool-changes-2026-07-01"`
10196
102### Returns
97## Returns
10398
104- `BetaManagedAgentsDeletedMemory object { id, type }`
99- `BetaManagedAgentsDeletedMemory object`
105100
106101 Tombstone returned by [Delete a memory](/docs/en/api/beta/memory_stores/memories/delete). The memory's version history persists and remains listable via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) until the store itself is deleted.
107102
from line 106
111106
112107 - `type: "memory_deleted"`
113108
114 - `"memory_deleted"`
109## Example
115110
116### Example
117
118```http
111```bash
119112curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memories/$MEMORY_ID \
120113 -X DELETE \
121114 -H 'anthropic-version: 2023-06-01' \
from line 116
123116 -H "X-Api-Key: $ANTHROPIC_API_KEY"
124117```
125118
126#### Response
119### Response (200)
127120
128121```json
129122{
api/beta/memory_stores/memories/list Changed · +23 / -22 lines
# List memories ## Path parameters ## Query parameters ## Headers ## Returns ## Example ### Response (200) ## List memories ### Path Parameters ### Query Parameters ### Header Parameters ### Returns ### Example #### Response
from line 1
1---
2title: List memories
3url: https://platform.claude.com/docs/en/api/beta/memory_stores/memories/list
4---
1# List memories
52
6## List memories
3**GET** `/v1/memory_stores/{memory_store_id}/memories`
74
8**get** `/v1/memory_stores/{memory_store_id}/memories`
9
105List memories
116
12### Path Parameters
7## Path parameters
138
149- `memory_store_id: string`
1510
16### Query Parameters
11## Query parameters
1712
1813- `depth: optional number`
1914
2015 `0` (or omitted) returns all descendants below `path_prefix` (recursive). `1` returns immediate children only; deeper entries roll up as `memory_prefix` items. `depth=1` behaves like `ls`; omitting `depth` behaves like `find`.
2116
17 format: int32
18
2219- `limit: optional number`
2320
2421 Maximum number of items to return per page. Must be between 1 and 100. Defaults to 20 when omitted. Capped at 20 when `view=full`. Both `memory` and `memory_prefix` items count toward the limit.
2522
23 format: int32
24
2625- `page: optional string`
2726
2827 Opaque pagination cursor (a `page_...` value). Pass the `next_page` value from a previous response to fetch the next page; omit for the first page.
from line 38
3938
4039 - `"full"`
4140
42### Header Parameters
41## Headers
4342
4443- `"anthropic-beta": optional array of AnthropicBeta`
4544
from line 116
117116
118117 - `"mid-conversation-tool-changes-2026-07-01"`
119118
120### Returns
119## Returns
121120
122121- `data: optional array of BetaManagedAgentsMemoryListItem`
123122
124123 One page of results. Each item is either a `memory` object or, when `depth` was set, a `memory_prefix` rollup marker. Items are returned in a stable, server-defined order.
125124
126 - `BetaManagedAgentsMemory object { id, content_sha256, content_size_bytes, 7 more }`
125 - `BetaManagedAgentsMemory object`
127126
128127 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.
129128
from line 138
139138
140139 Size of `content` in bytes (the UTF-8 plaintext length). Always populated, regardless of `view`.
141140
141 format: int32
142
142143 - `created_at: string`
143144
144145 A timestamp in RFC 3339 format
145146
147 format: date-time
148
146149 - `memory_store_id: string`
147150
148151 ID of the memory store this memory belongs to (a `memstore_...` value).
from line 160
157160
158161 - `type: "memory"`
159162
160 - `"memory"`
161
162163 - `updated_at: string`
163164
164165 A timestamp in RFC 3339 format
165166
167 format: date-time
168
166169 - `content: optional string or null`
167170
168171 The memory's UTF-8 text content. Populated when `view=full`; `null` when `view=basic`. Maximum 100 kB (102,400 bytes).
169172
170 - `BetaManagedAgentsMemoryPrefix object { path, type }`
173 - `BetaManagedAgentsMemoryPrefix object`
171174
172175 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.
173176
from line 180
177180
178181 - `type: "memory_prefix"`
179182
180 - `"memory_prefix"`
181
182183- `next_page: optional string or null`
183184
184185 Opaque cursor for the next page (a `page_...` value), or `null` if there are no more results. Pass as `page` on the next request.
185186
186### Example
187## Example
187188
188```http
189```bash
189190curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memories \
190191 -H 'anthropic-version: 2023-06-01' \
191192 -H 'anthropic-beta: agent-memory-2026-07-22' \
from line 193
192193 -H "X-Api-Key: $ANTHROPIC_API_KEY"
193194```
194195
195#### Response
196### Response (200)
196197
197198```json
198199{
api/beta/memory_stores/memories/retrieve Changed · +16 / -17 lines
# Retrieve a memory ## Path parameters ## Query parameters ## Headers ## Returns ## Example ### Response (200) ## Retrieve a memory ### Path Parameters ### Query Parameters ### Header Parameters ### Returns ### Example #### Response
from line 1
1---
2title: Retrieve a memory
3url: https://platform.claude.com/docs/en/api/beta/memory_stores/memories/retrieve
4---
1# Retrieve a memory
52
6## Retrieve a memory
3**GET** `/v1/memory_stores/{memory_store_id}/memories/{memory_id}`
74
8**get** `/v1/memory_stores/{memory_store_id}/memories/{memory_id}`
9
105Retrieve a memory
116
12### Path Parameters
7## Path parameters
138
149- `memory_store_id: string`
1510
1611- `memory_id: string`
1712
18### Query Parameters
13## Query parameters
1914
2015- `view: optional BetaManagedAgentsMemoryView`
2116
from line 20
2520
2621 - `"full"`
2722
28### Header Parameters
23## Headers
2924
3025- `"anthropic-beta": optional array of AnthropicBeta`
3126
from line 98
10398
10499 - `"mid-conversation-tool-changes-2026-07-01"`
105100
106### Returns
101## Returns
107102
108- `BetaManagedAgentsMemory object { id, content_sha256, content_size_bytes, 7 more }`
103- `BetaManagedAgentsMemory object`
109104
110105 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.
111106
from line 116
121116
122117 Size of `content` in bytes (the UTF-8 plaintext length). Always populated, regardless of `view`.
123118
119 format: int32
120
124121 - `created_at: string`
125122
126123 A timestamp in RFC 3339 format
127124
125 format: date-time
126
128127 - `memory_store_id: string`
129128
130129 ID of the memory store this memory belongs to (a `memstore_...` value).
from line 138
139138
140139 - `type: "memory"`
141140
142 - `"memory"`
143
144141 - `updated_at: string`
145142
146143 A timestamp in RFC 3339 format
147144
145 format: date-time
146
148147 - `content: optional string or null`
149148
150149 The memory's UTF-8 text content. Populated when `view=full`; `null` when `view=basic`. Maximum 100 kB (102,400 bytes).
151150
152### Example
151## Example
153152
154```http
153```bash
155154curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memories/$MEMORY_ID \
156155 -H 'anthropic-version: 2023-06-01' \
157156 -H 'anthropic-beta: agent-memory-2026-07-22' \
from line 157
158157 -H "X-Api-Key: $ANTHROPIC_API_KEY"
159158```
160159
161#### Response
160### Response (200)
162161
163162```json
164163{
api/beta/memory_stores/memories/update Changed · +19 / -20 lines
# Update a memory ## Path parameters ## Query parameters ## Headers ## Body parameters ## Returns ## Example ### Response (200) ## Update a memory ### Path Parameters ### Query Parameters ### Header Parameters ### Body Parameters ### Returns ### Example #### Response
from line 1
1---
2title: Update a memory
3url: https://platform.claude.com/docs/en/api/beta/memory_stores/memories/update
4---
1# Update a memory
52
6## Update a memory
3**POST** `/v1/memory_stores/{memory_store_id}/memories/{memory_id}`
74
8**post** `/v1/memory_stores/{memory_store_id}/memories/{memory_id}`
9
105Update a memory
116
12### Path Parameters
7## Path parameters
138
149- `memory_store_id: string`
1510
1611- `memory_id: string`
1712
18### Query Parameters
13## Query parameters
1914
2015- `view: optional BetaManagedAgentsMemoryView`
2116
from line 20
2520
2621 - `"full"`
2722
28### Header Parameters
23## Headers
2924
3025- `"anthropic-beta": optional array of AnthropicBeta`
3126
from line 98
10398
10499 - `"mid-conversation-tool-changes-2026-07-01"`
105100
106### Body Parameters
101## Body parameters
107102
108103- `content: optional string or null`
109104
from line 108
113108
114109 New path for the memory (a rename). Must start with `/`, contain at least one non-empty segment, and be at most 1,024 bytes. Must not contain empty segments, `.` or `..` segments, control or format characters, and must be NFC-normalized. Paths are case-sensitive. The memory's `id` is preserved across renames. Omit to leave the path unchanged.
115110
111 minLength: 2, maxLength: 1024
112
116113- `precondition: optional BetaManagedAgentsPrecondition`
117114
118115 Optimistic-concurrency precondition: the update applies only if the memory's stored `content_sha256` equals the supplied value. On mismatch, the request returns `memory_precondition_failed_error` (HTTP 409); re-read the memory and retry against the fresh state. If the precondition fails but the stored state already exactly matches the requested `content` and `path`, the server returns 200 instead of 409.
from line 116
119116
120117 - `type: "content_sha256"`
121118
122 - `"content_sha256"`
123
124119 - `content_sha256: optional string`
125120
126121 Expected `content_sha256` of the stored memory (64 lowercase hexadecimal characters). Typically the `content_sha256` returned by a prior read or list call. Because the server applies no content normalization, clients can also compute this locally as the SHA-256 of the UTF-8 content bytes.
127122
128### Returns
123## Returns
129124
130- `BetaManagedAgentsMemory object { id, content_sha256, content_size_bytes, 7 more }`
125- `BetaManagedAgentsMemory object`
131126
132127 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.
133128
from line 138
143138
144139 Size of `content` in bytes (the UTF-8 plaintext length). Always populated, regardless of `view`.
145140
141 format: int32
142
146143 - `created_at: string`
147144
148145 A timestamp in RFC 3339 format
149146
147 format: date-time
148
150149 - `memory_store_id: string`
151150
152151 ID of the memory store this memory belongs to (a `memstore_...` value).
from line 160
161160
162161 - `type: "memory"`
163162
164 - `"memory"`
165
166163 - `updated_at: string`
167164
168165 A timestamp in RFC 3339 format
169166
167 format: date-time
168
170169 - `content: optional string or null`
171170
172171 The memory's UTF-8 text content. Populated when `view=full`; `null` when `view=basic`. Maximum 100 kB (102,400 bytes).
173172
174### Example
173## Example
175174
176```http
175```bash
177176curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memories/$MEMORY_ID \
178177 -H 'Content-Type: application/json' \
179178 -H 'anthropic-version: 2023-06-01' \
from line 181
182181 -d '{}'
183182```
184183
185#### Response
184### Response (200)
186185
187186```json
188187{
api/beta/memory_stores/memory_versions Changed · +123 / -106 lines
### Path parameters ### Query parameters ### Headers #### Response (200) ### Path parameters ### Query parameters ### Headers #### Response (200) ### Path parameters ### Headers #### Response (200) ## Domain types ### Path Parameters ### Query Parameters ### Header Parameters #### Response ### Path Parameters ### Query Parameters ### Header Parameters #### Response ### Path Parameters ### Header Parameters #### Response ## Domain Types
from line 1
1---
2title: Memory Versions
3url: https://platform.claude.com/docs/en/api/beta/memory_stores/memory_versions
4---
5
61# Memory Versions
72
83## List memory versions
94
10**get** `/v1/memory_stores/{memory_store_id}/memory_versions`
5**GET** `/v1/memory_stores/{memory_store_id}/memory_versions`
116
127List memory versions
138
14### Path Parameters
9### Path parameters
1510
1611- `memory_store_id: string`
1712
18### Query Parameters
13### Query parameters
1914
2015- `api_key_id: optional string`
2116
from line 20
2520
2621 Return versions created at or after this time (inclusive).
2722
23 format: date-time
24
2825- `"created_at[lte]": optional string`
2926
3027 Return versions created at or before this time (inclusive).
3128
29 format: date-time
30
3231- `limit: optional number`
3332
3433 Query parameter for limit
3534
35 format: int32
36
3637- `memory_id: optional string`
3738
3839 Query parameter for memory_id
from line 68
6768
6869 - `"full"`
6970
70### Header Parameters
71### Headers
7172
7273- `"anthropic-beta": optional array of AnthropicBeta`
7374
from line 160
159160
160161 A timestamp in RFC 3339 format
161162
163 format: date-time
164
162165 - `memory_id: string`
163166
164167 ID of the memory this version snapshots (a `mem_...` value). Remains valid after the memory is deleted; pass it as `memory_id` to [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) to retrieve the full lineage including the `deleted` row.
from line 182
179182
180183 - `type: "memory_version"`
181184
182 - `"memory_version"`
183
184185 - `content: optional string or null`
185186
186187 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 194
193194
194195 Size of `content` in bytes as of this version. `null` when `redacted_at` is set or `operation` is `deleted`. Populated regardless of `view` otherwise.
195196
197 format: int32
198
196199 - `created_by: optional BetaManagedAgentsActor`
197200
198201 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).
199202
200 - `BetaManagedAgentsSessionActor object { session_id, type }`
203 - `BetaManagedAgentsSessionActor object`
201204
202205 Attribution for a write made by an agent during a session, through the mounted filesystem at `/mnt/memory/`.
203206
from line 208
205208
206209 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.
207210
211 minLength: 1
212
208213 - `type: "session_actor"`
209214
210 - `"session_actor"`
215 - `BetaManagedAgentsAPIActor object`
211216
212 - `BetaManagedAgentsAPIActor object { api_key_id, type }`
213
214217 Attribution for a write made directly via the public API (outside of any session).
215218
216219 - `api_key_id: string`
from line 220
217220
218221 ID of the API key that performed the write. This identifies the key, not the secret.
219222
223 minLength: 1
224
220225 - `type: "api_actor"`
221226
222 - `"api_actor"`
227 - `BetaManagedAgentsUserActor object`
223228
224 - `BetaManagedAgentsUserActor object { type, user_id }`
225
226229 Attribution for a write made by a human user through the Anthropic Console.
227230
228231 - `type: "user_actor"`
229232
230 - `"user_actor"`
231
232233 - `user_id: string`
233234
234235 ID of the user who performed the write (a `user_...` value).
235236
236 - `BetaManagedAgentsServiceAccountActor object { service_account_id, type }`
237 minLength: 1
237238
239 - `BetaManagedAgentsServiceAccountActor object`
240
238241 Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation.
239242
240243 - `service_account_id: string`
from line 244
241244
242245 ID of the service account that performed the write (a `svac_...` value).
243246
247 minLength: 1
248
244249 - `type: "service_account_actor"`
245250
246 - `"service_account_actor"`
247
248251 - `path: optional string or null`
249252
250253 The memory's path at the time of this write. `null` if and only if `redacted_at` is set.
from line 256
253256
254257 A timestamp in RFC 3339 format
255258
259 format: date-time
260
256261 - `redacted_by: optional BetaManagedAgentsActor`
257262
258263 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).
from line 268
263268
264269### Example
265270
266```http
271```bash
267272curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memory_versions \
268273 -H 'anthropic-version: 2023-06-01' \
269274 -H 'anthropic-beta: agent-memory-2026-07-22' \
from line 275
270275 -H "X-Api-Key: $ANTHROPIC_API_KEY"
271276```
272277
273#### Response
278#### Response (200)
274279
275280```json
276281{
from line 308
303308
304309## Retrieve a memory version
305310
306**get** `/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}`
311**GET** `/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}`
307312
308313Retrieve a memory version
309314
310### Path Parameters
315### Path parameters
311316
312317- `memory_store_id: string`
313318
314319- `memory_version_id: string`
315320
316### Query Parameters
321### Query parameters
317322
318323- `view: optional BetaManagedAgentsMemoryView`
319324
from line 328
323328
324329 - `"full"`
325330
326### Header Parameters
331### Headers
327332
328333- `"anthropic-beta": optional array of AnthropicBeta`
329334
from line 408
403408
404409### Returns
405410
406- `BetaManagedAgentsMemoryVersion object { id, created_at, memory_id, 10 more }`
411- `BetaManagedAgentsMemoryVersion object`
407412
408413 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 persist after the memory 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.
409414
from line 420
415420
416421 A timestamp in RFC 3339 format
417422
423 format: date-time
424
418425 - `memory_id: string`
419426
420427 ID of the memory this version snapshots (a `mem_...` value). Remains valid after the memory is deleted; pass it as `memory_id` to [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) to retrieve the full lineage including the `deleted` row.
from line 442
435442
436443 - `type: "memory_version"`
437444
438 - `"memory_version"`
439
440445 - `content: optional string or null`
441446
442447 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 454
449454
450455 Size of `content` in bytes as of this version. `null` when `redacted_at` is set or `operation` is `deleted`. Populated regardless of `view` otherwise.
451456
457 format: int32
458
452459 - `created_by: optional BetaManagedAgentsActor`
453460
454461 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).
455462
456 - `BetaManagedAgentsSessionActor object { session_id, type }`
463 - `BetaManagedAgentsSessionActor object`
457464
458465 Attribution for a write made by an agent during a session, through the mounted filesystem at `/mnt/memory/`.
459466
from line 468
461468
462469 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.
463470
471 minLength: 1
472
464473 - `type: "session_actor"`
465474
466 - `"session_actor"`
475 - `BetaManagedAgentsAPIActor object`
467476
468 - `BetaManagedAgentsAPIActor object { api_key_id, type }`
469
470477 Attribution for a write made directly via the public API (outside of any session).
471478
472479 - `api_key_id: string`
from line 480
473480
474481 ID of the API key that performed the write. This identifies the key, not the secret.
475482
483 minLength: 1
484
476485 - `type: "api_actor"`
477486
478 - `"api_actor"`
487 - `BetaManagedAgentsUserActor object`
479488
480 - `BetaManagedAgentsUserActor object { type, user_id }`
481
482489 Attribution for a write made by a human user through the Anthropic Console.
483490
484491 - `type: "user_actor"`
485492
486 - `"user_actor"`
487
488493 - `user_id: string`
489494
490495 ID of the user who performed the write (a `user_...` value).
491496
492 - `BetaManagedAgentsServiceAccountActor object { service_account_id, type }`
497 minLength: 1
493498
499 - `BetaManagedAgentsServiceAccountActor object`
500
494501 Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation.
495502
496503 - `service_account_id: string`
from line 504
497504
498505 ID of the service account that performed the write (a `svac_...` value).
499506
507 minLength: 1
508
500509 - `type: "service_account_actor"`
501510
502 - `"service_account_actor"`
503
504511 - `path: optional string or null`
505512
506513 The memory's path at the time of this write. `null` if and only if `redacted_at` is set.
from line 516
509516
510517 A timestamp in RFC 3339 format
511518
519 format: date-time
520
512521 - `redacted_by: optional BetaManagedAgentsActor`
513522
514523 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).
from line 524
515524
516525### Example
517526
518```http
527```bash
519528curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memory_versions/$MEMORY_VERSION_ID \
520529 -H 'anthropic-version: 2023-06-01' \
521530 -H 'anthropic-beta: agent-memory-2026-07-22' \
from line 531
522531 -H "X-Api-Key: $ANTHROPIC_API_KEY"
523532```
524533
525#### Response
534#### Response (200)
526535
527536```json
528537{
from line 559
550559
551560## Redact a memory version
552561
553**post** `/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}/redact`
562**POST** `/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}/redact`
554563
555564Redact a memory version
556565
557### Path Parameters
566### Path parameters
558567
559568- `memory_store_id: string`
560569
561570- `memory_version_id: string`
562571
563### Header Parameters
572### Headers
564573
565574- `"anthropic-beta": optional array of AnthropicBeta`
566575
from line 649
640649
641650### Returns
642651
643- `BetaManagedAgentsMemoryVersion object { id, created_at, memory_id, 10 more }`
652- `BetaManagedAgentsMemoryVersion object`
644653
645654 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 persist after the memory 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.
646655
from line 661
652661
653662 A timestamp in RFC 3339 format
654663
664 format: date-time
665
655666 - `memory_id: string`
656667
657668 ID of the memory this version snapshots (a `mem_...` value). Remains valid after the memory is deleted; pass it as `memory_id` to [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) to retrieve the full lineage including the `deleted` row.
from line 683
672683
673684 - `type: "memory_version"`
674685
675 - `"memory_version"`
676
677686 - `content: optional string or null`
678687
679688 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 695
686695
687696 Size of `content` in bytes as of this version. `null` when `redacted_at` is set or `operation` is `deleted`. Populated regardless of `view` otherwise.
688697
698 format: int32
699
689700 - `created_by: optional BetaManagedAgentsActor`
690701
691702 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).
692703
693 - `BetaManagedAgentsSessionActor object { session_id, type }`
704 - `BetaManagedAgentsSessionActor object`
694705
695706 Attribution for a write made by an agent during a session, through the mounted filesystem at `/mnt/memory/`.
696707
from line 709
698709
699710 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.
700711
712 minLength: 1
713
701714 - `type: "session_actor"`
702715
703 - `"session_actor"`
716 - `BetaManagedAgentsAPIActor object`
704717
705 - `BetaManagedAgentsAPIActor object { api_key_id, type }`
706
707718 Attribution for a write made directly via the public API (outside of any session).
708719
709720 - `api_key_id: string`
from line 721
710721
711722 ID of the API key that performed the write. This identifies the key, not the secret.
712723
724 minLength: 1
725
713726 - `type: "api_actor"`
714727
715 - `"api_actor"`
728 - `BetaManagedAgentsUserActor object`
716729
717 - `BetaManagedAgentsUserActor object { type, user_id }`
718
719730 Attribution for a write made by a human user through the Anthropic Console.
720731
721732 - `type: "user_actor"`
722733
723 - `"user_actor"`
724
725734 - `user_id: string`
726735
727736 ID of the user who performed the write (a `user_...` value).
728737
729 - `BetaManagedAgentsServiceAccountActor object { service_account_id, type }`
738 minLength: 1
730739
740 - `BetaManagedAgentsServiceAccountActor object`
741
731742 Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation.
732743
733744 - `service_account_id: string`
from line 745
734745
735746 ID of the service account that performed the write (a `svac_...` value).
736747
748 minLength: 1
749
737750 - `type: "service_account_actor"`
738751
739 - `"service_account_actor"`
740
741752 - `path: optional string or null`
742753
743754 The memory's path at the time of this write. `null` if and only if `redacted_at` is set.
from line 757
746757
747758 A timestamp in RFC 3339 format
748759
760 format: date-time
761
749762 - `redacted_by: optional BetaManagedAgentsActor`
750763
751764 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).
from line 765
752765
753766### Example
754767
755```http
768```bash
756769curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memory_versions/$MEMORY_VERSION_ID/redact \
757770 -X POST \
758771 -H 'anthropic-version: 2023-06-01' \
from line 773
760773 -H "X-Api-Key: $ANTHROPIC_API_KEY"
761774```
762775
763#### Response
776#### Response (200)
764777
765778```json
766779{
from line 799
786799}
787800```
788801
789## Domain Types
802## Domain types
790803
791804### Beta Managed Agents Actor
792805
from line 807
794807
795808 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).
796809
797 - `BetaManagedAgentsSessionActor object { session_id, type }`
810 - `BetaManagedAgentsSessionActor object`
798811
799812 Attribution for a write made by an agent during a session, through the mounted filesystem at `/mnt/memory/`.
800813
from line 815
802815
803816 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.
804817
818 minLength: 1
819
805820 - `type: "session_actor"`
806821
807 - `"session_actor"`
822 - `BetaManagedAgentsAPIActor object`
808823
809 - `BetaManagedAgentsAPIActor object { api_key_id, type }`
810
811824 Attribution for a write made directly via the public API (outside of any session).
812825
813826 - `api_key_id: string`
from line 827
814827
815828 ID of the API key that performed the write. This identifies the key, not the secret.
816829
830 minLength: 1
831
817832 - `type: "api_actor"`
818833
819 - `"api_actor"`
834 - `BetaManagedAgentsUserActor object`
820835
821 - `BetaManagedAgentsUserActor object { type, user_id }`
822
823836 Attribution for a write made by a human user through the Anthropic Console.
824837
825838 - `type: "user_actor"`
826839
827 - `"user_actor"`
828
829840 - `user_id: string`
830841
831842 ID of the user who performed the write (a `user_...` value).
832843
833 - `BetaManagedAgentsServiceAccountActor object { service_account_id, type }`
844 minLength: 1
834845
846 - `BetaManagedAgentsServiceAccountActor object`
847
835848 Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation.
836849
837850 - `service_account_id: string`
from line 851
838851
839852 ID of the service account that performed the write (a `svac_...` value).
840853
854 minLength: 1
855
841856 - `type: "service_account_actor"`
842857
843 - `"service_account_actor"`
844
845858### Beta Managed Agents API Actor
846859
847- `BetaManagedAgentsAPIActor object { api_key_id, type }`
860- `BetaManagedAgentsAPIActor object`
848861
849862 Attribution for a write made directly via the public API (outside of any session).
850863
from line 865
852865
853866 ID of the API key that performed the write. This identifies the key, not the secret.
854867
868 minLength: 1
869
855870 - `type: "api_actor"`
856871
857 - `"api_actor"`
858
859872### Beta Managed Agents Memory Version
860873
861- `BetaManagedAgentsMemoryVersion object { id, created_at, memory_id, 10 more }`
874- `BetaManagedAgentsMemoryVersion object`
862875
863876 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 persist after the memory 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.
864877
from line 883
870883
871884 A timestamp in RFC 3339 format
872885
886 format: date-time
887
873888 - `memory_id: string`
874889
875890 ID of the memory this version snapshots (a `mem_...` value). Remains valid after the memory is deleted; pass it as `memory_id` to [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) to retrieve the full lineage including the `deleted` row.
from line 905
890905
891906 - `type: "memory_version"`
892907
893 - `"memory_version"`
894
895908 - `content: optional string or null`
896909
897910 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 917
904917
905918 Size of `content` in bytes as of this version. `null` when `redacted_at` is set or `operation` is `deleted`. Populated regardless of `view` otherwise.
906919
920 format: int32
921
907922 - `created_by: optional BetaManagedAgentsActor`
908923
909924 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).
910925
911 - `BetaManagedAgentsSessionActor object { session_id, type }`
926 - `BetaManagedAgentsSessionActor object`
912927
913928 Attribution for a write made by an agent during a session, through the mounted filesystem at `/mnt/memory/`.
914929
from line 931
916931
917932 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.
918933
934 minLength: 1
935
919936 - `type: "session_actor"`
920937
921 - `"session_actor"`
938 - `BetaManagedAgentsAPIActor object`
922939
923 - `BetaManagedAgentsAPIActor object { api_key_id, type }`
924
925940 Attribution for a write made directly via the public API (outside of any session).
926941
927942 - `api_key_id: string`
from line 943
928943
929944 ID of the API key that performed the write. This identifies the key, not the secret.
930945
946 minLength: 1
947
931948 - `type: "api_actor"`
932949
933 - `"api_actor"`
950 - `BetaManagedAgentsUserActor object`
934951
935 - `BetaManagedAgentsUserActor object { type, user_id }`
936
937952 Attribution for a write made by a human user through the Anthropic Console.
938953
939954 - `type: "user_actor"`
940955
941 - `"user_actor"`
942
943956 - `user_id: string`
944957
945958 ID of the user who performed the write (a `user_...` value).
946959
947 - `BetaManagedAgentsServiceAccountActor object { service_account_id, type }`
960 minLength: 1
948961
962 - `BetaManagedAgentsServiceAccountActor object`
963
949964 Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation.
950965
951966 - `service_account_id: string`
from line 967
952967
953968 ID of the service account that performed the write (a `svac_...` value).
954969
970 minLength: 1
971
955972 - `type: "service_account_actor"`
956973
957 - `"service_account_actor"`
958
959974 - `path: optional string or null`
960975
961976 The memory's path at the time of this write. `null` if and only if `redacted_at` is set.
from line 979
964979
965980 A timestamp in RFC 3339 format
966981
982 format: date-time
983
967984 - `redacted_by: optional BetaManagedAgentsActor`
968985
969986 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).
from line 999
982999
9831000### Beta Managed Agents Service Account Actor
9841001
985- `BetaManagedAgentsServiceAccountActor object { service_account_id, type }`
1002- `BetaManagedAgentsServiceAccountActor object`
9861003
9871004 Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation.
9881005
from line 1007
9901007
9911008 ID of the service account that performed the write (a `svac_...` value).
9921009
1010 minLength: 1
1011
9931012 - `type: "service_account_actor"`
9941013
995 - `"service_account_actor"`
996
9971014### Beta Managed Agents Session Actor
9981015
999- `BetaManagedAgentsSessionActor object { session_id, type }`
1016- `BetaManagedAgentsSessionActor object`
10001017
10011018 Attribution for a write made by an agent during a session, through the mounted filesystem at `/mnt/memory/`.
10021019
from line 1021
10041021
10051022 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.
10061023
1024 minLength: 1
1025
10071026 - `type: "session_actor"`
10081027
1009 - `"session_actor"`
1010
10111028### Beta Managed Agents User Actor
10121029
1013- `BetaManagedAgentsUserActor object { type, user_id }`
1030- `BetaManagedAgentsUserActor object`
10141031
10151032 Attribution for a write made by a human user through the Anthropic Console.
10161033
10171034 - `type: "user_actor"`
10181035
1019 - `"user_actor"`
1020
10211036 - `user_id: string`
10221037
10231038 ID of the user who performed the write (a `user_...` value).
1039
1040 minLength: 1
10241041
api/beta/memory_stores/memory_versions/list Changed · +35 / -30 lines
# List memory versions ## Path parameters ## Query parameters ## Headers ## Returns ## Example ### Response (200) ## List memory versions ### Path Parameters ### Query Parameters ### Header Parameters ### Returns ### Example #### Response
from line 1
1---
2title: List memory versions
3url: https://platform.claude.com/docs/en/api/beta/memory_stores/memory_versions/list
4---
1# List memory versions
52
6## List memory versions
3**GET** `/v1/memory_stores/{memory_store_id}/memory_versions`
74
8**get** `/v1/memory_stores/{memory_store_id}/memory_versions`
9
105List memory versions
116
12### Path Parameters
7## Path parameters
138
149- `memory_store_id: string`
1510
16### Query Parameters
11## Query parameters
1712
1813- `api_key_id: optional string`
1914
from line 18
2318
2419 Return versions created at or after this time (inclusive).
2520
21 format: date-time
22
2623- `"created_at[lte]": optional string`
2724
2825 Return versions created at or before this time (inclusive).
2926
27 format: date-time
28
3029- `limit: optional number`
3130
3231 Query parameter for limit
3332
33 format: int32
34
3435- `memory_id: optional string`
3536
3637 Query parameter for memory_id
from line 66
6566
6667 - `"full"`
6768
68### Header Parameters
69## Headers
6970
7071- `"anthropic-beta": optional array of AnthropicBeta`
7172
from line 144
143144
144145 - `"mid-conversation-tool-changes-2026-07-01"`
145146
146### Returns
147## Returns
147148
148149- `data: optional array of BetaManagedAgentsMemoryVersion`
149150
from line 158
157158
158159 A timestamp in RFC 3339 format
159160
161 format: date-time
162
160163 - `memory_id: string`
161164
162165 ID of the memory this version snapshots (a `mem_...` value). Remains valid after the memory is deleted; pass it as `memory_id` to [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) to retrieve the full lineage including the `deleted` row.
from line 180
177180
178181 - `type: "memory_version"`
179182
180 - `"memory_version"`
181
182183 - `content: optional string or null`
183184
184185 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 192
191192
192193 Size of `content` in bytes as of this version. `null` when `redacted_at` is set or `operation` is `deleted`. Populated regardless of `view` otherwise.
193194
195 format: int32
196
194197 - `created_by: optional BetaManagedAgentsActor`
195198
196199 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).
197200
198 - `BetaManagedAgentsSessionActor object { session_id, type }`
201 - `BetaManagedAgentsSessionActor object`
199202
200203 Attribution for a write made by an agent during a session, through the mounted filesystem at `/mnt/memory/`.
201204
from line 206
203206
204207 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.
205208
209 minLength: 1
210
206211 - `type: "session_actor"`
207212
208 - `"session_actor"`
213 - `BetaManagedAgentsAPIActor object`
209214
210 - `BetaManagedAgentsAPIActor object { api_key_id, type }`
211
212215 Attribution for a write made directly via the public API (outside of any session).
213216
214217 - `api_key_id: string`
from line 218
215218
216219 ID of the API key that performed the write. This identifies the key, not the secret.
217220
221 minLength: 1
222
218223 - `type: "api_actor"`
219224
220 - `"api_actor"`
225 - `BetaManagedAgentsUserActor object`
221226
222 - `BetaManagedAgentsUserActor object { type, user_id }`
223
224227 Attribution for a write made by a human user through the Anthropic Console.
225228
226229 - `type: "user_actor"`
227230
228 - `"user_actor"`
229
230231 - `user_id: string`
231232
232233 ID of the user who performed the write (a `user_...` value).
233234
234 - `BetaManagedAgentsServiceAccountActor object { service_account_id, type }`
235 minLength: 1
235236
237 - `BetaManagedAgentsServiceAccountActor object`
238
236239 Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation.
237240
238241 - `service_account_id: string`
from line 242
239242
240243 ID of the service account that performed the write (a `svac_...` value).
241244
245 minLength: 1
246
242247 - `type: "service_account_actor"`
243248
244 - `"service_account_actor"`
245
246249 - `path: optional string or null`
247250
248251 The memory's path at the time of this write. `null` if and only if `redacted_at` is set.
from line 254
251254
252255 A timestamp in RFC 3339 format
253256
257 format: date-time
258
254259 - `redacted_by: optional BetaManagedAgentsActor`
255260
256261 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).
from line 264
259264
260265 Opaque cursor for the next page (a `page_...` value), or `null` if there are no more results. Pass as `page` on the next request.
261266
262### Example
267## Example
263268
264```http
269```bash
265270curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memory_versions \
266271 -H 'anthropic-version: 2023-06-01' \
267272 -H 'anthropic-beta: agent-memory-2026-07-22' \
from line 273
268273 -H "X-Api-Key: $ANTHROPIC_API_KEY"
269274```
270275
271#### Response
276### Response (200)
272277
273278```json
274279{
api/beta/memory_stores/memory_versions/redact Changed · +30 / -31 lines
# Redact a memory version ## Path parameters ## Headers ## Returns ## Example ### Response (200) ## Redact a memory version ### Path Parameters ### Header Parameters ### Returns ### Example #### Response
from line 1
1---
2title: Redact a memory version
3url: https://platform.claude.com/docs/en/api/beta/memory_stores/memory_versions/redact
4---
1# Redact a memory version
52
6## Redact a memory version
3**POST** `/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}/redact`
74
8**post** `/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}/redact`
9
105Redact a memory version
116
12### Path Parameters
7## Path parameters
138
149- `memory_store_id: string`
1510
1611- `memory_version_id: string`
1712
18### Header Parameters
13## Headers
1914
2015- `"anthropic-beta": optional array of AnthropicBeta`
2116
from line 88
9388
9489 - `"mid-conversation-tool-changes-2026-07-01"`
9590
96### Returns
91## Returns
9792
98- `BetaManagedAgentsMemoryVersion object { id, created_at, memory_id, 10 more }`
93- `BetaManagedAgentsMemoryVersion object`
9994
10095 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 persist after the memory 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.
10196
from line 102
107102
108103 A timestamp in RFC 3339 format
109104
105 format: date-time
106
110107 - `memory_id: string`
111108
112109 ID of the memory this version snapshots (a `mem_...` value). Remains valid after the memory is deleted; pass it as `memory_id` to [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) to retrieve the full lineage including the `deleted` row.
from line 124
127124
128125 - `type: "memory_version"`
129126
130 - `"memory_version"`
131
132127 - `content: optional string or null`
133128
134129 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 136
141136
142137 Size of `content` in bytes as of this version. `null` when `redacted_at` is set or `operation` is `deleted`. Populated regardless of `view` otherwise.
143138
139 format: int32
140
144141 - `created_by: optional BetaManagedAgentsActor`
145142
146143 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).
147144
148 - `BetaManagedAgentsSessionActor object { session_id, type }`
145 - `BetaManagedAgentsSessionActor object`
149146
150147 Attribution for a write made by an agent during a session, through the mounted filesystem at `/mnt/memory/`.
151148
from line 150
153150
154151 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.
155152
153 minLength: 1
154
156155 - `type: "session_actor"`
157156
158 - `"session_actor"`
157 - `BetaManagedAgentsAPIActor object`
159158
160 - `BetaManagedAgentsAPIActor object { api_key_id, type }`
161
162159 Attribution for a write made directly via the public API (outside of any session).
163160
164161 - `api_key_id: string`
from line 162
165162
166163 ID of the API key that performed the write. This identifies the key, not the secret.
167164
165 minLength: 1
166
168167 - `type: "api_actor"`
169168
170 - `"api_actor"`
169 - `BetaManagedAgentsUserActor object`
171170
172 - `BetaManagedAgentsUserActor object { type, user_id }`
173
174171 Attribution for a write made by a human user through the Anthropic Console.
175172
176173 - `type: "user_actor"`
177174
178 - `"user_actor"`
179
180175 - `user_id: string`
181176
182177 ID of the user who performed the write (a `user_...` value).
183178
184 - `BetaManagedAgentsServiceAccountActor object { service_account_id, type }`
179 minLength: 1
185180
181 - `BetaManagedAgentsServiceAccountActor object`
182
186183 Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation.
187184
188185 - `service_account_id: string`
from line 186
189186
190187 ID of the service account that performed the write (a `svac_...` value).
191188
189 minLength: 1
190
192191 - `type: "service_account_actor"`
193192
194 - `"service_account_actor"`
195
196193 - `path: optional string or null`
197194
198195 The memory's path at the time of this write. `null` if and only if `redacted_at` is set.
from line 198
201198
202199 A timestamp in RFC 3339 format
203200
201 format: date-time
202
204203 - `redacted_by: optional BetaManagedAgentsActor`
205204
206205 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).
207206
208### Example
207## Example
209208
210```http
209```bash
211210curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memory_versions/$MEMORY_VERSION_ID/redact \
212211 -X POST \
213212 -H 'anthropic-version: 2023-06-01' \
from line 214
215214 -H "X-Api-Key: $ANTHROPIC_API_KEY"
216215```
217216
218#### Response
217### Response (200)
219218
220219```json
221220{
api/beta/memory_stores/memory_versions/retrieve Changed · +31 / -32 lines
# Retrieve a memory version ## Path parameters ## Query parameters ## Headers ## Returns ## Example ### Response (200) ## Retrieve a memory version ### Path Parameters ### Query Parameters ### Header Parameters ### Returns ### Example #### Response
from line 1
1---
2title: Retrieve a memory version
3url: https://platform.claude.com/docs/en/api/beta/memory_stores/memory_versions/retrieve
4---
1# Retrieve a memory version
52
6## Retrieve a memory version
3**GET** `/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}`
74
8**get** `/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}`
9
105Retrieve a memory version
116
12### Path Parameters
7## Path parameters
138
149- `memory_store_id: string`
1510
1611- `memory_version_id: string`
1712
18### Query Parameters
13## Query parameters
1914
2015- `view: optional BetaManagedAgentsMemoryView`
2116
from line 20
2520
2621 - `"full"`
2722
28### Header Parameters
23## Headers
2924
3025- `"anthropic-beta": optional array of AnthropicBeta`
3126
from line 98
10398
10499 - `"mid-conversation-tool-changes-2026-07-01"`
105100
106### Returns
101## Returns
107102
108- `BetaManagedAgentsMemoryVersion object { id, created_at, memory_id, 10 more }`
103- `BetaManagedAgentsMemoryVersion object`
109104
110105 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 persist after the memory 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.
111106
from line 112
117112
118113 A timestamp in RFC 3339 format
119114
115 format: date-time
116
120117 - `memory_id: string`
121118
122119 ID of the memory this version snapshots (a `mem_...` value). Remains valid after the memory is deleted; pass it as `memory_id` to [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) to retrieve the full lineage including the `deleted` row.
from line 134
137134
138135 - `type: "memory_version"`
139136
140 - `"memory_version"`
141
142137 - `content: optional string or null`
143138
144139 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 146
151146
152147 Size of `content` in bytes as of this version. `null` when `redacted_at` is set or `operation` is `deleted`. Populated regardless of `view` otherwise.
153148
149 format: int32
150
154151 - `created_by: optional BetaManagedAgentsActor`
155152
156153 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).
157154
158 - `BetaManagedAgentsSessionActor object { session_id, type }`
155 - `BetaManagedAgentsSessionActor object`
159156
160157 Attribution for a write made by an agent during a session, through the mounted filesystem at `/mnt/memory/`.
161158
from line 160
163160
164161 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.
165162
163 minLength: 1
164
166165 - `type: "session_actor"`
167166
168 - `"session_actor"`
167 - `BetaManagedAgentsAPIActor object`
169168
170 - `BetaManagedAgentsAPIActor object { api_key_id, type }`
171
172169 Attribution for a write made directly via the public API (outside of any session).
173170
174171 - `api_key_id: string`
from line 172
175172
176173 ID of the API key that performed the write. This identifies the key, not the secret.
177174
175 minLength: 1
176
178177 - `type: "api_actor"`
179178
180 - `"api_actor"`
179 - `BetaManagedAgentsUserActor object`
181180
182 - `BetaManagedAgentsUserActor object { type, user_id }`
183
184181 Attribution for a write made by a human user through the Anthropic Console.
185182
186183 - `type: "user_actor"`
187184
188 - `"user_actor"`
189
190185 - `user_id: string`
191186
192187 ID of the user who performed the write (a `user_...` value).
193188
194 - `BetaManagedAgentsServiceAccountActor object { service_account_id, type }`
189 minLength: 1
195190
191 - `BetaManagedAgentsServiceAccountActor object`
192
196193 Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation.
197194
198195 - `service_account_id: string`
from line 196
199196
200197 ID of the service account that performed the write (a `svac_...` value).
201198
199 minLength: 1
200
202201 - `type: "service_account_actor"`
203202
204 - `"service_account_actor"`
205
206203 - `path: optional string or null`
207204
208205 The memory's path at the time of this write. `null` if and only if `redacted_at` is set.
from line 208
211208
212209 A timestamp in RFC 3339 format
213210
211 format: date-time
212
214213 - `redacted_by: optional BetaManagedAgentsActor`
215214
216215 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).
217216
218### Example
217## Example
219218
220```http
219```bash
221220curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memory_versions/$MEMORY_VERSION_ID \
222221 -H 'anthropic-version: 2023-06-01' \
223222 -H 'anthropic-beta: agent-memory-2026-07-22' \
from line 223
224223 -H "X-Api-Key: $ANTHROPIC_API_KEY"
225224```
226225
227#### Response
226### Response (200)
228227
229228```json
230229{
api/beta/memory_stores/retrieve Changed · +15 / -16 lines
# Retrieve a memory store ## Path parameters ## Headers ## Returns ## Example ### Response (200) ## Retrieve a memory store ### Path Parameters ### Header Parameters ### Returns ### Example #### Response
from line 1
1---
2title: Retrieve a memory store
3url: https://platform.claude.com/docs/en/api/beta/memory_stores/retrieve
4---
1# Retrieve a memory store
52
6## Retrieve a memory store
3**GET** `/v1/memory_stores/{memory_store_id}`
74
8**get** `/v1/memory_stores/{memory_store_id}`
9
105Retrieve a memory store
116
12### Path Parameters
7## Path parameters
138
149- `memory_store_id: string`
1510
16### Header Parameters
11## Headers
1712
1813- `"anthropic-beta": optional array of AnthropicBeta`
1914
from line 86
9186
9287 - `"mid-conversation-tool-changes-2026-07-01"`
9388
94### Returns
89## Returns
9590
96- `BetaManagedAgentsMemoryStore object { id, created_at, name, 5 more }`
91- `BetaManagedAgentsMemoryStore object`
9792
9893 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.
9994
from line 100
105100
106101 A timestamp in RFC 3339 format
107102
103 format: date-time
104
108105 - `name: string`
109106
110107 Human-readable name for the store. 1–255 characters. The store's mount-path slug under `/mnt/memory/` is derived from this name.
from line 108
111108
112109 - `type: "memory_store"`
113110
114 - `"memory_store"`
115
116111 - `updated_at: string`
117112
118113 A timestamp in RFC 3339 format
119114
115 format: date-time
116
120117 - `archived_at: optional string or null`
121118
122119 A timestamp in RFC 3339 format
123120
121 format: date-time
122
124123 - `description: optional string`
125124
126125 Free-text description of what the store contains, up to 1024 characters. Included in the agent's system prompt when the store is attached, so word it to be useful to the agent. Empty string when unset.
from line 128
129128
130129 Arbitrary key-value tags for your own bookkeeping (such as the end user a store belongs to). Up to 16 pairs; keys 1–64 characters; values up to 512 characters. Returned on retrieve/list but not filterable.
131130
132### Example
131## Example
133132
134```http
133```bash
135134curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID \
136135 -H 'anthropic-version: 2023-06-01' \
137136 -H 'anthropic-beta: agent-memory-2026-07-22' \
from line 137
138137 -H "X-Api-Key: $ANTHROPIC_API_KEY"
139138```
140139
141#### Response
140### Response (200)
142141
143142```json
144143{
api/beta/memory_stores/update Changed · +20 / -17 lines
# Update a memory store ## Path parameters ## Headers ## Body parameters ## Returns ## Example ### Response (200) ## Update a memory store ### Path Parameters ### Header Parameters ### Body Parameters ### Returns ### Example #### Response
from line 1
1---
2title: Update a memory store
3url: https://platform.claude.com/docs/en/api/beta/memory_stores/update
4---
1# Update a memory store
52
6## Update a memory store
3**POST** `/v1/memory_stores/{memory_store_id}`
74
8**post** `/v1/memory_stores/{memory_store_id}`
9
105Update a memory store
116
12### Path Parameters
7## Path parameters
138
149- `memory_store_id: string`
1510
16### Header Parameters
11## Headers
1712
1813- `"anthropic-beta": optional array of AnthropicBeta`
1914
from line 86
9186
9287 - `"mid-conversation-tool-changes-2026-07-01"`
9388
94### Body Parameters
89## Body parameters
9590
9691- `description: optional string or null`
9792
9893 New description for the store, up to 1024 characters. Pass an empty string to clear it.
9994
95 maxLength: 1024
96
10097- `metadata: optional map[string] or null`
10198
10299 Metadata patch. Set a key to a string to upsert it, or to null to delete it. Omit the field to preserve. The stored bag is limited to 16 keys (up to 64 chars each) with values up to 512 chars.
from line 102
105102
106103 New human-readable name for the store. 1–255 characters; no control characters. Renaming changes the slug used for the store's `mount_path` in sessions created after the update.
107104
108### Returns
105 minLength: 1, maxLength: 255
109106
110- `BetaManagedAgentsMemoryStore object { id, created_at, name, 5 more }`
107## Returns
111108
109- `BetaManagedAgentsMemoryStore object`
110
112111 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.
113112
114113 - `id: string`
from line 118
119118
120119 A timestamp in RFC 3339 format
121120
121 format: date-time
122
122123 - `name: string`
123124
124125 Human-readable name for the store. 1–255 characters. The store's mount-path slug under `/mnt/memory/` is derived from this name.
from line 126
125126
126127 - `type: "memory_store"`
127128
128 - `"memory_store"`
129
130129 - `updated_at: string`
131130
132131 A timestamp in RFC 3339 format
133132
133 format: date-time
134
134135 - `archived_at: optional string or null`
135136
136137 A timestamp in RFC 3339 format
137138
139 format: date-time
140
138141 - `description: optional string`
139142
140143 Free-text description of what the store contains, up to 1024 characters. Included in the agent's system prompt when the store is attached, so word it to be useful to the agent. Empty string when unset.
from line 146
143146
144147 Arbitrary key-value tags for your own bookkeeping (such as the end user a store belongs to). Up to 16 pairs; keys 1–64 characters; values up to 512 characters. Returned on retrieve/list but not filterable.
145148
146### Example
149## Example
147150
148```http
151```bash
149152curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID \
150153 -H 'Content-Type: application/json' \
151154 -H 'anthropic-version: 2023-06-01' \
from line 157
154157 -d '{}'
155158```
156159
157#### Response
160### Response (200)
158161
159162```json
160163{
api/beta/messages Changed · +6222 / -10384 lines
### Headers ### Body parameters #### Response (200) ### Headers ### Body parameters #### Response (200) ## Domain types ## Messages › Batches ### Create a Message Batch #### Headers #### Body parameters #### Returns #### Example ##### Response (200) ### Retrieve a Message Batch #### Path parameters #### Headers #### Returns #### Example ##### Response (200) ### List Message Batches #### Query parameters #### Headers #### Returns #### Example ##### Response (200) ### Cancel a Message Batch #### Path parameters #### Headers #### Returns #### Example ##### Response (200) ### Delete a Message Batch #### Path parameters #### Headers #### Returns #### Example ##### Response (200) ### Retrieve Message Batch results #### Path parameters #### Headers #### Returns #### Example ### Header Parameters ### Body Parameters #### Response ### Header Parameters ### Body Parameters #### Response ## Domain Types # Batches ## Create a Message Batch ### Header Parameters ### Body Parameters #### Response ## Retrieve a Message Batch ### Path Parameters ### Header Parameters #### Response ## List Message Batches ### Query Parameters ### Header Parameters #### Response ## Cancel a Message Batch ### Path Parameters ### Header Parameters #### Response ## Delete a Message Batch ### Path Parameters ### Header Parameters #### Response ## Retrieve Message Batch results ### Path Parameters ### Header Parameters ## Domain Types ### Beta Deleted Message Batch ### Beta Message Batch ### Beta Message Batch Canceled Result ### Beta Message Batch Errored Result ### Beta Message Batch Expired Result ### Beta Message Batch Individual Response ### Beta Message Batch Request Counts ### Beta Message Batch Result ### Beta Message Batch Succeeded Result
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.