List Dreams changedapi/beta/dreams/list
Recorded here
Lines+6added
Lines−6removed
From line
11
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits19to this page, all time
The whole hunk
from line 11, old and new numbered
/
from line 11
1111
1212Archived dreams are left out unless `include_archived` is `true`.
1313
14See the [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams#list-dreams) for how to page through dreams.
14See the [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=http#list-dreams) for how to page through dreams.
1515
1616## Query parameters
1717
from line 233
233233
234234 A code for why the dream failed, such as `timeout` or `internal_error`.
235235
236 The [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams#errors) lists common error codes and when they occur.
236 The [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=http#errors) lists common error codes and when they occur.
237237
238238 - `message: string`
239239
from line 271
271271
272272 Give 1 to 100 IDs, with no duplicates. Each session must be in the same workspace as the dream. Responses list the IDs in sorted order.
273273
274 The [limits table in the Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams#limits) lists all the limits on a dream.
274 The [limits table in the Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=http#limits) lists all the limits on a dream.
275275
276276 - `instructions: string or null`
277277
from line 329
329329
330330 The array is empty while the dream is `pending` and for a short time after it starts `running`. It can stay empty if the dream fails or is canceled before then. The memory store holds the complete result only once `status` is `completed`.
331331
332 See the [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams#use-the-output) for how to review and use the result.
332 See the [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=http#use-the-output) for how to review and use the result.
333333
334334 - `type: "memory_store"`
335335
from line 345
345345
346346 Stream that session's events to follow what the dream reads and writes.
347347
348 See the [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams#watch-the-pipeline-run) for how to watch a running dream.
348 See the [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=http#watch-the-pipeline-run) for how to watch a running dream.
349349
350350 - `status: BetaDreamStatus`
351351
from line 353
353353
354354 `completed`, `failed`, and `canceled` are final: once a dream has one of these statuses, its status doesn't change again.
355355
356 See the [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams#lifecycle) for what each status means.
356 See the [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=http#lifecycle) for what each status means.
357357
358358 - `"pending"`
359359
No line in this hunk matches that.