The whole hunk
from line 1, old and new numbered
/
lines
from line 1
1---
2title: Create a Dream
3url: https://platform.claude.com/docs/en/api/beta/dreams/create
4---
5
16# Create a Dream
27
38**POST** `/v1/dreams`
from line 17
1217
1318 - `string`
1419
15 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
20 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
1621
1722 - `"message-batches-2024-09-24"`
1823
from line 65
6065
6166 - `"user-profiles-2026-08-18"`
6267
68 - `"user-profiles-2026-09-04"`
69
6370 - `"advisor-tool-2026-03-01"`
6471
6572 - `"managed-agents-2026-04-01"`
from line 109
102109
103110 - `"mid-conversation-system-clear-at-2026-08-21"`
104111
112- `"anthropic-workspace-id": optional string`
113
105114## Body parameters
106115
107116- `inputs: array of BetaDreamInput`
from line 119
110119
111120 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.
112121
122 - `type: "memory_store"`
123
113124 - `memory_store_id: string`
114125
115126 minLength: 1
116127
117 - `type: "memory_store"`
118
119128 - `BetaDreamSessionsInput object`
120129
121130 Input session transcripts the dream reads.
122131
123 - `session_ids: array of string`
124
125132 - `type: "sessions"`
126133
134 - `session_ids: array of string`
135
127136- `model: string or BetaDreamModelConfigParam`
128137
129138 Model identifier and configuration applied to every pipeline stage.
from line 175
166175
167176 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.
168177
178 - `type: "update_existing"`
179
169180 - `memory_store_id: string`
170181
171182 minLength: 1
172183
173 - `type: "update_existing"`
174
175184## Returns
176185
177186- `BetaDream object`
from line 187
178187
179188 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.
180189
190 - `type: "dream"`
191
181192 - `id: string`
182193
183194 - `archived_at: string or null`
from line 213
202213
203214 Failure detail for a Dream whose `status` is `failed`.
204215
205 - `message: string`
206
207216 - `type: string`
208217
218 - `message: string`
219
209220 - `inputs: array of BetaDreamInput`
210221
211222 - `BetaDreamMemoryStoreInput object`
from line 223
212223
213224 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.
214225
226 - `type: "memory_store"`
227
215228 - `memory_store_id: string`
216229
217230 minLength: 1
218231
219 - `type: "memory_store"`
220
221232 - `BetaDreamSessionsInput object`
222233
223234 Input session transcripts the dream reads.
224235
225 - `session_ids: array of string`
226
227236 - `type: "sessions"`
228237
238 - `session_ids: array of string`
239
229240 - `instructions: string or null`
230241
231242 - `model: BetaDreamModelConfig`
from line 271
260271
261272 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.
262273
274 - `type: "update_existing"`
275
263276 - `memory_store_id: string`
264277
265278 minLength: 1
266279
267 - `type: "update_existing"`
268
269280 - `outputs: array of BetaDreamOutput`
270281
271 - `memory_store_id: string`
272
273282 - `type: "memory_store"`
274283
284 - `memory_store_id: string`
285
275286 - `session_id: string or null`
276287
277288 - `status: BetaDreamStatus`
from line 298
287298 - `"failed"`
288299
289300 - `"canceled"`
290
291 - `type: "dream"`
292301
293302 - `usage: BetaDreamUsage`
294303