Memory Stores changedapi/beta/memory_stores
Nearest release: v2.1.287, published 4 hours before 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+137added
Lines−109removed
From line
117
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits14to this page, all time
The whole hunk
from line 117, old and new numbered
/
from line 117
117117
118118 - `"ce-plugins-2026-09-01"`
119119
120 - `"spend-limit-reads-2026-09-26"`
121
120122- `"anthropic-workspace-id": optional string`
121123
122124 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 155
153155
154156 Unique identifier for the memory store (a `memstore_...` tagged ID). Use this when attaching the store to a session, or in the `{memory_store_id}` path parameter of subsequent calls.
155157
158 - `archived_at: string or null`
159
160 Timestamp when the store was archived, or `null` if active. Set once and never cleared; archiving is one-way. Archived stores are read-only and cannot be attached to new sessions.
161
162 format: date-time
163
156164 - `created_at: string`
157165
158166 Timestamp when the store was created.
from line 167
159167
160168 format: date-time
161169
170 - `description: string`
171
172 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.
173
174 - `metadata: map[string]`
175
176 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.
177
162178 - `name: string`
163179
164180 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 185
169185
170186 format: date-time
171187
172 - `archived_at: optional string or null`
173
174 Timestamp when the store was archived, or `null` if active. Set once and never cleared; archiving is one-way. Archived stores are read-only and cannot be attached to new sessions.
175
176 format: date-time
177
178 - `description: optional string`
179
180 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.
181
182 - `metadata: optional map[string]`
183
184 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.
185
186188### Example
187189
188190```bash
from line 203
201203```json
202204{
203205 "id": "id",
204 "created_at": "2019-12-27T18:11:19.117Z",
205 "name": "name",
206 "type": "memory_store",
207 "updated_at": "2019-12-27T18:11:19.117Z",
208206 "archived_at": "2019-12-27T18:11:19.117Z",
207 "created_at": "2019-12-27T18:11:19.117Z",
209208 "description": "description",
210209 "metadata": {
211210 "foo": "string"
212 }
211 },
212 "name": "name",
213 "type": "memory_store",
214 "updated_at": "2019-12-27T18:11:19.117Z"
213215}
214216```
215217
from line 355
353355
354356 - `"ce-plugins-2026-09-01"`
355357
358 - `"spend-limit-reads-2026-09-26"`
359
356360- `"anthropic-workspace-id": optional string`
357361
358362 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 375
371375
372376 Unique identifier for the memory store (a `memstore_...` tagged ID). Use this when attaching the store to a session, or in the `{memory_store_id}` path parameter of subsequent calls.
373377
378 - `archived_at: string or null`
379
380 Timestamp when the store was archived, or `null` if active. Set once and never cleared; archiving is one-way. Archived stores are read-only and cannot be attached to new sessions.
381
382 format: date-time
383
374384 - `created_at: string`
375385
376386 Timestamp when the store was created.
from line 387
377387
378388 format: date-time
379389
390 - `description: string`
391
392 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.
393
394 - `metadata: map[string]`
395
396 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.
397
380398 - `name: string`
381399
382400 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 405
387405
388406 format: date-time
389407
390 - `archived_at: optional string or null`
391
392 Timestamp when the store was archived, or `null` if active. Set once and never cleared; archiving is one-way. Archived stores are read-only and cannot be attached to new sessions.
393
394 format: date-time
395
396 - `description: optional string`
397
398 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.
399
400 - `metadata: optional map[string]`
401
402 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.
403
404408- `next_page: optional string or null`
405409
406410 Opaque cursor for the next page (a `page_...` value). Pass as `page` on the next request. `null` when there are no more results.
from line 425
421425 "data": [
422426 {
423427 "id": "id",
424 "created_at": "2019-12-27T18:11:19.117Z",
425 "name": "name",
426 "type": "memory_store",
427 "updated_at": "2019-12-27T18:11:19.117Z",
428428 "archived_at": "2019-12-27T18:11:19.117Z",
429 "created_at": "2019-12-27T18:11:19.117Z",
429430 "description": "description",
430431 "metadata": {
431432 "foo": "string"
432 }
433 },
434 "name": "name",
435 "type": "memory_store",
436 "updated_at": "2019-12-27T18:11:19.117Z"
433437 }
434438 ],
435439 "next_page": "next_page"
from line 558
554558
555559 - `"ce-plugins-2026-09-01"`
556560
561 - `"spend-limit-reads-2026-09-26"`
562
557563- `"anthropic-workspace-id": optional string`
558564
559565 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 578
572578
573579 Unique identifier for the memory store (a `memstore_...` tagged ID). Use this when attaching the store to a session, or in the `{memory_store_id}` path parameter of subsequent calls.
574580
581 - `archived_at: string or null`
582
583 Timestamp when the store was archived, or `null` if active. Set once and never cleared; archiving is one-way. Archived stores are read-only and cannot be attached to new sessions.
584
585 format: date-time
586
575587 - `created_at: string`
576588
577589 Timestamp when the store was created.
from line 590
578590
579591 format: date-time
580592
593 - `description: string`
594
595 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.
596
597 - `metadata: map[string]`
598
599 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.
600
581601 - `name: string`
582602
583603 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 608
588608
589609 format: date-time
590610
591 - `archived_at: optional string or null`
592
593 Timestamp when the store was archived, or `null` if active. Set once and never cleared; archiving is one-way. Archived stores are read-only and cannot be attached to new sessions.
594
595 format: date-time
596
597 - `description: optional string`
598
599 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.
600
601 - `metadata: optional map[string]`
602
603 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.
604
605611### Example
606612
607613```bash
from line 622
616622```json
617623{
618624 "id": "id",
619 "created_at": "2019-12-27T18:11:19.117Z",
620 "name": "name",
621 "type": "memory_store",
622 "updated_at": "2019-12-27T18:11:19.117Z",
623625 "archived_at": "2019-12-27T18:11:19.117Z",
626 "created_at": "2019-12-27T18:11:19.117Z",
624627 "description": "description",
625628 "metadata": {
626629 "foo": "string"
627 }
630 },
631 "name": "name",
632 "type": "memory_store",
633 "updated_at": "2019-12-27T18:11:19.117Z"
628634}
629635```
630636
from line 752
746752
747753 - `"ce-plugins-2026-09-01"`
748754
755 - `"spend-limit-reads-2026-09-26"`
756
749757- `"anthropic-workspace-id": optional string`
750758
751759 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 790
782790
783791 Unique identifier for the memory store (a `memstore_...` tagged ID). Use this when attaching the store to a session, or in the `{memory_store_id}` path parameter of subsequent calls.
784792
793 - `archived_at: string or null`
794
795 Timestamp when the store was archived, or `null` if active. Set once and never cleared; archiving is one-way. Archived stores are read-only and cannot be attached to new sessions.
796
797 format: date-time
798
785799 - `created_at: string`
786800
787801 Timestamp when the store was created.
from line 802
788802
789803 format: date-time
790804
805 - `description: string`
806
807 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.
808
809 - `metadata: map[string]`
810
811 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.
812
791813 - `name: string`
792814
793815 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 820
798820
799821 format: date-time
800822
801 - `archived_at: optional string or null`
802
803 Timestamp when the store was archived, or `null` if active. Set once and never cleared; archiving is one-way. Archived stores are read-only and cannot be attached to new sessions.
804
805 format: date-time
806
807 - `description: optional string`
808
809 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.
810
811 - `metadata: optional map[string]`
812
813 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.
814
815823### Example
816824
817825```bash
from line 836
828836```json
829837{
830838 "id": "id",
831 "created_at": "2019-12-27T18:11:19.117Z",
832 "name": "name",
833 "type": "memory_store",
834 "updated_at": "2019-12-27T18:11:19.117Z",
835839 "archived_at": "2019-12-27T18:11:19.117Z",
840 "created_at": "2019-12-27T18:11:19.117Z",
836841 "description": "description",
837842 "metadata": {
838843 "foo": "string"
839 }
844 },
845 "name": "name",
846 "type": "memory_store",
847 "updated_at": "2019-12-27T18:11:19.117Z"
840848}
841849```
842850
from line 966
958966
959967 - `"ce-plugins-2026-09-01"`
960968
969 - `"spend-limit-reads-2026-09-26"`
970
961971- `"anthropic-workspace-id": optional string`
962972
963973 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 1123
11131123
11141124 - `"ce-plugins-2026-09-01"`
11151125
1126 - `"spend-limit-reads-2026-09-26"`
1127
11161128- `"anthropic-workspace-id": optional string`
11171129
11181130 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 1143
11311143
11321144 Unique identifier for the memory store (a `memstore_...` tagged ID). Use this when attaching the store to a session, or in the `{memory_store_id}` path parameter of subsequent calls.
11331145
1146 - `archived_at: string or null`
1147
1148 Timestamp when the store was archived, or `null` if active. Set once and never cleared; archiving is one-way. Archived stores are read-only and cannot be attached to new sessions.
1149
1150 format: date-time
1151
11341152 - `created_at: string`
11351153
11361154 Timestamp when the store was created.
from line 1155
11371155
11381156 format: date-time
11391157
1158 - `description: string`
1159
1160 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.
1161
1162 - `metadata: map[string]`
1163
1164 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.
1165
11401166 - `name: string`
11411167
11421168 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 1173
11471173
11481174 format: date-time
11491175
1150 - `archived_at: optional string or null`
1151
1152 Timestamp when the store was archived, or `null` if active. Set once and never cleared; archiving is one-way. Archived stores are read-only and cannot be attached to new sessions.
1153
1154 format: date-time
1155
1156 - `description: optional string`
1157
1158 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.
1159
1160 - `metadata: optional map[string]`
1161
1162 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.
1163
11641176### Example
11651177
11661178```bash
from line 1188
11761188```json
11771189{
11781190 "id": "id",
1179 "created_at": "2019-12-27T18:11:19.117Z",
1180 "name": "name",
1181 "type": "memory_store",
1182 "updated_at": "2019-12-27T18:11:19.117Z",
11831191 "archived_at": "2019-12-27T18:11:19.117Z",
1192 "created_at": "2019-12-27T18:11:19.117Z",
11841193 "description": "description",
11851194 "metadata": {
11861195 "foo": "string"
1187 }
1196 },
1197 "name": "name",
1198 "type": "memory_store",
1199 "updated_at": "2019-12-27T18:11:19.117Z"
11881200}
11891201```
11901202
from line 1226
12141226
12151227 Unique identifier for the memory store (a `memstore_...` tagged ID). Use this when attaching the store to a session, or in the `{memory_store_id}` path parameter of subsequent calls.
12161228
1229 - `archived_at: string or null`
1230
1231 Timestamp when the store was archived, or `null` if active. Set once and never cleared; archiving is one-way. Archived stores are read-only and cannot be attached to new sessions.
1232
1233 format: date-time
1234
12171235 - `created_at: string`
12181236
12191237 Timestamp when the store was created.
from line 1238
12201238
12211239 format: date-time
12221240
1241 - `description: string`
1242
1243 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.
1244
1245 - `metadata: map[string]`
1246
1247 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.
1248
12231249 - `name: string`
12241250
12251251 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 1256
12301256
12311257 format: date-time
12321258
1233 - `archived_at: optional string or null`
1234
1235 Timestamp when the store was archived, or `null` if active. Set once and never cleared; archiving is one-way. Archived stores are read-only and cannot be attached to new sessions.
1236
1237 format: date-time
1238
1239 - `description: optional string`
1240
1241 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.
1242
1243 - `metadata: optional map[string]`
1244
1245 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.
1246
12471259## Memory Stores › Memories
12481260
12491261### Create a memory
from line 1390
13781390
13791391 - `"ce-plugins-2026-09-01"`
13801392
1393 - `"spend-limit-reads-2026-09-26"`
1394
13811395- `"anthropic-workspace-id": optional string`
13821396
13831397 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 1643
16291643
16301644 - `"ce-plugins-2026-09-01"`
16311645
1646 - `"spend-limit-reads-2026-09-26"`
1647
16321648- `"anthropic-workspace-id": optional string`
16331649
16341650 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 1886
18701886
18711887 - `"ce-plugins-2026-09-01"`
18721888
1889 - `"spend-limit-reads-2026-09-26"`
1890
18731891- `"anthropic-workspace-id": optional string`
18741892
18751893 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 2106
20882106
20892107 - `"ce-plugins-2026-09-01"`
20902108
2109 - `"spend-limit-reads-2026-09-26"`
2110
20912111- `"anthropic-workspace-id": optional string`
20922112
20932113 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 2344
23242344
23252345 - `"ce-plugins-2026-09-01"`
23262346
2347 - `"spend-limit-reads-2026-09-26"`
2348
23272349- `"anthropic-workspace-id": optional string`
23282350
23292351 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 2573
25512573
25522574 - `"ce-plugins-2026-09-01"`
25532575
2576 - `"spend-limit-reads-2026-09-26"`
2577
25542578- `"anthropic-workspace-id": optional string`
25552579
25562580 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 2883
28592883
28602884 - `"ce-plugins-2026-09-01"`
28612885
2886 - `"spend-limit-reads-2026-09-26"`
2887
28622888- `"anthropic-workspace-id": optional string`
28632889
28642890 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 3169
31433169 - `"mcp-client-2026-09-15"`
31443170
31453171 - `"ce-plugins-2026-09-01"`
3172
3173 - `"spend-limit-reads-2026-09-26"`
31463174
31473175- `"anthropic-workspace-id": optional string`
31483176
No line in this hunk matches that.