One change

List Dreams

api/beta/dreams/list

25 Aug 2026 03:37 UTC first seen 14 Aug 2026 The page's own history The capture it came from

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.

api/beta/dreams/list Changed · +40 / -31 lines

# List Dreams ## Query parameters ## Headers ## Returns ## Example ### Response (200) ## List Dreams ### Query Parameters ### Header Parameters ### Returns ### Example #### Response

from line 1

----
-title: List Dreams
-url: https://platform.claude.com/docs/en/api/beta/dreams/list
----
+# List Dreams
 
-## List Dreams
+**GET** `/v1/dreams`
 
-**get** `/v1/dreams`
-
 List Dreams
 
-### Query Parameters
+## Query parameters
 
 - `"created_at[gt]": optional string`
 
   Return dreams with `created_at` strictly after this timestamp (exclusive lower bound, RFC 3339). Unset applies no lower bound.
 
+  format: date-time
+
 - `"created_at[lt]": optional string`
 
   Return dreams with `created_at` strictly before this timestamp (exclusive upper bound, RFC 3339). Unset applies no upper bound.
 
+  format: date-time
+
 - `include_archived: optional boolean`
 
   Query parameter for include_archived

from line 26

 
   Query parameter for limit
 
+  format: int32
+
 - `page: optional string`
 
   Query parameter for page

from line 46

 
   - `"canceled"`
 
-### Header Parameters
+## Headers
 
 - `"anthropic-beta": optional array of AnthropicBeta`

from line 124

 
     - `"mid-conversation-tool-changes-2026-07-01"`
 
-### Returns
+## Returns
 
 - `data: array of BetaDream`

from line 134

 
     A timestamp in RFC 3339 format
 
+    format: date-time
+
   - `created_at: string`
 
     A timestamp in RFC 3339 format
 
+    format: date-time
+
   - `ended_at: string or null`
 
     A timestamp in RFC 3339 format
 
+    format: date-time
+
   - `error: BetaDreamError or null`
 
     Failure detail for a Dream whose `status` is `failed`.

from line 158

 
   - `inputs: array of BetaDreamInput`
 
-    - `BetaDreamMemoryStoreInput object { memory_store_id, type }`
+    - `BetaDreamMemoryStoreInput object`
 
       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.
 
       - `memory_store_id: string`
 
+        minLength: 1
+
       - `type: "memory_store"`
 
-        - `"memory_store"`
+    - `BetaDreamSessionsInput object`
 
-    - `BetaDreamSessionsInput object { session_ids, type }`
-
       Input session transcripts the dream reads.
 
       - `session_ids: array of string`

from line 176

 
       - `type: "sessions"`
 
-        - `"sessions"`
-
   - `instructions: string or null`
 
   - `model: BetaDreamModelConfig`

from line 186

 
       Model identifier, e.g. "claude-opus-5". 1-256 characters.
 
+      minLength: 1, maxLength: 256
+
     - `speed: optional "standard" or "fast"`
 
       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

 
     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.
 
-    - `BetaOutputBehaviorCreateNew object { type }`
+    - `BetaOutputBehaviorCreateNew object`
 
       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.
 
       - `type: "create_new"`
 
-        - `"create_new"`
+    - `BetaOutputBehaviorUpdateExisting object`
 
-    - `BetaOutputBehaviorUpdateExisting object { memory_store_id, type }`
-
       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.
 
       - `memory_store_id: string`
 
+        minLength: 1
+
       - `type: "update_existing"`
 
-        - `"update_existing"`
-
   - `outputs: array of BetaDreamOutput`
 
     - `memory_store_id: string`

from line 222

 
     - `type: "memory_store"`
 
-      - `"memory_store"`
-
   - `session_id: string or null`
 
   - `status: BetaDreamStatus`

from line 240

 
   - `type: "dream"`
 
-    - `"dream"`
-
   - `usage: BetaDreamUsage`
 
     Cumulative token usage for the dream across every pipeline stage.

from line 248

 
       Total tokens used to create prompt-cache entries (sum of all TTL tiers).
 
+      format: int32
+
     - `cache_read_input_tokens: number`
 
       Total tokens read from prompt cache.
 
+      format: int32
+
     - `input_tokens: number`
 
       Total uncached input tokens consumed across every pipeline stage.
 
+      format: int32
+
     - `output_tokens: number`
 
       Total output tokens generated across every pipeline stage.
 
+      format: int32
+
 - `next_page: string or null`
 
-### Example
+## Example
 
-```http
+```bash
 curl https://api.anthropic.com/v1/dreams \
     -H 'anthropic-version: 2023-06-01' \
     -H 'anthropic-beta: dreaming-2026-04-21' \

from line 279

     -H "X-Api-Key: $ANTHROPIC_API_KEY"
 ```
 
-#### Response
+### Response (200)
 
 ```json
 {