Memories changedapi/beta/memory_stores/memories
Nearest release: v2.1.268, published under an hour after this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
Recorded here
Lines+88added
Lines−63removed
From line
1
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits24to this page, all time
The whole hunk
from line 1, old and new numbered
/
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
No line in this hunk matches that.