List Dreams changedapi/beta/dreams/list
Nearest release: v2.1.245, published 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+40added
Lines−31removed
From line
1
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits20to this page, all time
# List Dreams ## Query parameters ## Headers ## Returns ## Example ### Response (200) ## List Dreams ### Query Parameters ### Header Parameters ### Returns ### Example #### Response
The whole hunk
from line 1, old and new numbered
/
from line 1
1---
2title: List Dreams
3url: https://platform.claude.com/docs/en/api/beta/dreams/list
4---
1# List Dreams
52
6## List Dreams
3**GET** `/v1/dreams`
74
8**get** `/v1/dreams`
9
105List Dreams
116
12### Query Parameters
7## Query parameters
138
149- `"created_at[gt]": optional string`
1510
1611 Return dreams with `created_at` strictly after this timestamp (exclusive lower bound, RFC 3339). Unset applies no lower bound.
1712
13 format: date-time
14
1815- `"created_at[lt]": optional string`
1916
2017 Return dreams with `created_at` strictly before this timestamp (exclusive upper bound, RFC 3339). Unset applies no upper bound.
2118
19 format: date-time
20
2221- `include_archived: optional boolean`
2322
2423 Query parameter for include_archived
from line 26
2726
2827 Query parameter for limit
2928
29 format: int32
30
3031- `page: optional string`
3132
3233 Query parameter for page
from line 46
4546
4647 - `"canceled"`
4748
48### Header Parameters
49## Headers
4950
5051- `"anthropic-beta": optional array of AnthropicBeta`
5152
from line 124
123124
124125 - `"mid-conversation-tool-changes-2026-07-01"`
125126
126### Returns
127## Returns
127128
128129- `data: array of BetaDream`
129130
from line 134
133134
134135 A timestamp in RFC 3339 format
135136
137 format: date-time
138
136139 - `created_at: string`
137140
138141 A timestamp in RFC 3339 format
139142
143 format: date-time
144
140145 - `ended_at: string or null`
141146
142147 A timestamp in RFC 3339 format
143148
149 format: date-time
150
144151 - `error: BetaDreamError or null`
145152
146153 Failure detail for a Dream whose `status` is `failed`.
from line 158
151158
152159 - `inputs: array of BetaDreamInput`
153160
154 - `BetaDreamMemoryStoreInput object { memory_store_id, type }`
161 - `BetaDreamMemoryStoreInput object`
155162
156163 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.
157164
158165 - `memory_store_id: string`
159166
167 minLength: 1
168
160169 - `type: "memory_store"`
161170
162 - `"memory_store"`
171 - `BetaDreamSessionsInput object`
163172
164 - `BetaDreamSessionsInput object { session_ids, type }`
165
166173 Input session transcripts the dream reads.
167174
168175 - `session_ids: array of string`
from line 176
169176
170177 - `type: "sessions"`
171178
172 - `"sessions"`
173
174179 - `instructions: string or null`
175180
176181 - `model: BetaDreamModelConfig`
from line 186
181186
182187 Model identifier, e.g. "claude-opus-5". 1-256 characters.
183188
189 minLength: 1, maxLength: 256
190
184191 - `speed: optional "standard" or "fast"`
185192
186193 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.
from line 200
193200
194201 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.
195202
196 - `BetaOutputBehaviorCreateNew object { type }`
203 - `BetaOutputBehaviorCreateNew object`
197204
198205 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.
199206
200207 - `type: "create_new"`
201208
202 - `"create_new"`
209 - `BetaOutputBehaviorUpdateExisting object`
203210
204 - `BetaOutputBehaviorUpdateExisting object { memory_store_id, type }`
205
206211 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.
207212
208213 - `memory_store_id: string`
209214
215 minLength: 1
216
210217 - `type: "update_existing"`
211218
212 - `"update_existing"`
213
214219 - `outputs: array of BetaDreamOutput`
215220
216221 - `memory_store_id: string`
from line 222
217222
218223 - `type: "memory_store"`
219224
220 - `"memory_store"`
221
222225 - `session_id: string or null`
223226
224227 - `status: BetaDreamStatus`
from line 240
237240
238241 - `type: "dream"`
239242
240 - `"dream"`
241
242243 - `usage: BetaDreamUsage`
243244
244245 Cumulative token usage for the dream across every pipeline stage.
from line 248
247248
248249 Total tokens used to create prompt-cache entries (sum of all TTL tiers).
249250
251 format: int32
252
250253 - `cache_read_input_tokens: number`
251254
252255 Total tokens read from prompt cache.
253256
257 format: int32
258
254259 - `input_tokens: number`
255260
256261 Total uncached input tokens consumed across every pipeline stage.
257262
263 format: int32
264
258265 - `output_tokens: number`
259266
260267 Total output tokens generated across every pipeline stage.
261268
269 format: int32
270
262271- `next_page: string or null`
263272
264### Example
273## Example
265274
266```http
275```bash
267276curl https://api.anthropic.com/v1/dreams \
268277 -H 'anthropic-version: 2023-06-01' \
269278 -H 'anthropic-beta: dreaming-2026-04-21' \
from line 279
270279 -H "X-Api-Key: $ANTHROPIC_API_KEY"
271280```
272281
273#### Response
282### Response (200)
274283
275284```json
276285{
No line in this hunk matches that.