Memory Stores changedapi/beta/memory_stores
Nearest release: v2.1.247, published under an hour 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+220added
Lines−24removed
From line
14
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits22to this page, all time
The whole hunk
from line 14, old and new numbered
/
from line 14
1414
1515 - `string`
1616
17 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
17 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
1818
1919 - `"message-batches-2024-09-24"`
2020
from line 84
8484
8585 - `"mid-conversation-tool-changes-2026-07-01"`
8686
87 - `"compact-2026-01-12"`
88
89 - `"computer-use-2025-11-24"`
90
91 - `"mcp-tunnels-2026-06-22"`
92
93 - `"structured-outputs-2025-11-13"`
94
95 - `"task-budgets-2026-03-13"`
96
97 - `"thinking-display-updates-2026-08-18"`
98
99 - `"ce-user-management-2026-07-13"`
100
87101### Body parameters
88102
89103- `name: string`
from line 230
216230
217231 - `string`
218232
219 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
233 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
220234
221235 - `"message-batches-2024-09-24"`
222236
from line 300
286300
287301 - `"mid-conversation-tool-changes-2026-07-01"`
288302
303 - `"compact-2026-01-12"`
304
305 - `"computer-use-2025-11-24"`
306
307 - `"mcp-tunnels-2026-06-22"`
308
309 - `"structured-outputs-2025-11-13"`
310
311 - `"task-budgets-2026-03-13"`
312
313 - `"thinking-display-updates-2026-08-18"`
314
315 - `"ce-user-management-2026-07-13"`
316
289317### Returns
290318
291319- `data: optional array of BetaManagedAgentsMemoryStore`
from line 409
381409
382410 - `string`
383411
384 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
412 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
385413
386414 - `"message-batches-2024-09-24"`
387415
from line 479
451479
452480 - `"mid-conversation-tool-changes-2026-07-01"`
453481
482 - `"compact-2026-01-12"`
483
484 - `"computer-use-2025-11-24"`
485
486 - `"mcp-tunnels-2026-06-22"`
487
488 - `"structured-outputs-2025-11-13"`
489
490 - `"task-budgets-2026-03-13"`
491
492 - `"thinking-display-updates-2026-08-18"`
493
494 - `"ce-user-management-2026-07-13"`
495
454496### Returns
455497
456498- `BetaManagedAgentsMemoryStore object`
from line 579
537579
538580 - `string`
539581
540 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
582 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
541583
542584 - `"message-batches-2024-09-24"`
543585
from line 649
607649
608650 - `"mid-conversation-tool-changes-2026-07-01"`
609651
652 - `"compact-2026-01-12"`
653
654 - `"computer-use-2025-11-24"`
655
656 - `"mcp-tunnels-2026-06-22"`
657
658 - `"structured-outputs-2025-11-13"`
659
660 - `"task-budgets-2026-03-13"`
661
662 - `"thinking-display-updates-2026-08-18"`
663
664 - `"ce-user-management-2026-07-13"`
665
610666### Body parameters
611667
612668- `description: optional string or null`
from line 769
713769
714770 - `string`
715771
716 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
772 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
717773
718774 - `"message-batches-2024-09-24"`
719775
from line 839
783839
784840 - `"mid-conversation-tool-changes-2026-07-01"`
785841
842 - `"compact-2026-01-12"`
843
844 - `"computer-use-2025-11-24"`
845
846 - `"mcp-tunnels-2026-06-22"`
847
848 - `"structured-outputs-2025-11-13"`
849
850 - `"task-budgets-2026-03-13"`
851
852 - `"thinking-display-updates-2026-08-18"`
853
854 - `"ce-user-management-2026-07-13"`
855
786856### Returns
787857
788858- `BetaManagedAgentsDeletedMemoryStore object`
from line 902
832902
833903 - `string`
834904
835 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
905 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
836906
837907 - `"message-batches-2024-09-24"`
838908
from line 972
902972
903973 - `"mid-conversation-tool-changes-2026-07-01"`
904974
975 - `"compact-2026-01-12"`
976
977 - `"computer-use-2025-11-24"`
978
979 - `"mcp-tunnels-2026-06-22"`
980
981 - `"structured-outputs-2025-11-13"`
982
983 - `"task-budgets-2026-03-13"`
984
985 - `"thinking-display-updates-2026-08-18"`
986
987 - `"ce-user-management-2026-07-13"`
988
905989### Returns
906990
907991- `BetaManagedAgentsMemoryStore object`
from line 1141
10571141
10581142 - `string`
10591143
1060 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
1144 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
10611145
10621146 - `"message-batches-2024-09-24"`
10631147
from line 1211
11271211
11281212 - `"mid-conversation-tool-changes-2026-07-01"`
11291213
1214 - `"compact-2026-01-12"`
1215
1216 - `"computer-use-2025-11-24"`
1217
1218 - `"mcp-tunnels-2026-06-22"`
1219
1220 - `"structured-outputs-2025-11-13"`
1221
1222 - `"task-budgets-2026-03-13"`
1223
1224 - `"thinking-display-updates-2026-08-18"`
1225
1226 - `"ce-user-management-2026-07-13"`
1227
11301228#### Body parameters
11311229
11321230- `content: string or null`
from line 1269
11711269
11721270 - `memory_version_id: string`
11731271
1174 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).
1272 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 history via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list).
11751273
11761274 - `path: string`
11771275
from line 1366
12681366
12691367 - `string`
12701368
1271 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
1369 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
12721370
12731371 - `"message-batches-2024-09-24"`
12741372
from line 1436
13381436
13391437 - `"mid-conversation-tool-changes-2026-07-01"`
13401438
1439 - `"compact-2026-01-12"`
1440
1441 - `"computer-use-2025-11-24"`
1442
1443 - `"mcp-tunnels-2026-06-22"`
1444
1445 - `"structured-outputs-2025-11-13"`
1446
1447 - `"task-budgets-2026-03-13"`
1448
1449 - `"thinking-display-updates-2026-08-18"`
1450
1451 - `"ce-user-management-2026-07-13"`
1452
13411453#### Returns
13421454
13431455- `data: optional array of BetaManagedAgentsMemoryListItem`
from line 1486
13741486
13751487 - `memory_version_id: string`
13761488
1377 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).
1489 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 history via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list).
13781490
13791491 - `path: string`
13801492
from line 1579
14671579
14681580 - `string`
14691581
1470 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
1582 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
14711583
14721584 - `"message-batches-2024-09-24"`
14731585
from line 1649
15371649
15381650 - `"mid-conversation-tool-changes-2026-07-01"`
15391651
1652 - `"compact-2026-01-12"`
1653
1654 - `"computer-use-2025-11-24"`
1655
1656 - `"mcp-tunnels-2026-06-22"`
1657
1658 - `"structured-outputs-2025-11-13"`
1659
1660 - `"task-budgets-2026-03-13"`
1661
1662 - `"thinking-display-updates-2026-08-18"`
1663
1664 - `"ce-user-management-2026-07-13"`
1665
15401666#### Returns
15411667
15421668- `BetaManagedAgentsMemory object`
from line 1695
15691695
15701696 - `memory_version_id: string`
15711697
1572 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).
1698 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 history via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list).
15731699
15741700 - `path: string`
15751701
from line 1769
16431769
16441770 - `string`
16451771
1646 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
1772 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
16471773
16481774 - `"message-batches-2024-09-24"`
16491775
from line 1839
17131839
17141840 - `"mid-conversation-tool-changes-2026-07-01"`
17151841
1842 - `"compact-2026-01-12"`
1843
1844 - `"computer-use-2025-11-24"`
1845
1846 - `"mcp-tunnels-2026-06-22"`
1847
1848 - `"structured-outputs-2025-11-13"`
1849
1850 - `"task-budgets-2026-03-13"`
1851
1852 - `"thinking-display-updates-2026-08-18"`
1853
1854 - `"ce-user-management-2026-07-13"`
1855
17161856#### Body parameters
17171857
17181858- `content: optional string or null`
from line 1907
17671907
17681908 - `memory_version_id: string`
17691909
1770 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).
1910 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 history via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list).
17711911
17721912 - `path: string`
17731913
from line 1979
18391979
18401980 - `string`
18411981
1842 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
1982 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
18431983
18441984 - `"message-batches-2024-09-24"`
18451985
from line 2049
19092049
19102050 - `"mid-conversation-tool-changes-2026-07-01"`
19112051
2052 - `"compact-2026-01-12"`
2053
2054 - `"computer-use-2025-11-24"`
2055
2056 - `"mcp-tunnels-2026-06-22"`
2057
2058 - `"structured-outputs-2025-11-13"`
2059
2060 - `"task-budgets-2026-03-13"`
2061
2062 - `"thinking-display-updates-2026-08-18"`
2063
2064 - `"ce-user-management-2026-07-13"`
2065
19122066#### Returns
19132067
19142068- `BetaManagedAgentsDeletedMemory object`
19152069
1916 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.
2070 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).
19172071
19182072 - `id: string`
19192073
from line 2172
20182172
20192173 - `string`
20202174
2021 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
2175 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
20222176
20232177 - `"message-batches-2024-09-24"`
20242178
from line 2242
20882242
20892243 - `"mid-conversation-tool-changes-2026-07-01"`
20902244
2245 - `"compact-2026-01-12"`
2246
2247 - `"computer-use-2025-11-24"`
2248
2249 - `"mcp-tunnels-2026-06-22"`
2250
2251 - `"structured-outputs-2025-11-13"`
2252
2253 - `"task-budgets-2026-03-13"`
2254
2255 - `"thinking-display-updates-2026-08-18"`
2256
2257 - `"ce-user-management-2026-07-13"`
2258
20912259#### Returns
20922260
20932261- `data: optional array of BetaManagedAgentsMemoryVersion`
from line 2274
21062274
21072275 - `memory_id: string`
21082276
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.
2277 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 memory's retained versions, including the `deleted` row while the lineage is retained.
21102278
21112279 - `memory_store_id: string`
21122280
from line 2446
22782446
22792447 - `string`
22802448
2281 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
2449 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
22822450
22832451 - `"message-batches-2024-09-24"`
22842452
from line 2516
23482516
23492517 - `"mid-conversation-tool-changes-2026-07-01"`
23502518
2519 - `"compact-2026-01-12"`
2520
2521 - `"computer-use-2025-11-24"`
2522
2523 - `"mcp-tunnels-2026-06-22"`
2524
2525 - `"structured-outputs-2025-11-13"`
2526
2527 - `"task-budgets-2026-03-13"`
2528
2529 - `"thinking-display-updates-2026-08-18"`
2530
2531 - `"ce-user-management-2026-07-13"`
2532
23512533#### Returns
23522534
23532535- `BetaManagedAgentsMemoryVersion object`
23542536
2355 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.
2537 A `memory_version` object: one immutable, attributed row in a memory's append-only history. Every non-no-op mutation to a memory produces a new version. Versions belong to the store (not the individual memory) and are not deleted with the memory; each version is retained for at least the version retention period after it was written, unless the store itself is deleted. Retrieving a redacted version returns 200 with `content`, `path`, `content_size_bytes`, and `content_sha256` set to `null`; branch on `redacted_at`, not HTTP status.
23562538
23572539 - `id: string`
23582540
from line 2548
23662548
23672549 - `memory_id: string`
23682550
2369 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.
2551 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 memory's retained versions, including the `deleted` row while the lineage is retained.
23702552
23712553 - `memory_store_id: string`
23722554
from line 2701
25192701
25202702 - `string`
25212703
2522 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
2704 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
25232705
25242706 - `"message-batches-2024-09-24"`
25252707
from line 2771
25892771
25902772 - `"mid-conversation-tool-changes-2026-07-01"`
25912773
2774 - `"compact-2026-01-12"`
2775
2776 - `"computer-use-2025-11-24"`
2777
2778 - `"mcp-tunnels-2026-06-22"`
2779
2780 - `"structured-outputs-2025-11-13"`
2781
2782 - `"task-budgets-2026-03-13"`
2783
2784 - `"thinking-display-updates-2026-08-18"`
2785
2786 - `"ce-user-management-2026-07-13"`
2787
25922788#### Returns
25932789
25942790- `BetaManagedAgentsMemoryVersion object`
25952791
2596 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.
2792 A `memory_version` object: one immutable, attributed row in a memory's append-only history. Every non-no-op mutation to a memory produces a new version. Versions belong to the store (not the individual memory) and are not deleted with the memory; each version is retained for at least the version retention period after it was written, unless the store itself is deleted. Retrieving a redacted version returns 200 with `content`, `path`, `content_size_bytes`, and `content_sha256` set to `null`; branch on `redacted_at`, not HTTP status.
25972793
25982794 - `id: string`
25992795
from line 2803
26072803
26082804 - `memory_id: string`
26092805
2610 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.
2806 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 memory's retained versions, including the `deleted` row while the lineage is retained.
26112807
26122808 - `memory_store_id: string`
26132809
No line in this hunk matches that.