The whole hunk
from line 1, old and new numbered
/
lines
from line 1
1---
2title: Memories
3url: https://platform.claude.com/docs/en/api/beta/memory_stores/memories
4---
5
16# Memories
27
38## Create a memory
from line 33
2833
2934 - `string`
3035
31 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
36 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
3237
3338 - `"message-batches-2024-09-24"`
3439
from line 81
7681
7782 - `"user-profiles-2026-08-18"`
7883
84 - `"user-profiles-2026-09-04"`
85
7986 - `"advisor-tool-2026-03-01"`
8087
8188 - `"managed-agents-2026-04-01"`
from line 125
118125
119126 - `"mid-conversation-system-clear-at-2026-08-21"`
120127
128- `"anthropic-workspace-id": optional string`
129
121130### Body parameters
122131
123132- `content: string or null`
from line 145
136145
137146 A `memory` object: a single text document at a hierarchical path inside a memory store. The `content` field is populated when `view=full` and `null` when `view=basic`; the `content_size_bytes` and `content_sha256` fields are always populated so sync clients can diff without fetching content. Memories are addressed by their `mem_...` ID; the path is the create key and can be changed via update.
138147
148 - `type: "memory"`
149
139150 - `id: string`
140151
141152 Unique identifier for this memory (a `mem_...` value). Stable across renames; use this ID, not the path, to read, update, or delete the memory.
from line 179
168179
169180 Hierarchical path of the memory within the store, e.g. `/projects/foo/notes.md`. Always starts with `/`. Paths are case-sensitive and unique within a store. Maximum 1,024 bytes.
170181
171 - `type: "memory"`
172
173182 - `updated_at: string`
174183
175184 A timestamp in RFC 3339 format
from line 268
259268
260269 - `string`
261270
262 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
271 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
263272
264273 - `"message-batches-2024-09-24"`
265274
from line 316
307316
308317 - `"user-profiles-2026-08-18"`
309318
319 - `"user-profiles-2026-09-04"`
320
310321 - `"advisor-tool-2026-03-01"`
311322
312323 - `"managed-agents-2026-04-01"`
from line 360
349360
350361 - `"mid-conversation-system-clear-at-2026-08-21"`
351362
363- `"anthropic-workspace-id": optional string`
364
352365### Returns
353366
354367- `data: optional array of BetaManagedAgentsMemoryListItem`
from line 372
359372
360373 A `memory` object: a single text document at a hierarchical path inside a memory store. The `content` field is populated when `view=full` and `null` when `view=basic`; the `content_size_bytes` and `content_sha256` fields are always populated so sync clients can diff without fetching content. Memories are addressed by their `mem_...` ID; the path is the create key and can be changed via update.
361374
375 - `type: "memory"`
376
362377 - `id: string`
363378
364379 Unique identifier for this memory (a `mem_...` value). Stable across renames; use this ID, not the path, to read, update, or delete the memory.
from line 406
391406
392407 Hierarchical path of the memory within the store, e.g. `/projects/foo/notes.md`. Always starts with `/`. Paths are case-sensitive and unique within a store. Maximum 1,024 bytes.
393408
394 - `type: "memory"`
395
396409 - `updated_at: string`
397410
398411 A timestamp in RFC 3339 format
from line 420
407420
408421 A rolled-up directory marker returned by [List memories](/docs/en/api/beta/memory_stores/memories/list) when `depth` is set. Indicates that one or more memories exist deeper than the requested depth under this prefix. This is a list-time rollup, not a stored resource; it has no ID and no lifecycle. Each prefix counts toward the page `limit` and interleaves with `memory` items in path order.
409422
423 - `type: "memory_prefix"`
424
410425 - `path: string`
411426
412427 The rolled-up path prefix, including a trailing `/` (e.g. `/projects/foo/`). Pass this value as `path_prefix` on a subsequent list call to drill into the directory.
413428
414 - `type: "memory_prefix"`
415
416429- `next_page: optional string or null`
417430
418431 Opaque cursor for the next page (a `page_...` value), or `null` if there are no more results. Pass as `page` on the next request.
from line 491
478491
479492 - `string`
480493
481 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
494 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
482495
483496 - `"message-batches-2024-09-24"`
484497
from line 539
526539
527540 - `"user-profiles-2026-08-18"`
528541
542 - `"user-profiles-2026-09-04"`
543
529544 - `"advisor-tool-2026-03-01"`
530545
531546 - `"managed-agents-2026-04-01"`
from line 583
568583
569584 - `"mid-conversation-system-clear-at-2026-08-21"`
570585
586- `"anthropic-workspace-id": optional string`
587
571588### Returns
572589
573590- `BetaManagedAgentsMemory object`
from line 591
574591
575592 A `memory` object: a single text document at a hierarchical path inside a memory store. The `content` field is populated when `view=full` and `null` when `view=basic`; the `content_size_bytes` and `content_sha256` fields are always populated so sync clients can diff without fetching content. Memories are addressed by their `mem_...` ID; the path is the create key and can be changed via update.
576593
594 - `type: "memory"`
595
577596 - `id: string`
578597
579598 Unique identifier for this memory (a `mem_...` value). Stable across renames; use this ID, not the path, to read, update, or delete the memory.
from line 625
606625
607626 Hierarchical path of the memory within the store, e.g. `/projects/foo/notes.md`. Always starts with `/`. Paths are case-sensitive and unique within a store. Maximum 1,024 bytes.
608627
609 - `type: "memory"`
610
611628 - `updated_at: string`
612629
613630 A timestamp in RFC 3339 format
from line 691
674691
675692 - `string`
676693
677 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
694 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
678695
679696 - `"message-batches-2024-09-24"`
680697
from line 739
722739
723740 - `"user-profiles-2026-08-18"`
724741
742 - `"user-profiles-2026-09-04"`
743
725744 - `"advisor-tool-2026-03-01"`
726745
727746 - `"managed-agents-2026-04-01"`
from line 783
764783
765784 - `"mid-conversation-system-clear-at-2026-08-21"`
766785
786- `"anthropic-workspace-id": optional string`
787
767788### Body parameters
768789
769790- `content: optional string or null`
from line 813
792813
793814 A `memory` object: a single text document at a hierarchical path inside a memory store. The `content` field is populated when `view=full` and `null` when `view=basic`; the `content_size_bytes` and `content_sha256` fields are always populated so sync clients can diff without fetching content. Memories are addressed by their `mem_...` ID; the path is the create key and can be changed via update.
794815
816 - `type: "memory"`
817
795818 - `id: string`
796819
797820 Unique identifier for this memory (a `mem_...` value). Stable across renames; use this ID, not the path, to read, update, or delete the memory.
from line 847
824847
825848 Hierarchical path of the memory within the store, e.g. `/projects/foo/notes.md`. Always starts with `/`. Paths are case-sensitive and unique within a store. Maximum 1,024 bytes.
826849
827 - `type: "memory"`
828
829850 - `updated_at: string`
830851
831852 A timestamp in RFC 3339 format
from line 911
890911
891912 - `string`
892913
893 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
914 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
894915
895916 - `"message-batches-2024-09-24"`
896917
from line 959
938959
939960 - `"user-profiles-2026-08-18"`
940961
962 - `"user-profiles-2026-09-04"`
963
941964 - `"advisor-tool-2026-03-01"`
942965
943966 - `"managed-agents-2026-04-01"`
from line 1003
9801003
9811004 - `"mid-conversation-system-clear-at-2026-08-21"`
9821005
1006- `"anthropic-workspace-id": optional string`
1007
9831008### Returns
9841009
9851010- `BetaManagedAgentsDeletedMemory object`
from line 1011
9861011
9871012 Tombstone returned by [Delete a memory](/docs/en/api/beta/memory_stores/memories/delete). Deleting a memory does not erase its version history: its versions remain listable via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) while they are retained (each version is kept for at least the version retention period after it was written, unless the store itself is deleted).
9881013
1014 - `type: "memory_deleted"`
1015
9891016 - `id: string`
9901017
9911018 ID of the deleted memory (a `mem_...` value).
9921019
993 - `type: "memory_deleted"`
994
9951020### Example
9961021
9971022```bash
from line 1064
10391064
10401065 Tombstone returned by [Delete a memory](/docs/en/api/beta/memory_stores/memories/delete). Deleting a memory does not erase its version history: its versions remain listable via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) while they are retained (each version is kept for at least the version retention period after it was written, unless the store itself is deleted).
10411066
1067 - `type: "memory_deleted"`
1068
10421069 - `id: string`
10431070
10441071 ID of the deleted memory (a `mem_...` value).
10451072
1046 - `type: "memory_deleted"`
1047
10481073### Beta Managed Agents Error
10491074
10501075- `BetaManagedAgentsError = BetaInvalidRequestError or BetaAuthenticationError or BetaBillingError or 9 more`
from line 1076
10511076
10521077 - `BetaInvalidRequestError object`
10531078
1054 - `message: string`
1055
1056 default: Invalid request
1057
10581079 - `type: "invalid_request_error"`
10591080
10601081 default: invalid_request_error
10611082
1062 - `BetaAuthenticationError object`
1063
10641083 - `message: string`
10651084
1066 default: Authentication error
1085 default: Invalid request
10671086
1087 - `BetaAuthenticationError object`
1088
10681089 - `type: "authentication_error"`
10691090
10701091 default: authentication_error
10711092
1072 - `BetaBillingError object`
1073
10741093 - `message: string`
10751094
1076 default: Billing error
1095 default: Authentication error
10771096
1097 - `BetaBillingError object`
1098
10781099 - `type: "billing_error"`
10791100
10801101 default: billing_error
10811102
1082 - `BetaPermissionError object`
1083
10841103 - `message: string`
10851104
1086 default: Permission denied
1105 default: Billing error
10871106
1107 - `BetaPermissionError object`
1108
10881109 - `type: "permission_error"`
10891110
10901111 default: permission_error
10911112
1092 - `BetaNotFoundError object`
1093
10941113 - `message: string`
10951114
1096 default: Not found
1115 default: Permission denied
10971116
1117 - `BetaNotFoundError object`
1118
10981119 - `type: "not_found_error"`
10991120
11001121 default: not_found_error
11011122
1102 - `BetaRateLimitError object`
1103
11041123 - `message: string`
11051124
1106 default: Rate limited
1125 default: Not found
11071126
1127 - `BetaRateLimitError object`
1128
11081129 - `type: "rate_limit_error"`
11091130
11101131 default: rate_limit_error
11111132
1112 - `BetaGatewayTimeoutError object`
1113
11141133 - `message: string`
11151134
1116 default: Request timeout
1135 default: Rate limited
11171136
1137 - `BetaGatewayTimeoutError object`
1138
11181139 - `type: "timeout_error"`
11191140
11201141 default: timeout_error
11211142
1122 - `BetaAPIError object`
1123
11241143 - `message: string`
11251144
1126 default: Internal server error
1145 default: Request timeout
11271146
1147 - `BetaAPIError object`
1148
11281149 - `type: "api_error"`
11291150
11301151 default: api_error
11311152
1132 - `BetaOverloadedError object`
1133
11341153 - `message: string`
11351154
1136 default: Overloaded
1155 default: Internal server error
11371156
1157 - `BetaOverloadedError object`
1158
11381159 - `type: "overloaded_error"`
11391160
11401161 default: overloaded_error
11411162
1163 - `message: string`
1164
1165 default: Overloaded
1166
11421167 - `BetaManagedAgentsMemoryPreconditionFailedError object`
11431168
11441169 - `type: "memory_precondition_failed_error"`
from line 1192
11671192
11681193 A `memory` object: a single text document at a hierarchical path inside a memory store. The `content` field is populated when `view=full` and `null` when `view=basic`; the `content_size_bytes` and `content_sha256` fields are always populated so sync clients can diff without fetching content. Memories are addressed by their `mem_...` ID; the path is the create key and can be changed via update.
11691194
1195 - `type: "memory"`
1196
11701197 - `id: string`
11711198
11721199 Unique identifier for this memory (a `mem_...` value). Stable across renames; use this ID, not the path, to read, update, or delete the memory.
from line 1226
11991226
12001227 Hierarchical path of the memory within the store, e.g. `/projects/foo/notes.md`. Always starts with `/`. Paths are case-sensitive and unique within a store. Maximum 1,024 bytes.
12011228
1202 - `type: "memory"`
1203
12041229 - `updated_at: string`
12051230
12061231 A timestamp in RFC 3339 format
from line 1246
12211246
12221247 A `memory` object: a single text document at a hierarchical path inside a memory store. The `content` field is populated when `view=full` and `null` when `view=basic`; the `content_size_bytes` and `content_sha256` fields are always populated so sync clients can diff without fetching content. Memories are addressed by their `mem_...` ID; the path is the create key and can be changed via update.
12231248
1249 - `type: "memory"`
1250
12241251 - `id: string`
12251252
12261253 Unique identifier for this memory (a `mem_...` value). Stable across renames; use this ID, not the path, to read, update, or delete the memory.
from line 1280
12531280
12541281 Hierarchical path of the memory within the store, e.g. `/projects/foo/notes.md`. Always starts with `/`. Paths are case-sensitive and unique within a store. Maximum 1,024 bytes.
12551282
1256 - `type: "memory"`
1257
12581283 - `updated_at: string`
12591284
12601285 A timestamp in RFC 3339 format
from line 1294
12691294
12701295 A rolled-up directory marker returned by [List memories](/docs/en/api/beta/memory_stores/memories/list) when `depth` is set. Indicates that one or more memories exist deeper than the requested depth under this prefix. This is a list-time rollup, not a stored resource; it has no ID and no lifecycle. Each prefix counts toward the page `limit` and interleaves with `memory` items in path order.
12711296
1297 - `type: "memory_prefix"`
1298
12721299 - `path: string`
12731300
12741301 The rolled-up path prefix, including a trailing `/` (e.g. `/projects/foo/`). Pass this value as `path_prefix` on a subsequent list call to drill into the directory.
12751302
1276 - `type: "memory_prefix"`
1277
12781303### Beta Managed Agents Memory Path Conflict Error
12791304
12801305- `BetaManagedAgentsMemoryPathConflictError object`
from line 1326
13011326
13021327 A rolled-up directory marker returned by [List memories](/docs/en/api/beta/memory_stores/memories/list) when `depth` is set. Indicates that one or more memories exist deeper than the requested depth under this prefix. This is a list-time rollup, not a stored resource; it has no ID and no lifecycle. Each prefix counts toward the page `limit` and interleaves with `memory` items in path order.
13031328
1329 - `type: "memory_prefix"`
1330
13041331 - `path: string`
13051332
13061333 The rolled-up path prefix, including a trailing `/` (e.g. `/projects/foo/`). Pass this value as `path_prefix` on a subsequent list call to drill into the directory.
1307
1308 - `type: "memory_prefix"`
13091334
13101335### Beta Managed Agents Memory View
13111336