Dreams changedapi/beta/dreams
Nearest release: v2.1.283, published 3 hours 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+62added
Lines−70removed
From line
189
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits12to this page, all time
The whole hunk
from line 189, old and new numbered
/
from line 189
189189
190190 - `speed: optional "standard" or "fast" or null`
191191
192 Inference speed mode. `fast` provides significantly faster output token generation at premium pricing. Not all models support `fast`; invalid combinations are rejected at create time.
192 How fast the model generates output for the dream. Defaults to `standard`.
193193
194 Dreams accept only `standard`.
195
194196 - `"standard"`
195197
196198 - `"fast"`
from line 251
249251
250252 - `archived_at: string or null`
251253
252 A timestamp in RFC 3339 format
254 When the dream was archived, in RFC 3339, or `null` if it hasn't been archived.
253255
254256 format: date-time
255257
256258 - `created_at: string`
257259
258 A timestamp in RFC 3339 format
260 When the dream was created, in RFC 3339.
259261
262 Lists of dreams are sorted by this time, newest first.
263
260264 format: date-time
261265
262266 - `ended_at: string or null`
263267
264 A timestamp in RFC 3339 format
268 When the dream reached `completed`, `failed`, or `canceled`, in RFC 3339, or `null` if it is still `pending` or `running`.
265269
266270 format: date-time
267271
268272 - `error: BetaDreamError or null`
269273
270 Failure detail for a Dream whose `status` is `failed`.
274 Why the dream failed, or `null` if `status` isn't `failed`.
271275
272276 - `type: string`
273277
from line 335
331335
332336 - `speed: optional "standard" or "fast"`
333337
334 Inference speed mode. `fast` provides significantly faster output token generation at premium pricing. Not all models support `fast`; invalid combinations are rejected at create time.
338 How fast the model generates output for the dream. Always `standard`.
335339
336340 - `"standard"`
337341
from line 343
339343
340344 - `output_behavior: BetaOutputBehavior`
341345
342 Which memory store a dream writes its result to. Defaults to `create_new` when left out of a create request.
346 Where the dream writes its result, as set in the request that created the dream. If that request left out `output_behavior`, the dream used the `create_new` behavior.
343347
344348 - `BetaOutputBehaviorCreateNew object`
345349
from line 429
425429
426430 - `usage: BetaDreamUsage`
427431
428 The tokens that a dream has used so far.
432 The dream's token counts, which stop changing once its `status` is `completed` or `failed`. After a cancel, they can keep changing.
429433
430 The counts are zero while the dream is `pending` and update while it is `running`. They can keep changing after a cancel.
431
432 See the [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams#billing) for how dreams are billed. See the [prompt caching guide](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#tracking-cache-performance) for how the input token counts add up.
433
434434 - `cache_creation_input_tokens: number`
435435
436436 The dream's input tokens that were written to the prompt cache, for both the 5-minute and 1-hour cache durations.
from line 718
718718
719719 - `archived_at: string or null`
720720
721 A timestamp in RFC 3339 format
721 When the dream was archived, in RFC 3339, or `null` if it hasn't been archived.
722722
723723 format: date-time
724724
725725 - `created_at: string`
726726
727 A timestamp in RFC 3339 format
727 When the dream was created, in RFC 3339.
728728
729 Lists of dreams are sorted by this time, newest first.
730
729731 format: date-time
730732
731733 - `ended_at: string or null`
732734
733 A timestamp in RFC 3339 format
735 When the dream reached `completed`, `failed`, or `canceled`, in RFC 3339, or `null` if it is still `pending` or `running`.
734736
735737 format: date-time
736738
737739 - `error: BetaDreamError or null`
738740
739 Failure detail for a Dream whose `status` is `failed`.
741 Why the dream failed, or `null` if `status` isn't `failed`.
740742
741743 - `type: string`
742744
from line 802
800802
801803 - `speed: optional "standard" or "fast"`
802804
803 Inference speed mode. `fast` provides significantly faster output token generation at premium pricing. Not all models support `fast`; invalid combinations are rejected at create time.
805 How fast the model generates output for the dream. Always `standard`.
804806
805807 - `"standard"`
806808
from line 810
808810
809811 - `output_behavior: BetaOutputBehavior`
810812
811 Which memory store a dream writes its result to. Defaults to `create_new` when left out of a create request.
813 Where the dream writes its result, as set in the request that created the dream. If that request left out `output_behavior`, the dream used the `create_new` behavior.
812814
813815 - `BetaOutputBehaviorCreateNew object`
814816
from line 896
894896
895897 - `usage: BetaDreamUsage`
896898
897 The tokens that a dream has used so far.
899 The dream's token counts, which stop changing once its `status` is `completed` or `failed`. After a cancel, they can keep changing.
898900
899 The counts are zero while the dream is `pending` and update while it is `running`. They can keep changing after a cancel.
900
901 See the [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams#billing) for how dreams are billed. See the [prompt caching guide](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#tracking-cache-performance) for how the input token counts add up.
902
903901 - `cache_creation_input_tokens: number`
904902
905903 The dream's input tokens that were written to the prompt cache, for both the 5-minute and 1-hour cache durations.
from line 1134
11361134
11371135 - `archived_at: string or null`
11381136
1139 A timestamp in RFC 3339 format
1137 When the dream was archived, in RFC 3339, or `null` if it hasn't been archived.
11401138
11411139 format: date-time
11421140
11431141 - `created_at: string`
11441142
1145 A timestamp in RFC 3339 format
1143 When the dream was created, in RFC 3339.
11461144
1145 Lists of dreams are sorted by this time, newest first.
1146
11471147 format: date-time
11481148
11491149 - `ended_at: string or null`
11501150
1151 A timestamp in RFC 3339 format
1151 When the dream reached `completed`, `failed`, or `canceled`, in RFC 3339, or `null` if it is still `pending` or `running`.
11521152
11531153 format: date-time
11541154
11551155 - `error: BetaDreamError or null`
11561156
1157 Failure detail for a Dream whose `status` is `failed`.
1157 Why the dream failed, or `null` if `status` isn't `failed`.
11581158
11591159 - `type: string`
11601160
from line 1218
12181218
12191219 - `speed: optional "standard" or "fast"`
12201220
1221 Inference speed mode. `fast` provides significantly faster output token generation at premium pricing. Not all models support `fast`; invalid combinations are rejected at create time.
1221 How fast the model generates output for the dream. Always `standard`.
12221222
12231223 - `"standard"`
12241224
from line 1226
12261226
12271227 - `output_behavior: BetaOutputBehavior`
12281228
1229 Which memory store a dream writes its result to. Defaults to `create_new` when left out of a create request.
1229 Where the dream writes its result, as set in the request that created the dream. If that request left out `output_behavior`, the dream used the `create_new` behavior.
12301230
12311231 - `BetaOutputBehaviorCreateNew object`
12321232
from line 1312
13121312
13131313 - `usage: BetaDreamUsage`
13141314
1315 The tokens that a dream has used so far.
1315 The dream's token counts, which stop changing once its `status` is `completed` or `failed`. After a cancel, they can keep changing.
13161316
1317 The counts are zero while the dream is `pending` and update while it is `running`. They can keep changing after a cancel.
1318
1319 See the [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams#billing) for how dreams are billed. See the [prompt caching guide](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#tracking-cache-performance) for how the input token counts add up.
1320
13211317 - `cache_creation_input_tokens: number`
13221318
13231319 The dream's input tokens that were written to the prompt cache, for both the 5-minute and 1-hour cache durations.
from line 1539
15431539
15441540 - `archived_at: string or null`
15451541
1546 A timestamp in RFC 3339 format
1542 When the dream was archived, in RFC 3339, or `null` if it hasn't been archived.
15471543
15481544 format: date-time
15491545
15501546 - `created_at: string`
15511547
1552 A timestamp in RFC 3339 format
1548 When the dream was created, in RFC 3339.
15531549
1550 Lists of dreams are sorted by this time, newest first.
1551
15541552 format: date-time
15551553
15561554 - `ended_at: string or null`
15571555
1558 A timestamp in RFC 3339 format
1556 When the dream reached `completed`, `failed`, or `canceled`, in RFC 3339, or `null` if it is still `pending` or `running`.
15591557
15601558 format: date-time
15611559
15621560 - `error: BetaDreamError or null`
15631561
1564 Failure detail for a Dream whose `status` is `failed`.
1562 Why the dream failed, or `null` if `status` isn't `failed`.
15651563
15661564 - `type: string`
15671565
from line 1623
16251623
16261624 - `speed: optional "standard" or "fast"`
16271625
1628 Inference speed mode. `fast` provides significantly faster output token generation at premium pricing. Not all models support `fast`; invalid combinations are rejected at create time.
1626 How fast the model generates output for the dream. Always `standard`.
16291627
16301628 - `"standard"`
16311629
from line 1631
16331631
16341632 - `output_behavior: BetaOutputBehavior`
16351633
1636 Which memory store a dream writes its result to. Defaults to `create_new` when left out of a create request.
1634 Where the dream writes its result, as set in the request that created the dream. If that request left out `output_behavior`, the dream used the `create_new` behavior.
16371635
16381636 - `BetaOutputBehaviorCreateNew object`
16391637
from line 1717
17191717
17201718 - `usage: BetaDreamUsage`
17211719
1722 The tokens that a dream has used so far.
1720 The dream's token counts, which stop changing once its `status` is `completed` or `failed`. After a cancel, they can keep changing.
17231721
1724 The counts are zero while the dream is `pending` and update while it is `running`. They can keep changing after a cancel.
1725
1726 See the [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams#billing) for how dreams are billed. See the [prompt caching guide](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#tracking-cache-performance) for how the input token counts add up.
1727
17281722 - `cache_creation_input_tokens: number`
17291723
17301724 The dream's input tokens that were written to the prompt cache, for both the 5-minute and 1-hour cache durations.
from line 1945
19511945
19521946 - `archived_at: string or null`
19531947
1954 A timestamp in RFC 3339 format
1948 When the dream was archived, in RFC 3339, or `null` if it hasn't been archived.
19551949
19561950 format: date-time
19571951
19581952 - `created_at: string`
19591953
1960 A timestamp in RFC 3339 format
1954 When the dream was created, in RFC 3339.
19611955
1956 Lists of dreams are sorted by this time, newest first.
1957
19621958 format: date-time
19631959
19641960 - `ended_at: string or null`
19651961
1966 A timestamp in RFC 3339 format
1962 When the dream reached `completed`, `failed`, or `canceled`, in RFC 3339, or `null` if it is still `pending` or `running`.
19671963
19681964 format: date-time
19691965
19701966 - `error: BetaDreamError or null`
19711967
1972 Failure detail for a Dream whose `status` is `failed`.
1968 Why the dream failed, or `null` if `status` isn't `failed`.
19731969
19741970 - `type: string`
19751971
from line 2029
20332029
20342030 - `speed: optional "standard" or "fast"`
20352031
2036 Inference speed mode. `fast` provides significantly faster output token generation at premium pricing. Not all models support `fast`; invalid combinations are rejected at create time.
2032 How fast the model generates output for the dream. Always `standard`.
20372033
20382034 - `"standard"`
20392035
from line 2037
20412037
20422038 - `output_behavior: BetaOutputBehavior`
20432039
2044 Which memory store a dream writes its result to. Defaults to `create_new` when left out of a create request.
2040 Where the dream writes its result, as set in the request that created the dream. If that request left out `output_behavior`, the dream used the `create_new` behavior.
20452041
20462042 - `BetaOutputBehaviorCreateNew object`
20472043
from line 2123
21272123
21282124 - `usage: BetaDreamUsage`
21292125
2130 The tokens that a dream has used so far.
2126 The dream's token counts, which stop changing once its `status` is `completed` or `failed`. After a cancel, they can keep changing.
21312127
2132 The counts are zero while the dream is `pending` and update while it is `running`. They can keep changing after a cancel.
2133
2134 See the [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams#billing) for how dreams are billed. See the [prompt caching guide](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#tracking-cache-performance) for how the input token counts add up.
2135
21362128 - `cache_creation_input_tokens: number`
21372129
21382130 The dream's input tokens that were written to the prompt cache, for both the 5-minute and 1-hour cache durations.
from line 2225
22332225
22342226 - `archived_at: string or null`
22352227
2236 A timestamp in RFC 3339 format
2228 When the dream was archived, in RFC 3339, or `null` if it hasn't been archived.
22372229
22382230 format: date-time
22392231
22402232 - `created_at: string`
22412233
2242 A timestamp in RFC 3339 format
2234 When the dream was created, in RFC 3339.
22432235
2236 Lists of dreams are sorted by this time, newest first.
2237
22442238 format: date-time
22452239
22462240 - `ended_at: string or null`
22472241
2248 A timestamp in RFC 3339 format
2242 When the dream reached `completed`, `failed`, or `canceled`, in RFC 3339, or `null` if it is still `pending` or `running`.
22492243
22502244 format: date-time
22512245
22522246 - `error: BetaDreamError or null`
22532247
2254 Failure detail for a Dream whose `status` is `failed`.
2248 Why the dream failed, or `null` if `status` isn't `failed`.
22552249
22562250 - `type: string`
22572251
from line 2309
23152309
23162310 - `speed: optional "standard" or "fast"`
23172311
2318 Inference speed mode. `fast` provides significantly faster output token generation at premium pricing. Not all models support `fast`; invalid combinations are rejected at create time.
2312 How fast the model generates output for the dream. Always `standard`.
23192313
23202314 - `"standard"`
23212315
from line 2317
23232317
23242318 - `output_behavior: BetaOutputBehavior`
23252319
2326 Which memory store a dream writes its result to. Defaults to `create_new` when left out of a create request.
2320 Where the dream writes its result, as set in the request that created the dream. If that request left out `output_behavior`, the dream used the `create_new` behavior.
23272321
23282322 - `BetaOutputBehaviorCreateNew object`
23292323
from line 2403
24092403
24102404 - `usage: BetaDreamUsage`
24112405
2412 The tokens that a dream has used so far.
2406 The dream's token counts, which stop changing once its `status` is `completed` or `failed`. After a cancel, they can keep changing.
24132407
2414 The counts are zero while the dream is `pending` and update while it is `running`. They can keep changing after a cancel.
2415
2416 See the [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams#billing) for how dreams are billed. See the [prompt caching guide](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#tracking-cache-performance) for how the input token counts add up.
2417
24182408 - `cache_creation_input_tokens: number`
24192409
24202410 The dream's input tokens that were written to the prompt cache, for both the 5-minute and 1-hour cache durations.
from line 2529
25392529
25402530 - `speed: optional "standard" or "fast"`
25412531
2542 Inference speed mode. `fast` provides significantly faster output token generation at premium pricing. Not all models support `fast`; invalid combinations are rejected at create time.
2532 How fast the model generates output for the dream. Always `standard`.
25432533
25442534 - `"standard"`
25452535
from line 2553
25632553
25642554 - `speed: optional "standard" or "fast" or null`
25652555
2566 Inference speed mode. `fast` provides significantly faster output token generation at premium pricing. Not all models support `fast`; invalid combinations are rejected at create time.
2556 How fast the model generates output for the dream. Defaults to `standard`.
25672557
2558 Dreams accept only `standard`.
2559
25682560 - `"standard"`
25692561
25702562 - `"fast"`
from line 2565
25732565
25742566- `BetaDreamOutput object`
25752567
2576 The memory store that holds a dream's result, as an entry in `outputs`.
2568 An entry in a dream's `outputs` that references the memory store holding its result.
25772569
25782570 - `type: "memory_store"`
25792571
No line in this hunk matches that.