Get a Dream changedapi/beta/dreams/retrieve
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+36added
Lines−33removed
From line
1
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits21to this page, all time
# Get a Dream ## Path parameters ## Headers ## Returns ## Example ### Response (200) ## Get a Dream ### Path Parameters ### Header Parameters ### Returns ### Example #### Response
The whole hunk
from line 1, old and new numbered
/
from line 1
1---
2title: Get a Dream
3url: https://platform.claude.com/docs/en/api/beta/dreams/retrieve
4---
1# Get a Dream
52
6## Get a Dream
3**GET** `/v1/dreams/{dream_id}`
74
8**get** `/v1/dreams/{dream_id}`
9
105Get a Dream
116
12### Path Parameters
7## Path parameters
138
149- `dream_id: string`
1510
16### Header Parameters
11## Headers
1712
1813- `"anthropic-beta": optional array of AnthropicBeta`
1914
from line 86
9186
9287 - `"mid-conversation-tool-changes-2026-07-01"`
9388
94### Returns
89## Returns
9590
96- `BetaDream object { id, archived_at, created_at, 11 more }`
91- `BetaDream object`
9792
9893 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.
9994
from line 98
10398
10499 A timestamp in RFC 3339 format
105100
101 format: date-time
102
106103 - `created_at: string`
107104
108105 A timestamp in RFC 3339 format
109106
107 format: date-time
108
110109 - `ended_at: string or null`
111110
112111 A timestamp in RFC 3339 format
113112
113 format: date-time
114
114115 - `error: BetaDreamError or null`
115116
116117 Failure detail for a Dream whose `status` is `failed`.
from line 122
121122
122123 - `inputs: array of BetaDreamInput`
123124
124 - `BetaDreamMemoryStoreInput object { memory_store_id, type }`
125 - `BetaDreamMemoryStoreInput object`
125126
126127 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.
127128
128129 - `memory_store_id: string`
129130
131 minLength: 1
132
130133 - `type: "memory_store"`
131134
132 - `"memory_store"`
135 - `BetaDreamSessionsInput object`
133136
134 - `BetaDreamSessionsInput object { session_ids, type }`
135
136137 Input session transcripts the dream reads.
137138
138139 - `session_ids: array of string`
from line 140
139140
140141 - `type: "sessions"`
141142
142 - `"sessions"`
143
144143 - `instructions: string or null`
145144
146145 - `model: BetaDreamModelConfig`
from line 150
151150
152151 Model identifier, e.g. "claude-opus-5". 1-256 characters.
153152
153 minLength: 1, maxLength: 256
154
154155 - `speed: optional "standard" or "fast"`
155156
156157 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 164
163164
164165 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.
165166
166 - `BetaOutputBehaviorCreateNew object { type }`
167 - `BetaOutputBehaviorCreateNew object`
167168
168169 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.
169170
170171 - `type: "create_new"`
171172
172 - `"create_new"`
173 - `BetaOutputBehaviorUpdateExisting object`
173174
174 - `BetaOutputBehaviorUpdateExisting object { memory_store_id, type }`
175
176175 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.
177176
178177 - `memory_store_id: string`
179178
179 minLength: 1
180
180181 - `type: "update_existing"`
181182
182 - `"update_existing"`
183
184183 - `outputs: array of BetaDreamOutput`
185184
186185 - `memory_store_id: string`
from line 186
187186
188187 - `type: "memory_store"`
189188
190 - `"memory_store"`
191
192189 - `session_id: string or null`
193190
194191 - `status: BetaDreamStatus`
from line 204
207204
208205 - `type: "dream"`
209206
210 - `"dream"`
211
212207 - `usage: BetaDreamUsage`
213208
214209 Cumulative token usage for the dream across every pipeline stage.
from line 212
217212
218213 Total tokens used to create prompt-cache entries (sum of all TTL tiers).
219214
215 format: int32
216
220217 - `cache_read_input_tokens: number`
221218
222219 Total tokens read from prompt cache.
223220
221 format: int32
222
224223 - `input_tokens: number`
225224
226225 Total uncached input tokens consumed across every pipeline stage.
227226
227 format: int32
228
228229 - `output_tokens: number`
229230
230231 Total output tokens generated across every pipeline stage.
231232
232### Example
233 format: int32
233234
234```http
235## Example
236
237```bash
235238curl https://api.anthropic.com/v1/dreams/$DREAM_ID \
236239 -H 'anthropic-version: 2023-06-01' \
237240 -H 'anthropic-beta: dreaming-2026-04-21' \
from line 241
238241 -H "X-Api-Key: $ANTHROPIC_API_KEY"
239242```
240243
241#### Response
244### Response (200)
242245
243246```json
244247{
No line in this hunk matches that.