Get a Dream changedapi/beta/dreams/retrieve
Nearest release: v2.1.238, 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+33added
Lines−6removed
From line
21
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits21to this page, all time
The whole hunk
from line 21, old and new numbered
/
from line 21
2121
2222 - `string`
2323
24 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
24 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
2525
2626 - `"message-batches-2024-09-24"`
2727
from line 67
6767
6868 - `"user-profiles-2026-03-24"`
6969
70 - `"user-profiles-2026-08-18"`
71
7072 - `"advisor-tool-2026-03-01"`
7173
7274 - `"managed-agents-2026-04-01"`
from line 93
9193
9294### Returns
9395
94- `BetaDream object { id, archived_at, created_at, 10 more }`
96- `BetaDream object { id, archived_at, created_at, 11 more }`
9597
96 An asynchronous memory-consolidation job that reads a memory store plus a set of session transcripts and writes consolidated memories into a new output memory store. The Dreams API is in research preview: the request and response shapes are volatile and may change without the deprecation period that applies to generally-available endpoints.
98 An asynchronous memory-consolidation job that reads a memory store plus a set of session transcripts and writes consolidated memories into an output memory store — a new store by default, or an existing store chosen via output_behavior. The Dreams API is in research preview: the request and response shapes are volatile and may change without the deprecation period that applies to generally-available endpoints.
9799
98100 - `id: string`
99101
from line 123
121123
122124 - `BetaDreamMemoryStoreInput object { memory_store_id, type }`
123125
124 An input memory store the dream reads from. The dream never mutates this store.
126 An input memory store the dream reads from. The dream never mutates this store unless it is also the destination: with output_behavior {type: "update_existing"} the job consolidates this store in place.
125127
126128 - `memory_store_id: string`
127129
from line 149
147149
148150 - `id: string`
149151
150 Model identifier, e.g. "claude-opus-4-7". 1-256 characters.
152 Model identifier, e.g. "claude-opus-5". 1-256 characters.
151153
152154 - `speed: optional "standard" or "fast"`
153155
from line 159
157159
158160 - `"fast"`
159161
162 - `output_behavior: BetaOutputBehavior`
163
164 The default destination: the job creates a new output memory store as a clone of the memory_store input and writes the consolidated memories into it. The input store is never mutated.
165
166 - `BetaOutputBehaviorCreateNew object { type }`
167
168 The default destination: the job creates a new output memory store as a clone of the memory_store input and writes the consolidated memories into it. The input store is never mutated.
169
170 - `type: "create_new"`
171
172 - `"create_new"`
173
174 - `BetaOutputBehaviorUpdateExisting object { memory_store_id, type }`
175
176 The job writes the consolidated memories into this existing memory store instead of creating one. In EAP the store must be the job's own memory_store input, so the job consolidates the store in place.
177
178 - `memory_store_id: string`
179
180 - `type: "update_existing"`
181
182 - `"update_existing"`
183
160184 - `outputs: array of BetaDreamOutput`
161185
162186 - `memory_store_id: string`
from line 260
236260 "model": {
237261 "id": "x",
238262 "speed": "standard"
263 },
264 "output_behavior": {
265 "type": "create_new"
239266 },
240267 "outputs": [
241268 {
No line in this hunk matches that.