dreams changedmanaged-agents/dreams
Recorded here
Lines+23added
Lines−23removed
From line
25
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits13to this page, all time
The whole hunk
from line 25, old and new numbered
/
from line 25
2525* a pre-existing **memory store:** the store Claude verifies, deduplicates, and reorganizes, and
2626* 1 to 100 **sessions:** past transcripts Claude mines for patterns and insights to fold into the output.
2727
28The dream produces another **output memory store**, separate from the input. The output store ID appears in the dream's `outputs[]` shortly after the dream starts `running`, once the workflow has cloned the input store; a `running` dream can briefly report an empty `outputs[]`.
28The dream produces another **output memory store**, separate from the input. The output store ID appears in the dream's `outputs` (java, php; csharp, go: `Outputs`) array shortly after the dream starts `running`, once the workflow has cloned the input store; a `running` dream can briefly report an empty `outputs` (java, php; csharp, go: `Outputs`) array.
2929
3030## Create a dream
3131
from line 160
160160 ```
161161</CodeGroup>
162162
163Dreaming inputs include the pre-existing memory store and an array of sessions. The selected model runs the dreaming pipeline. During the research preview, `claude-opus-5-5`, `claude-fable-5-1`, `claude-opus-5`, `claude-fable-5`, `claude-opus-4-8`, `claude-opus-4-7`, `claude-sonnet-5-5`, `claude-sonnet-5`, and `claude-sonnet-4-6` are supported. You can optionally pass `instructions` to steer the dreaming process. See [Steer with instructions](https://platform.claude.com/docs/en/managed-agents/dreams#steer-with-instructions).
163Dreaming inputs include the pre-existing memory store and an array of sessions. The selected model runs the dreaming pipeline. During the research preview, `claude-opus-5-5`, `claude-fable-5-1`, `claude-opus-5`, `claude-fable-5`, `claude-opus-4-8`, `claude-opus-4-7`, `claude-sonnet-5-5`, `claude-sonnet-5`, and `claude-sonnet-4-6` are supported. You can optionally pass `instructions` (java, php; csharp, go: `Instructions`) to steer the dreaming process. See [Steer with instructions](https://platform.claude.com/docs/en/managed-agents/dreams#steer-with-instructions).
164164
165165The response is the full `dream` resource with `status: "pending"`:
166166
from line 196
196196
197197### Steer with instructions
198198
199The optional `instructions` field steers what the dreaming pipeline synthesizes. It is applied throughout the pipeline: what to read closely, what to merge or drop, and how to structure the output store.
199The optional `instructions` (java, php; csharp, go: `Instructions`) field steers what the dreaming pipeline synthesizes. It is applied throughout the pipeline: what to read closely, what to merge or drop, and how to structure the output store.
200200
201Use `instructions` for high-level synthesis guidance such as focus areas ("focus on coding-style preferences"), content to preserve unchanged, or output conventions you want applied across the store. The pipeline is a synthesis pass over the inputs, not an editor applied to the text of the store, so imperative directives that target specific lines ("change sentence X to Y", "fix the count in section Z") generally produce no change. To make targeted edits to individual memories, use the [Memory Stores API](https://platform.claude.com/docs/en/managed-agents/memory#view-and-edit-memories) on the output store directly.
201Use `instructions` (java, php; csharp, go: `Instructions`) for high-level synthesis guidance such as focus areas ("focus on coding-style preferences"), content to preserve unchanged, or output conventions you want applied across the store. The pipeline is a synthesis pass over the inputs, not an editor applied to the text of the store, so imperative directives that target specific lines ("change sentence X to Y", "fix the count in section Z") generally produce no change. To make targeted edits to individual memories, use the [Memory Stores API](https://platform.claude.com/docs/en/managed-agents/memory#view-and-edit-memories) on the output store directly.
202202
203203## Track progress
204204
from line 285
285285
286286### Lifecycle
287287
288| `status` | Meaning |
289| ----------- | ----------------------------------------------------------------------------------------------------------------- |
290| `pending` | Dream successfully created and queued. |
291| `running` | The pipeline is processing. `usage` updates as work progresses. |
292| `completed` | Finished successfully. The `outputs[]` value is the new memory store. |
293| `failed` | Dreaming run ended with an error. The output memory store is left as-is with whatever was written before failure. |
294| `canceled` | Dreaming run canceled. The output memory store is left as-is. |
288| `status` (java, php; csharp, go: `Status`) | Meaning |
289| ------------------------------------------ | ----------------------------------------------------------------------------------------------------------------- |
290| `pending` | Dream successfully created and queued. |
291| `running` | The pipeline is processing. `usage` (java, php; csharp, go: `Usage`) updates as work progresses. |
292| `completed` | Finished successfully. The `outputs` (java, php; csharp, go: `Outputs`) value is the new memory store. |
293| `failed` | Dreaming run ended with an error. The output memory store is left as-is with whatever was written before failure. |
294| `canceled` | Dreaming run canceled. The output memory store is left as-is. |
295295
296296### Watch the pipeline run
297297
298Once a dream is `running`, its `session_id` field points at the underlying [session](https://platform.claude.com/docs/en/managed-agents/sessions) running the pipeline. You can stream that session's [events](https://platform.claude.com/docs/en/managed-agents/events-and-streaming) to observe what the dream is reading and writing in real time. The session is archived (not deleted) when the dream reaches a terminal state, so the transcript remains available afterward.
298Once a dream is `running`, its `session_id` (java: `sessionId`; php: `sessionID`; csharp, go: `SessionID`) field points at the underlying [session](https://platform.claude.com/docs/en/managed-agents/sessions) running the pipeline. You can stream that session's [events](https://platform.claude.com/docs/en/managed-agents/events-and-streaming) to observe what the dream is reading and writing in real time. The session is archived (not deleted) when the dream reaches a terminal state, so the transcript remains available afterward.
299299
300300## Use the output
301301
302When `status` reaches `completed`, the `memory_store` entry in `outputs[]` references a fully populated store. It's an ordinary memory store in your workspace. Review it with the [Memory Stores API](https://platform.claude.com/docs/en/managed-agents/memory#view-and-edit-memories) or in the Console, then either:
302When `status` (java, php; csharp, go: `Status`) reaches `completed`, the `memory_store` entry in `outputs` (java, php; csharp, go: `Outputs`) references a fully populated store. It's an ordinary memory store in your workspace. Review it with the [Memory Stores API](https://platform.claude.com/docs/en/managed-agents/memory#view-and-edit-memories) or in the Console, then either:
303303
304304* **Leverage it:** attach it to future sessions as a `memory_store` resource in place of (or alongside) the input memory store, or
305305* **Discard it:** [delete the memory store](https://platform.claude.com/docs/en/api/beta/memory_stores/delete) or [archive the memory store](https://platform.claude.com/docs/en/api/beta/memory_stores/archive).
from line 469
469469Cancel moves a `pending` or `running` dream to `canceled` immediately. Canceling an already-`canceled` dream is an idempotent no-op; canceling a `completed` or `failed` dream returns 400.
470470
471471<Note>
472 After cancellation, the dream's `usage` fields might continue to update for a few seconds while in-flight work winds down. Poll the dream until `usage` stabilizes if you need the final count.
472 After cancellation, the dream's `usage` (java, php; csharp, go: `Usage`) fields might continue to update for a few seconds while in-flight work winds down. Poll the dream until `usage` (java, php; csharp, go: `Usage`) stabilizes if you need the final count.
473473</Note>
474474
475475<CodeGroup>
from line 518
518518
519519## Archive a dream
520520
521Archive sets `archived_at` on a dream that has reached a terminal state (`completed`, `failed`, or `canceled`); `status` is left unchanged. Archived dreams are excluded from default list responses but remain readable by ID. Archiving an already-archived dream is an idempotent no-op. Archiving a `pending` or `running` dream returns 400; cancel it first. There is no unarchive.
521Archive sets `archived_at` (java, php: `archivedAt`; csharp, go: `ArchivedAt`) on a dream that has reached a terminal state (`completed`, `failed`, or `canceled`); `status` (java, php; csharp, go: `Status`) is left unchanged. Archived dreams are excluded from default list responses but remain readable by ID. Archiving an already-archived dream is an idempotent no-op. Archiving a `pending` or `running` dream returns 400; cancel it first. There is no unarchive.
522522
523523<CodeGroup>
524524 ```bash cURL
from line 568
568568
569569## List dreams
570570
571Returns all non-archived dreams in the workspace, newest first. Use `limit` (default 20, max 100) and the `page` cursor to paginate. Pass `include_archived=true` to include archived dreams.
571Returns all non-archived dreams in the workspace, newest first. Use `limit` (java, php; csharp, go: `Limit`) (default 20, max 100) and the `page` (java, php; csharp, go: `Page`) cursor to paginate. Set `include_archived` (java, php: `includeArchived`; csharp, go: `IncludeArchived`) to `true` to include archived dreams.
572572
573573<CodeGroup>
574574 ```bash cURL
from line 650
650650
651651## Billing
652652
653Dreams are billed at standard API token rates for the model you select; `usage` on the resource reports the exact totals. Cost scales roughly linearly with the number and length of input sessions. Start with a small batch of sessions and scale up once you're satisfied with the curation quality.
653Dreams are billed at standard API token rates for the model you select; `usage` (java, php; csharp, go: `Usage`) on the resource reports the exact totals. Cost scales roughly linearly with the number and length of input sessions. Start with a small batch of sessions and scale up once you're satisfied with the curation quality.
654654
655655## Limits
656656
657| Limit | Value |
658| --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
659| Sessions per dream | 100 |
660| `instructions` length | 4,096 characters |
661| Supported models | `claude-opus-5-5`, `claude-fable-5-1`, `claude-opus-5`, `claude-fable-5`, `claude-opus-4-8`, `claude-opus-4-7`, `claude-sonnet-5-5`, `claude-sonnet-5`, `claude-sonnet-4-6` |
657| Limit | Value |
658| ------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
659| Sessions per dream | 100 |
660| `instructions` (java, php; csharp, go: `Instructions`) length | 4,096 characters |
661| Supported models | `claude-opus-5-5`, `claude-fable-5-1`, `claude-opus-5`, `claude-fable-5`, `claude-opus-4-8`, `claude-opus-4-7`, `claude-sonnet-5-5`, `claude-sonnet-5`, `claude-sonnet-4-6` |
662662
663663Default rate limits apply to dream creation while this feature is in research preview. [Contact support](https://support.claude.com) if you need higher limits.
664664
No line in this hunk matches that.