Create a Dream changedapi/beta/dreams/create
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+57added
Lines−8removed
From line
17
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 17, old and new numbered
/
from line 17
1717
1818 - `string`
1919
20 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
20 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
2121
2222 - `"message-batches-2024-09-24"`
2323
from line 63
6363
6464 - `"user-profiles-2026-03-24"`
6565
66 - `"user-profiles-2026-08-18"`
67
6668 - `"advisor-tool-2026-03-01"`
6769
6870 - `"managed-agents-2026-04-01"`
from line 93
9193
9294 - `BetaDreamMemoryStoreInput object { memory_store_id, type }`
9395
94 An input memory store the dream reads from. The dream never mutates this store.
96 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.
9597
9698 - `memory_store_id: string`
9799
from line 123
121123
122124 - `id: string`
123125
124 Model identifier, e.g. "claude-opus-4-7". 1-256 characters.
126 Model identifier, e.g. "claude-opus-5". 1-256 characters.
125127
126128 - `speed: optional "standard" or "fast" or null`
127129
from line 135
133135
134136- `instructions: optional string or null`
135137
138- `output_behavior: optional BetaOutputBehavior`
139
140 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.
141
142 - `BetaOutputBehaviorCreateNew object { type }`
143
144 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.
145
146 - `type: "create_new"`
147
148 - `"create_new"`
149
150 - `BetaOutputBehaviorUpdateExisting object { memory_store_id, type }`
151
152 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.
153
154 - `memory_store_id: string`
155
156 - `type: "update_existing"`
157
158 - `"update_existing"`
159
136160### Returns
137161
138- `BetaDream object { id, archived_at, created_at, 10 more }`
162- `BetaDream object { id, archived_at, created_at, 11 more }`
139163
140 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.
164 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.
141165
142166 - `id: string`
143167
from line 189
165189
166190 - `BetaDreamMemoryStoreInput object { memory_store_id, type }`
167191
168 An input memory store the dream reads from. The dream never mutates this store.
192 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.
169193
170194 - `memory_store_id: string`
171195
from line 215
191215
192216 - `id: string`
193217
194 Model identifier, e.g. "claude-opus-4-7". 1-256 characters.
218 Model identifier, e.g. "claude-opus-5". 1-256 characters.
195219
196220 - `speed: optional "standard" or "fast"`
197221
from line 225
201225
202226 - `"fast"`
203227
228 - `output_behavior: BetaOutputBehavior`
229
230 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.
231
232 - `BetaOutputBehaviorCreateNew object { type }`
233
234 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.
235
236 - `type: "create_new"`
237
238 - `"create_new"`
239
240 - `BetaOutputBehaviorUpdateExisting object { memory_store_id, type }`
241
242 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.
243
244 - `memory_store_id: string`
245
246 - `type: "update_existing"`
247
248 - `"update_existing"`
249
204250 - `outputs: array of BetaDreamOutput`
205251
206252 - `memory_store_id: string`
from line 336
290336 "model": {
291337 "id": "x",
292338 "speed": "standard"
339 },
340 "output_behavior": {
341 "type": "create_new"
293342 },
294343 "outputs": [
295344 {
No line in this hunk matches that.