--- title: Dreams url: https://platform.claude.com/docs/en/api/java/beta/dreams --- # Dreams ## Create a Dream `BetaDream beta().dreams().create(params, requestOptions = RequestOptions.none())` **POST** `/v1/dreams` Start an asynchronous job that uses past sessions to produce a reorganized version of a memory store and get back the dream to poll for the result. By default the dream writes its result to a new memory store and doesn't change the input memory store. The response has `status` set to `pending` and an empty `outputs` array. Poll the dream until `status` is `completed`, `failed`, or `canceled`. See the [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#create-a-dream) to learn more about creating dreams. ### Parameters - `DreamCreateParams params` - `Optional> betas` (header parameter) This endpoint is in beta: requests must send `dreaming-2026-04-21` in this header. - `MESSAGE_BATCHES_2024_09_24("message-batches-2024-09-24")` - `PROMPT_CACHING_2024_07_31("prompt-caching-2024-07-31")` - `COMPUTER_USE_2024_10_22("computer-use-2024-10-22")` - `COMPUTER_USE_2025_01_24("computer-use-2025-01-24")` - `PDFS_2024_09_25("pdfs-2024-09-25")` - `TOKEN_COUNTING_2024_11_01("token-counting-2024-11-01")` - `TOKEN_EFFICIENT_TOOLS_2025_02_19("token-efficient-tools-2025-02-19")` - `OUTPUT_128K_2025_02_19("output-128k-2025-02-19")` - `FILES_API_2025_04_14("files-api-2025-04-14")` - `MCP_CLIENT_2025_04_04("mcp-client-2025-04-04")` - `MCP_CLIENT_2025_11_20("mcp-client-2025-11-20")` - `DEV_FULL_THINKING_2025_05_14("dev-full-thinking-2025-05-14")` - `INTERLEAVED_THINKING_2025_05_14("interleaved-thinking-2025-05-14")` - `CODE_EXECUTION_2025_05_22("code-execution-2025-05-22")` - `EXTENDED_CACHE_TTL_2025_04_11("extended-cache-ttl-2025-04-11")` - `CONTEXT_1M_2025_08_07("context-1m-2025-08-07")` - `CONTEXT_MANAGEMENT_2025_06_27("context-management-2025-06-27")` - `MODEL_CONTEXT_WINDOW_EXCEEDED_2025_08_26("model-context-window-exceeded-2025-08-26")` - `SKILLS_2025_10_02("skills-2025-10-02")` - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` - `USER_PROFILES_2026_08_18("user-profiles-2026-08-18")` - `USER_PROFILES_2026_09_04("user-profiles-2026-09-04")` - `ADVISOR_TOOL_2026_03_01("advisor-tool-2026-03-01")` - `MANAGED_AGENTS_2026_04_01("managed-agents-2026-04-01")` - `CACHE_DIAGNOSIS_2026_04_07("cache-diagnosis-2026-04-07")` - `DREAMING_2026_04_21("dreaming-2026-04-21")` - `THINKING_TOKEN_COUNT_2026_05_13("thinking-token-count-2026-05-13")` - `SERVER_SIDE_FALLBACK_2026_06_01("server-side-fallback-2026-06-01")` - `SERVER_SIDE_FALLBACK_2026_07_01("server-side-fallback-2026-07-01")` - `FALLBACK_CREDIT_2026_06_01("fallback-credit-2026-06-01")` - `FALLBACK_CREDIT_2026_07_01("fallback-credit-2026-07-01")` - `AGENT_MEMORY_2026_07_22("agent-memory-2026-07-22")` - `MID_CONVERSATION_TOOL_CHANGES_2026_07_01("mid-conversation-tool-changes-2026-07-01")` - `COMPACT_2026_01_12("compact-2026-01-12")` - `COMPUTER_USE_2025_11_24("computer-use-2025-11-24")` - `MCP_TUNNELS_2026_06_22("mcp-tunnels-2026-06-22")` - `STRUCTURED_OUTPUTS_2025_11_13("structured-outputs-2025-11-13")` - `TASK_BUDGETS_2026_03_13("task-budgets-2026-03-13")` - `THINKING_DISPLAY_UPDATES_2026_08_18("thinking-display-updates-2026-08-18")` - `CE_USER_MANAGEMENT_2026_07_13("ce-user-management-2026-07-13")` - `MID_CONVERSATION_OUTPUT_CONFIG_2026_07_01("mid-conversation-output-config-2026-07-01")` - `THINKING_BINDING_CONTROLS_2026_08_01("thinking-binding-controls-2026-08-01")` - `MID_CONVERSATION_SYSTEM_CLEAR_AT_2026_08_21("mid-conversation-system-clear-at-2026-08-21")` - `COMPACT_2026_09_04("compact-2026-09-04")` - `INLINE_TOOLS_2026_09_15("inline-tools-2026-09-15")` - `MCP_CLIENT_2026_09_15("mcp-client-2026-09-15")` - `CE_PLUGINS_2026_09_01("ce-plugins-2026-09-01")` - `SPEND_LIMIT_READS_2026_09_26("spend-limit-reads-2026-09-26")` - `TELEMETRY_DESTINATIONS_2026_08_11("telemetry-destinations-2026-08-11")` - `Optional workspaceId` (header parameter) Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`). Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace. - `List inputs` The memory store and sessions for the dream to read, as exactly one `memory_store` entry and exactly one `sessions` entry. - `class BetaDreamMemoryStoreInput` The memory store that a dream reads, given as an entry in `inputs`. With `output_behavior` set to `update_existing`, the dream writes its result into this memory store. Otherwise the dream doesn't change it. - `Type type` - `String memoryStoreId` The ID of the memory store for the dream to read (`memstore_...`). The memory store must be in the same workspace as the dream and must not be archived. minLength: 1 - `class BetaDreamSessionsInput` The sessions that a dream reads, given as an entry in `inputs`. - `Type type` - `List sessionIds` The IDs of the sessions whose transcripts the dream reads (`sesn_...`). 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. The [limits table in the Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#limits) lists all the limits on a dream. - `Model model` The model that runs a dream, given as a model ID or as an object with `id` and `speed`. In the object form, `speed` can only be `standard`. The [limits table in the Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#limits) lists the supported models. - `String` - `class BetaDreamModelConfigParam` The object form of `model` in a request to create a dream. - `String id` The ID of the model to run the dream with. The ID can be 1 to 256 characters long. The [limits table in the Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#limits) lists the supported models. minLength: 1, maxLength: 256 - `Optional speed` How fast the model generates output for the dream. Defaults to `standard`. Dreams accept only `standard`. - `STANDARD("standard")` - `FAST("fast")` - `Optional instructions` Guidance that steers how the dream reads the sessions and organizes the output memory store, from 1 to 4,096 characters. See the [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#steer-with-instructions) for what kinds of instructions work well. minLength: 1, maxLength: 4096 - `Optional outputBehavior` Which memory store a dream writes its result to. Defaults to `create_new` when left out of a create request. ### Returns - `class BetaDream` An asynchronous job that reads a memory store and past sessions, then writes a reorganized version of that memory store. By default the dream writes its result to a new memory store and doesn't change the input memory store. With `output_behavior` set to `update_existing`, it writes its result into the input memory store instead. 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. See the [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#how-it-works) for what a dream reads and produces. - `Type type` - `String id` The unique ID of the dream (`drm_...`). - `Optional archivedAt` When the dream was archived, in RFC 3339, or `null` if it hasn't been archived. format: date-time - `LocalDateTime createdAt` When the dream was created, in RFC 3339. Lists of dreams are sorted by this time, newest first. format: date-time - `Optional endedAt` When the dream reached `completed`, `failed`, or `canceled`, in RFC 3339, or `null` if it is still `pending` or `running`. format: date-time - `Optional error` Why the dream failed, or `null` if `status` isn't `failed`. - `String type` A code for why the dream failed, such as `timeout` or `internal_error`. The [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#errors) lists common error codes and when they occur. - `String message` A human-readable explanation of why the dream failed. - `List inputs` The sources that the dream reads, from the request that created it. - `class BetaDreamMemoryStoreInput` The memory store that a dream reads, given as an entry in `inputs`. With `output_behavior` set to `update_existing`, the dream writes its result into this memory store. Otherwise the dream doesn't change it. - `Type type` - `String memoryStoreId` The ID of the memory store for the dream to read (`memstore_...`). The memory store must be in the same workspace as the dream and must not be archived. minLength: 1 - `class BetaDreamSessionsInput` The sessions that a dream reads, given as an entry in `inputs`. - `Type type` - `List sessionIds` The IDs of the sessions whose transcripts the dream reads (`sesn_...`). 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. The [limits table in the Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#limits) lists all the limits on a dream. - `Optional instructions` The guidance given when the dream was created, or `null` if none was given. - `BetaDreamModelConfig model` The model that runs a dream, from the request that created it. The dream uses this model for all of its work. The response always gives the model as an object, even if the request gave only a model ID. - `String id` The ID of the model that runs the dream, as given in the request that created it. minLength: 1, maxLength: 256 - `Optional speed` How fast the model generates output for the dream. Always `standard`. - `STANDARD("standard")` - `FAST("fast")` - `BetaOutputBehavior outputBehavior` Where the dream writes its result, as set in the request that created the dream. If that request left out `output_behavior`, the dream used the `create_new` behavior. - `class BetaOutputBehaviorCreateNew` Write the result to a new memory store that starts as a copy of the input memory store. This is the default. The new memory store is in the same workspace as the dream. The dream doesn't change the input memory store. - `Type type` - `class BetaOutputBehaviorUpdateExisting` Write the result into the input memory store instead of a new memory store. The credential must be allowed to write memory stores, or the request returns a 403 error. While another `update_existing` dream on the same memory store hasn't fully stopped, the request returns a 409 error. - `Type type` - `String memoryStoreId` The ID of the memory store for the dream to write its result to (`memstore_...`). It must be the memory store in the `memory_store` entry of `inputs`. minLength: 1 - `List outputs` The memory store that holds the dream's result, as a one-item array, or an empty array until the dream records that memory store. 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`. See the [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#use-the-output) for how to review and use the result. - `Type type` - `String memoryStoreId` The ID of the memory store that the dream writes its result to (`memstore_...`). With `output_behavior` set to `create_new`, this is a new memory store. With `update_existing`, it is the input memory store. - `Optional sessionId` The ID of the session that runs the dream (`sesn_...`), or `null` if that session hasn't started. Stream that session's events to follow what the dream reads and writes. See the [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#watch-the-pipeline-run) for how to watch a running dream. - `BetaDreamStatus status` Where a dream is in its lifecycle. `completed`, `failed`, and `canceled` are final: once a dream has one of these statuses, its status doesn't change again. See the [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#lifecycle) for what each status means. - `PENDING("pending")` The dream is waiting to start and hasn't read its inputs yet. `outputs` is empty and every `usage` count is zero. - `RUNNING("running")` The dream is reading its inputs and writing its result. `usage` updates while the dream has this status. - `COMPLETED("completed")` The dream finished and its output memory store holds the complete result. - `FAILED("failed")` The dream stopped with an error, which `error` describes. If `outputs` references a memory store, that memory store keeps what the dream wrote before it stopped. - `CANCELED("canceled")` A cancel request stopped the dream before it reached `completed` or `failed`. If `outputs` references a memory store, that memory store keeps what the dream wrote. `usage` can keep changing after the cancel. - `BetaDreamUsage usage` The dream's token counts, which stop changing once its `status` is `completed` or `failed`. After a cancel, they can keep changing. - `long cacheCreationInputTokens` The dream's input tokens that were written to the prompt cache, for both the 5-minute and 1-hour cache durations. format: int32 - `long cacheReadInputTokens` The dream's input tokens that were read from the prompt cache. format: int32 - `long inputTokens` The dream's input tokens that weren't read from or written to the prompt cache. format: int32 - `long outputTokens` The tokens that the model generated for the dream. format: int32 ### Example ```java package com.anthropic.example; import com.anthropic.client.AnthropicClient; import com.anthropic.client.okhttp.AnthropicOkHttpClient; import com.anthropic.models.beta.dreams.BetaDream; import com.anthropic.models.beta.dreams.DreamCreateParams; public final class Main { private Main() {} public static void main(String[] args) { AnthropicClient client = AnthropicOkHttpClient.fromEnv(); DreamCreateParams params = DreamCreateParams.builder() .addMemoryStoreInput("x") .model("string") .build(); BetaDream betaDream = client.beta().dreams().create(params); } } ``` #### Response (200) ```json { "id": "id", "archived_at": "2019-12-27T18:11:19.117Z", "created_at": "2019-12-27T18:11:19.117Z", "ended_at": "2019-12-27T18:11:19.117Z", "error": { "message": "message", "type": "type" }, "inputs": [ { "memory_store_id": "x", "type": "memory_store" } ], "instructions": "instructions", "model": { "id": "x", "speed": "standard" }, "output_behavior": { "type": "create_new" }, "outputs": [ { "memory_store_id": "memory_store_id", "type": "memory_store" } ], "session_id": "session_id", "status": "pending", "type": "dream", "usage": { "cache_creation_input_tokens": 0, "cache_read_input_tokens": 0, "input_tokens": 0, "output_tokens": 0 } } ``` ## List Dreams `DreamListPage beta().dreams().list(params = DreamListParams.none(), requestOptions = RequestOptions.none())` **GET** `/v1/dreams` List the dreams in the workspace, newest first. Archived dreams are left out unless `include_archived` is `true`. See the [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#list-dreams) for how to page through dreams. ### Parameters - `DreamListParams params` - `Optional createdAtGt` (query parameter) Return only dreams created after this time (exclusive), in RFC 3339. format: date-time - `Optional createdAtLt` (query parameter) Return only dreams created before this time (exclusive), in RFC 3339. format: date-time - `Optional includeArchived` (query parameter) Whether to include archived dreams. Defaults to `false`. - `Optional limit` (query parameter) The maximum number of dreams to return, from 1 to 100. Defaults to 20. format: int32 - `Optional page` (query parameter) The cursor for the page to return, taken from `next_page` in a previous response. Leave it out to get the first page. - `Optional> statuses` (query parameter) Return only dreams that have one of these statuses. Repeat the parameter to give more than one status. Leave it out to return dreams of every status. - `PENDING("pending")` The dream is waiting to start and hasn't read its inputs yet. `outputs` is empty and every `usage` count is zero. - `RUNNING("running")` The dream is reading its inputs and writing its result. `usage` updates while the dream has this status. - `COMPLETED("completed")` The dream finished and its output memory store holds the complete result. - `FAILED("failed")` The dream stopped with an error, which `error` describes. If `outputs` references a memory store, that memory store keeps what the dream wrote before it stopped. - `CANCELED("canceled")` A cancel request stopped the dream before it reached `completed` or `failed`. If `outputs` references a memory store, that memory store keeps what the dream wrote. `usage` can keep changing after the cancel. - `Optional> betas` (header parameter) This endpoint is in beta: requests must send `dreaming-2026-04-21` in this header. - `MESSAGE_BATCHES_2024_09_24("message-batches-2024-09-24")` - `PROMPT_CACHING_2024_07_31("prompt-caching-2024-07-31")` - `COMPUTER_USE_2024_10_22("computer-use-2024-10-22")` - `COMPUTER_USE_2025_01_24("computer-use-2025-01-24")` - `PDFS_2024_09_25("pdfs-2024-09-25")` - `TOKEN_COUNTING_2024_11_01("token-counting-2024-11-01")` - `TOKEN_EFFICIENT_TOOLS_2025_02_19("token-efficient-tools-2025-02-19")` - `OUTPUT_128K_2025_02_19("output-128k-2025-02-19")` - `FILES_API_2025_04_14("files-api-2025-04-14")` - `MCP_CLIENT_2025_04_04("mcp-client-2025-04-04")` - `MCP_CLIENT_2025_11_20("mcp-client-2025-11-20")` - `DEV_FULL_THINKING_2025_05_14("dev-full-thinking-2025-05-14")` - `INTERLEAVED_THINKING_2025_05_14("interleaved-thinking-2025-05-14")` - `CODE_EXECUTION_2025_05_22("code-execution-2025-05-22")` - `EXTENDED_CACHE_TTL_2025_04_11("extended-cache-ttl-2025-04-11")` - `CONTEXT_1M_2025_08_07("context-1m-2025-08-07")` - `CONTEXT_MANAGEMENT_2025_06_27("context-management-2025-06-27")` - `MODEL_CONTEXT_WINDOW_EXCEEDED_2025_08_26("model-context-window-exceeded-2025-08-26")` - `SKILLS_2025_10_02("skills-2025-10-02")` - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` - `USER_PROFILES_2026_08_18("user-profiles-2026-08-18")` - `USER_PROFILES_2026_09_04("user-profiles-2026-09-04")` - `ADVISOR_TOOL_2026_03_01("advisor-tool-2026-03-01")` - `MANAGED_AGENTS_2026_04_01("managed-agents-2026-04-01")` - `CACHE_DIAGNOSIS_2026_04_07("cache-diagnosis-2026-04-07")` - `DREAMING_2026_04_21("dreaming-2026-04-21")` - `THINKING_TOKEN_COUNT_2026_05_13("thinking-token-count-2026-05-13")` - `SERVER_SIDE_FALLBACK_2026_06_01("server-side-fallback-2026-06-01")` - `SERVER_SIDE_FALLBACK_2026_07_01("server-side-fallback-2026-07-01")` - `FALLBACK_CREDIT_2026_06_01("fallback-credit-2026-06-01")` - `FALLBACK_CREDIT_2026_07_01("fallback-credit-2026-07-01")` - `AGENT_MEMORY_2026_07_22("agent-memory-2026-07-22")` - `MID_CONVERSATION_TOOL_CHANGES_2026_07_01("mid-conversation-tool-changes-2026-07-01")` - `COMPACT_2026_01_12("compact-2026-01-12")` - `COMPUTER_USE_2025_11_24("computer-use-2025-11-24")` - `MCP_TUNNELS_2026_06_22("mcp-tunnels-2026-06-22")` - `STRUCTURED_OUTPUTS_2025_11_13("structured-outputs-2025-11-13")` - `TASK_BUDGETS_2026_03_13("task-budgets-2026-03-13")` - `THINKING_DISPLAY_UPDATES_2026_08_18("thinking-display-updates-2026-08-18")` - `CE_USER_MANAGEMENT_2026_07_13("ce-user-management-2026-07-13")` - `MID_CONVERSATION_OUTPUT_CONFIG_2026_07_01("mid-conversation-output-config-2026-07-01")` - `THINKING_BINDING_CONTROLS_2026_08_01("thinking-binding-controls-2026-08-01")` - `MID_CONVERSATION_SYSTEM_CLEAR_AT_2026_08_21("mid-conversation-system-clear-at-2026-08-21")` - `COMPACT_2026_09_04("compact-2026-09-04")` - `INLINE_TOOLS_2026_09_15("inline-tools-2026-09-15")` - `MCP_CLIENT_2026_09_15("mcp-client-2026-09-15")` - `CE_PLUGINS_2026_09_01("ce-plugins-2026-09-01")` - `SPEND_LIMIT_READS_2026_09_26("spend-limit-reads-2026-09-26")` - `TELEMETRY_DESTINATIONS_2026_08_11("telemetry-destinations-2026-08-11")` - `Optional workspaceId` (header parameter) Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`). Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace. ### Returns - `class BetaDream` An asynchronous job that reads a memory store and past sessions, then writes a reorganized version of that memory store. By default the dream writes its result to a new memory store and doesn't change the input memory store. With `output_behavior` set to `update_existing`, it writes its result into the input memory store instead. 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. See the [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#how-it-works) for what a dream reads and produces. - `Type type` - `String id` The unique ID of the dream (`drm_...`). - `Optional archivedAt` When the dream was archived, in RFC 3339, or `null` if it hasn't been archived. format: date-time - `LocalDateTime createdAt` When the dream was created, in RFC 3339. Lists of dreams are sorted by this time, newest first. format: date-time - `Optional endedAt` When the dream reached `completed`, `failed`, or `canceled`, in RFC 3339, or `null` if it is still `pending` or `running`. format: date-time - `Optional error` Why the dream failed, or `null` if `status` isn't `failed`. - `String type` A code for why the dream failed, such as `timeout` or `internal_error`. The [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#errors) lists common error codes and when they occur. - `String message` A human-readable explanation of why the dream failed. - `List inputs` The sources that the dream reads, from the request that created it. - `class BetaDreamMemoryStoreInput` The memory store that a dream reads, given as an entry in `inputs`. With `output_behavior` set to `update_existing`, the dream writes its result into this memory store. Otherwise the dream doesn't change it. - `Type type` - `String memoryStoreId` The ID of the memory store for the dream to read (`memstore_...`). The memory store must be in the same workspace as the dream and must not be archived. minLength: 1 - `class BetaDreamSessionsInput` The sessions that a dream reads, given as an entry in `inputs`. - `Type type` - `List sessionIds` The IDs of the sessions whose transcripts the dream reads (`sesn_...`). 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. The [limits table in the Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#limits) lists all the limits on a dream. - `Optional instructions` The guidance given when the dream was created, or `null` if none was given. - `BetaDreamModelConfig model` The model that runs a dream, from the request that created it. The dream uses this model for all of its work. The response always gives the model as an object, even if the request gave only a model ID. - `String id` The ID of the model that runs the dream, as given in the request that created it. minLength: 1, maxLength: 256 - `Optional speed` How fast the model generates output for the dream. Always `standard`. - `STANDARD("standard")` - `FAST("fast")` - `BetaOutputBehavior outputBehavior` Where the dream writes its result, as set in the request that created the dream. If that request left out `output_behavior`, the dream used the `create_new` behavior. - `class BetaOutputBehaviorCreateNew` Write the result to a new memory store that starts as a copy of the input memory store. This is the default. The new memory store is in the same workspace as the dream. The dream doesn't change the input memory store. - `Type type` - `class BetaOutputBehaviorUpdateExisting` Write the result into the input memory store instead of a new memory store. The credential must be allowed to write memory stores, or the request returns a 403 error. While another `update_existing` dream on the same memory store hasn't fully stopped, the request returns a 409 error. - `Type type` - `String memoryStoreId` The ID of the memory store for the dream to write its result to (`memstore_...`). It must be the memory store in the `memory_store` entry of `inputs`. minLength: 1 - `List outputs` The memory store that holds the dream's result, as a one-item array, or an empty array until the dream records that memory store. 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`. See the [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#use-the-output) for how to review and use the result. - `Type type` - `String memoryStoreId` The ID of the memory store that the dream writes its result to (`memstore_...`). With `output_behavior` set to `create_new`, this is a new memory store. With `update_existing`, it is the input memory store. - `Optional sessionId` The ID of the session that runs the dream (`sesn_...`), or `null` if that session hasn't started. Stream that session's events to follow what the dream reads and writes. See the [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#watch-the-pipeline-run) for how to watch a running dream. - `BetaDreamStatus status` Where a dream is in its lifecycle. `completed`, `failed`, and `canceled` are final: once a dream has one of these statuses, its status doesn't change again. See the [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#lifecycle) for what each status means. - `PENDING("pending")` The dream is waiting to start and hasn't read its inputs yet. `outputs` is empty and every `usage` count is zero. - `RUNNING("running")` The dream is reading its inputs and writing its result. `usage` updates while the dream has this status. - `COMPLETED("completed")` The dream finished and its output memory store holds the complete result. - `FAILED("failed")` The dream stopped with an error, which `error` describes. If `outputs` references a memory store, that memory store keeps what the dream wrote before it stopped. - `CANCELED("canceled")` A cancel request stopped the dream before it reached `completed` or `failed`. If `outputs` references a memory store, that memory store keeps what the dream wrote. `usage` can keep changing after the cancel. - `BetaDreamUsage usage` The dream's token counts, which stop changing once its `status` is `completed` or `failed`. After a cancel, they can keep changing. - `long cacheCreationInputTokens` The dream's input tokens that were written to the prompt cache, for both the 5-minute and 1-hour cache durations. format: int32 - `long cacheReadInputTokens` The dream's input tokens that were read from the prompt cache. format: int32 - `long inputTokens` The dream's input tokens that weren't read from or written to the prompt cache. format: int32 - `long outputTokens` The tokens that the model generated for the dream. format: int32 ### Example ```java package com.anthropic.example; import com.anthropic.client.AnthropicClient; import com.anthropic.client.okhttp.AnthropicOkHttpClient; import com.anthropic.models.beta.dreams.DreamListPage; import com.anthropic.models.beta.dreams.DreamListParams; public final class Main { private Main() {} public static void main(String[] args) { AnthropicClient client = AnthropicOkHttpClient.fromEnv(); DreamListPage page = client.beta().dreams().list(); } } ``` #### Response (200) ```json { "data": [ { "id": "id", "archived_at": "2019-12-27T18:11:19.117Z", "created_at": "2019-12-27T18:11:19.117Z", "ended_at": "2019-12-27T18:11:19.117Z", "error": { "message": "message", "type": "type" }, "inputs": [ { "memory_store_id": "x", "type": "memory_store" } ], "instructions": "instructions", "model": { "id": "x", "speed": "standard" }, "output_behavior": { "type": "create_new" }, "outputs": [ { "memory_store_id": "memory_store_id", "type": "memory_store" } ], "session_id": "session_id", "status": "pending", "type": "dream", "usage": { "cache_creation_input_tokens": 0, "cache_read_input_tokens": 0, "input_tokens": 0, "output_tokens": 0 } } ], "next_page": "next_page" } ``` ## Get a Dream `BetaDream beta().dreams().retrieve(params = DreamRetrieveParams.none(), requestOptions = RequestOptions.none())` **GET** `/v1/dreams/{dream_id}` Get a dream by ID to check its status, output memory store, and token usage. Archived dreams are returned too. See the [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#track-progress) for how to poll a dream and what each status means. ### Parameters - `DreamRetrieveParams params` - `Optional dreamId` (path parameter) The ID of the dream to get (`drm_...`). - `Optional> betas` (header parameter) This endpoint is in beta: requests must send `dreaming-2026-04-21` in this header. - `MESSAGE_BATCHES_2024_09_24("message-batches-2024-09-24")` - `PROMPT_CACHING_2024_07_31("prompt-caching-2024-07-31")` - `COMPUTER_USE_2024_10_22("computer-use-2024-10-22")` - `COMPUTER_USE_2025_01_24("computer-use-2025-01-24")` - `PDFS_2024_09_25("pdfs-2024-09-25")` - `TOKEN_COUNTING_2024_11_01("token-counting-2024-11-01")` - `TOKEN_EFFICIENT_TOOLS_2025_02_19("token-efficient-tools-2025-02-19")` - `OUTPUT_128K_2025_02_19("output-128k-2025-02-19")` - `FILES_API_2025_04_14("files-api-2025-04-14")` - `MCP_CLIENT_2025_04_04("mcp-client-2025-04-04")` - `MCP_CLIENT_2025_11_20("mcp-client-2025-11-20")` - `DEV_FULL_THINKING_2025_05_14("dev-full-thinking-2025-05-14")` - `INTERLEAVED_THINKING_2025_05_14("interleaved-thinking-2025-05-14")` - `CODE_EXECUTION_2025_05_22("code-execution-2025-05-22")` - `EXTENDED_CACHE_TTL_2025_04_11("extended-cache-ttl-2025-04-11")` - `CONTEXT_1M_2025_08_07("context-1m-2025-08-07")` - `CONTEXT_MANAGEMENT_2025_06_27("context-management-2025-06-27")` - `MODEL_CONTEXT_WINDOW_EXCEEDED_2025_08_26("model-context-window-exceeded-2025-08-26")` - `SKILLS_2025_10_02("skills-2025-10-02")` - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` - `USER_PROFILES_2026_08_18("user-profiles-2026-08-18")` - `USER_PROFILES_2026_09_04("user-profiles-2026-09-04")` - `ADVISOR_TOOL_2026_03_01("advisor-tool-2026-03-01")` - `MANAGED_AGENTS_2026_04_01("managed-agents-2026-04-01")` - `CACHE_DIAGNOSIS_2026_04_07("cache-diagnosis-2026-04-07")` - `DREAMING_2026_04_21("dreaming-2026-04-21")` - `THINKING_TOKEN_COUNT_2026_05_13("thinking-token-count-2026-05-13")` - `SERVER_SIDE_FALLBACK_2026_06_01("server-side-fallback-2026-06-01")` - `SERVER_SIDE_FALLBACK_2026_07_01("server-side-fallback-2026-07-01")` - `FALLBACK_CREDIT_2026_06_01("fallback-credit-2026-06-01")` - `FALLBACK_CREDIT_2026_07_01("fallback-credit-2026-07-01")` - `AGENT_MEMORY_2026_07_22("agent-memory-2026-07-22")` - `MID_CONVERSATION_TOOL_CHANGES_2026_07_01("mid-conversation-tool-changes-2026-07-01")` - `COMPACT_2026_01_12("compact-2026-01-12")` - `COMPUTER_USE_2025_11_24("computer-use-2025-11-24")` - `MCP_TUNNELS_2026_06_22("mcp-tunnels-2026-06-22")` - `STRUCTURED_OUTPUTS_2025_11_13("structured-outputs-2025-11-13")` - `TASK_BUDGETS_2026_03_13("task-budgets-2026-03-13")` - `THINKING_DISPLAY_UPDATES_2026_08_18("thinking-display-updates-2026-08-18")` - `CE_USER_MANAGEMENT_2026_07_13("ce-user-management-2026-07-13")` - `MID_CONVERSATION_OUTPUT_CONFIG_2026_07_01("mid-conversation-output-config-2026-07-01")` - `THINKING_BINDING_CONTROLS_2026_08_01("thinking-binding-controls-2026-08-01")` - `MID_CONVERSATION_SYSTEM_CLEAR_AT_2026_08_21("mid-conversation-system-clear-at-2026-08-21")` - `COMPACT_2026_09_04("compact-2026-09-04")` - `INLINE_TOOLS_2026_09_15("inline-tools-2026-09-15")` - `MCP_CLIENT_2026_09_15("mcp-client-2026-09-15")` - `CE_PLUGINS_2026_09_01("ce-plugins-2026-09-01")` - `SPEND_LIMIT_READS_2026_09_26("spend-limit-reads-2026-09-26")` - `TELEMETRY_DESTINATIONS_2026_08_11("telemetry-destinations-2026-08-11")` - `Optional workspaceId` (header parameter) Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`). Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace. ### Returns - `class BetaDream` An asynchronous job that reads a memory store and past sessions, then writes a reorganized version of that memory store. By default the dream writes its result to a new memory store and doesn't change the input memory store. With `output_behavior` set to `update_existing`, it writes its result into the input memory store instead. 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. See the [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#how-it-works) for what a dream reads and produces. - `Type type` - `String id` The unique ID of the dream (`drm_...`). - `Optional archivedAt` When the dream was archived, in RFC 3339, or `null` if it hasn't been archived. format: date-time - `LocalDateTime createdAt` When the dream was created, in RFC 3339. Lists of dreams are sorted by this time, newest first. format: date-time - `Optional endedAt` When the dream reached `completed`, `failed`, or `canceled`, in RFC 3339, or `null` if it is still `pending` or `running`. format: date-time - `Optional error` Why the dream failed, or `null` if `status` isn't `failed`. - `String type` A code for why the dream failed, such as `timeout` or `internal_error`. The [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#errors) lists common error codes and when they occur. - `String message` A human-readable explanation of why the dream failed. - `List inputs` The sources that the dream reads, from the request that created it. - `class BetaDreamMemoryStoreInput` The memory store that a dream reads, given as an entry in `inputs`. With `output_behavior` set to `update_existing`, the dream writes its result into this memory store. Otherwise the dream doesn't change it. - `Type type` - `String memoryStoreId` The ID of the memory store for the dream to read (`memstore_...`). The memory store must be in the same workspace as the dream and must not be archived. minLength: 1 - `class BetaDreamSessionsInput` The sessions that a dream reads, given as an entry in `inputs`. - `Type type` - `List sessionIds` The IDs of the sessions whose transcripts the dream reads (`sesn_...`). 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. The [limits table in the Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#limits) lists all the limits on a dream. - `Optional instructions` The guidance given when the dream was created, or `null` if none was given. - `BetaDreamModelConfig model` The model that runs a dream, from the request that created it. The dream uses this model for all of its work. The response always gives the model as an object, even if the request gave only a model ID. - `String id` The ID of the model that runs the dream, as given in the request that created it. minLength: 1, maxLength: 256 - `Optional speed` How fast the model generates output for the dream. Always `standard`. - `STANDARD("standard")` - `FAST("fast")` - `BetaOutputBehavior outputBehavior` Where the dream writes its result, as set in the request that created the dream. If that request left out `output_behavior`, the dream used the `create_new` behavior. - `class BetaOutputBehaviorCreateNew` Write the result to a new memory store that starts as a copy of the input memory store. This is the default. The new memory store is in the same workspace as the dream. The dream doesn't change the input memory store. - `Type type` - `class BetaOutputBehaviorUpdateExisting` Write the result into the input memory store instead of a new memory store. The credential must be allowed to write memory stores, or the request returns a 403 error. While another `update_existing` dream on the same memory store hasn't fully stopped, the request returns a 409 error. - `Type type` - `String memoryStoreId` The ID of the memory store for the dream to write its result to (`memstore_...`). It must be the memory store in the `memory_store` entry of `inputs`. minLength: 1 - `List outputs` The memory store that holds the dream's result, as a one-item array, or an empty array until the dream records that memory store. 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`. See the [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#use-the-output) for how to review and use the result. - `Type type` - `String memoryStoreId` The ID of the memory store that the dream writes its result to (`memstore_...`). With `output_behavior` set to `create_new`, this is a new memory store. With `update_existing`, it is the input memory store. - `Optional sessionId` The ID of the session that runs the dream (`sesn_...`), or `null` if that session hasn't started. Stream that session's events to follow what the dream reads and writes. See the [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#watch-the-pipeline-run) for how to watch a running dream. - `BetaDreamStatus status` Where a dream is in its lifecycle. `completed`, `failed`, and `canceled` are final: once a dream has one of these statuses, its status doesn't change again. See the [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#lifecycle) for what each status means. - `PENDING("pending")` The dream is waiting to start and hasn't read its inputs yet. `outputs` is empty and every `usage` count is zero. - `RUNNING("running")` The dream is reading its inputs and writing its result. `usage` updates while the dream has this status. - `COMPLETED("completed")` The dream finished and its output memory store holds the complete result. - `FAILED("failed")` The dream stopped with an error, which `error` describes. If `outputs` references a memory store, that memory store keeps what the dream wrote before it stopped. - `CANCELED("canceled")` A cancel request stopped the dream before it reached `completed` or `failed`. If `outputs` references a memory store, that memory store keeps what the dream wrote. `usage` can keep changing after the cancel. - `BetaDreamUsage usage` The dream's token counts, which stop changing once its `status` is `completed` or `failed`. After a cancel, they can keep changing. - `long cacheCreationInputTokens` The dream's input tokens that were written to the prompt cache, for both the 5-minute and 1-hour cache durations. format: int32 - `long cacheReadInputTokens` The dream's input tokens that were read from the prompt cache. format: int32 - `long inputTokens` The dream's input tokens that weren't read from or written to the prompt cache. format: int32 - `long outputTokens` The tokens that the model generated for the dream. format: int32 ### Example ```java package com.anthropic.example; import com.anthropic.client.AnthropicClient; import com.anthropic.client.okhttp.AnthropicOkHttpClient; import com.anthropic.models.beta.dreams.BetaDream; import com.anthropic.models.beta.dreams.DreamRetrieveParams; public final class Main { private Main() {} public static void main(String[] args) { AnthropicClient client = AnthropicOkHttpClient.fromEnv(); BetaDream betaDream = client.beta().dreams().retrieve("dream_id"); } } ``` #### Response (200) ```json { "id": "id", "archived_at": "2019-12-27T18:11:19.117Z", "created_at": "2019-12-27T18:11:19.117Z", "ended_at": "2019-12-27T18:11:19.117Z", "error": { "message": "message", "type": "type" }, "inputs": [ { "memory_store_id": "x", "type": "memory_store" } ], "instructions": "instructions", "model": { "id": "x", "speed": "standard" }, "output_behavior": { "type": "create_new" }, "outputs": [ { "memory_store_id": "memory_store_id", "type": "memory_store" } ], "session_id": "session_id", "status": "pending", "type": "dream", "usage": { "cache_creation_input_tokens": 0, "cache_read_input_tokens": 0, "input_tokens": 0, "output_tokens": 0 } } ``` ## Cancel a Dream `BetaDream beta().dreams().cancel(params = DreamCancelParams.none(), requestOptions = RequestOptions.none())` **POST** `/v1/dreams/{dream_id}/cancel` Stop a `pending` or `running` dream. The response shows `status` as `canceled`, unless the dream reached `completed` or `failed` first. `usage` can keep changing after the response. Canceling a `canceled` dream returns it unchanged. Canceling a `completed` or `failed` dream returns a 400 error. See the [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#cancel-a-dream) to learn more about canceling dreams. ### Parameters - `DreamCancelParams params` - `Optional dreamId` (path parameter) The ID of the dream to cancel (`drm_...`). - `Optional> betas` (header parameter) This endpoint is in beta: requests must send `dreaming-2026-04-21` in this header. - `MESSAGE_BATCHES_2024_09_24("message-batches-2024-09-24")` - `PROMPT_CACHING_2024_07_31("prompt-caching-2024-07-31")` - `COMPUTER_USE_2024_10_22("computer-use-2024-10-22")` - `COMPUTER_USE_2025_01_24("computer-use-2025-01-24")` - `PDFS_2024_09_25("pdfs-2024-09-25")` - `TOKEN_COUNTING_2024_11_01("token-counting-2024-11-01")` - `TOKEN_EFFICIENT_TOOLS_2025_02_19("token-efficient-tools-2025-02-19")` - `OUTPUT_128K_2025_02_19("output-128k-2025-02-19")` - `FILES_API_2025_04_14("files-api-2025-04-14")` - `MCP_CLIENT_2025_04_04("mcp-client-2025-04-04")` - `MCP_CLIENT_2025_11_20("mcp-client-2025-11-20")` - `DEV_FULL_THINKING_2025_05_14("dev-full-thinking-2025-05-14")` - `INTERLEAVED_THINKING_2025_05_14("interleaved-thinking-2025-05-14")` - `CODE_EXECUTION_2025_05_22("code-execution-2025-05-22")` - `EXTENDED_CACHE_TTL_2025_04_11("extended-cache-ttl-2025-04-11")` - `CONTEXT_1M_2025_08_07("context-1m-2025-08-07")` - `CONTEXT_MANAGEMENT_2025_06_27("context-management-2025-06-27")` - `MODEL_CONTEXT_WINDOW_EXCEEDED_2025_08_26("model-context-window-exceeded-2025-08-26")` - `SKILLS_2025_10_02("skills-2025-10-02")` - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` - `USER_PROFILES_2026_08_18("user-profiles-2026-08-18")` - `USER_PROFILES_2026_09_04("user-profiles-2026-09-04")` - `ADVISOR_TOOL_2026_03_01("advisor-tool-2026-03-01")` - `MANAGED_AGENTS_2026_04_01("managed-agents-2026-04-01")` - `CACHE_DIAGNOSIS_2026_04_07("cache-diagnosis-2026-04-07")` - `DREAMING_2026_04_21("dreaming-2026-04-21")` - `THINKING_TOKEN_COUNT_2026_05_13("thinking-token-count-2026-05-13")` - `SERVER_SIDE_FALLBACK_2026_06_01("server-side-fallback-2026-06-01")` - `SERVER_SIDE_FALLBACK_2026_07_01("server-side-fallback-2026-07-01")` - `FALLBACK_CREDIT_2026_06_01("fallback-credit-2026-06-01")` - `FALLBACK_CREDIT_2026_07_01("fallback-credit-2026-07-01")` - `AGENT_MEMORY_2026_07_22("agent-memory-2026-07-22")` - `MID_CONVERSATION_TOOL_CHANGES_2026_07_01("mid-conversation-tool-changes-2026-07-01")` - `COMPACT_2026_01_12("compact-2026-01-12")` - `COMPUTER_USE_2025_11_24("computer-use-2025-11-24")` - `MCP_TUNNELS_2026_06_22("mcp-tunnels-2026-06-22")` - `STRUCTURED_OUTPUTS_2025_11_13("structured-outputs-2025-11-13")` - `TASK_BUDGETS_2026_03_13("task-budgets-2026-03-13")` - `THINKING_DISPLAY_UPDATES_2026_08_18("thinking-display-updates-2026-08-18")` - `CE_USER_MANAGEMENT_2026_07_13("ce-user-management-2026-07-13")` - `MID_CONVERSATION_OUTPUT_CONFIG_2026_07_01("mid-conversation-output-config-2026-07-01")` - `THINKING_BINDING_CONTROLS_2026_08_01("thinking-binding-controls-2026-08-01")` - `MID_CONVERSATION_SYSTEM_CLEAR_AT_2026_08_21("mid-conversation-system-clear-at-2026-08-21")` - `COMPACT_2026_09_04("compact-2026-09-04")` - `INLINE_TOOLS_2026_09_15("inline-tools-2026-09-15")` - `MCP_CLIENT_2026_09_15("mcp-client-2026-09-15")` - `CE_PLUGINS_2026_09_01("ce-plugins-2026-09-01")` - `SPEND_LIMIT_READS_2026_09_26("spend-limit-reads-2026-09-26")` - `TELEMETRY_DESTINATIONS_2026_08_11("telemetry-destinations-2026-08-11")` - `Optional workspaceId` (header parameter) Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`). Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace. ### Returns - `class BetaDream` An asynchronous job that reads a memory store and past sessions, then writes a reorganized version of that memory store. By default the dream writes its result to a new memory store and doesn't change the input memory store. With `output_behavior` set to `update_existing`, it writes its result into the input memory store instead. 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. See the [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#how-it-works) for what a dream reads and produces. - `Type type` - `String id` The unique ID of the dream (`drm_...`). - `Optional archivedAt` When the dream was archived, in RFC 3339, or `null` if it hasn't been archived. format: date-time - `LocalDateTime createdAt` When the dream was created, in RFC 3339. Lists of dreams are sorted by this time, newest first. format: date-time - `Optional endedAt` When the dream reached `completed`, `failed`, or `canceled`, in RFC 3339, or `null` if it is still `pending` or `running`. format: date-time - `Optional error` Why the dream failed, or `null` if `status` isn't `failed`. - `String type` A code for why the dream failed, such as `timeout` or `internal_error`. The [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#errors) lists common error codes and when they occur. - `String message` A human-readable explanation of why the dream failed. - `List inputs` The sources that the dream reads, from the request that created it. - `class BetaDreamMemoryStoreInput` The memory store that a dream reads, given as an entry in `inputs`. With `output_behavior` set to `update_existing`, the dream writes its result into this memory store. Otherwise the dream doesn't change it. - `Type type` - `String memoryStoreId` The ID of the memory store for the dream to read (`memstore_...`). The memory store must be in the same workspace as the dream and must not be archived. minLength: 1 - `class BetaDreamSessionsInput` The sessions that a dream reads, given as an entry in `inputs`. - `Type type` - `List sessionIds` The IDs of the sessions whose transcripts the dream reads (`sesn_...`). 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. The [limits table in the Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#limits) lists all the limits on a dream. - `Optional instructions` The guidance given when the dream was created, or `null` if none was given. - `BetaDreamModelConfig model` The model that runs a dream, from the request that created it. The dream uses this model for all of its work. The response always gives the model as an object, even if the request gave only a model ID. - `String id` The ID of the model that runs the dream, as given in the request that created it. minLength: 1, maxLength: 256 - `Optional speed` How fast the model generates output for the dream. Always `standard`. - `STANDARD("standard")` - `FAST("fast")` - `BetaOutputBehavior outputBehavior` Where the dream writes its result, as set in the request that created the dream. If that request left out `output_behavior`, the dream used the `create_new` behavior. - `class BetaOutputBehaviorCreateNew` Write the result to a new memory store that starts as a copy of the input memory store. This is the default. The new memory store is in the same workspace as the dream. The dream doesn't change the input memory store. - `Type type` - `class BetaOutputBehaviorUpdateExisting` Write the result into the input memory store instead of a new memory store. The credential must be allowed to write memory stores, or the request returns a 403 error. While another `update_existing` dream on the same memory store hasn't fully stopped, the request returns a 409 error. - `Type type` - `String memoryStoreId` The ID of the memory store for the dream to write its result to (`memstore_...`). It must be the memory store in the `memory_store` entry of `inputs`. minLength: 1 - `List outputs` The memory store that holds the dream's result, as a one-item array, or an empty array until the dream records that memory store. 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`. See the [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#use-the-output) for how to review and use the result. - `Type type` - `String memoryStoreId` The ID of the memory store that the dream writes its result to (`memstore_...`). With `output_behavior` set to `create_new`, this is a new memory store. With `update_existing`, it is the input memory store. - `Optional sessionId` The ID of the session that runs the dream (`sesn_...`), or `null` if that session hasn't started. Stream that session's events to follow what the dream reads and writes. See the [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#watch-the-pipeline-run) for how to watch a running dream. - `BetaDreamStatus status` Where a dream is in its lifecycle. `completed`, `failed`, and `canceled` are final: once a dream has one of these statuses, its status doesn't change again. See the [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#lifecycle) for what each status means. - `PENDING("pending")` The dream is waiting to start and hasn't read its inputs yet. `outputs` is empty and every `usage` count is zero. - `RUNNING("running")` The dream is reading its inputs and writing its result. `usage` updates while the dream has this status. - `COMPLETED("completed")` The dream finished and its output memory store holds the complete result. - `FAILED("failed")` The dream stopped with an error, which `error` describes. If `outputs` references a memory store, that memory store keeps what the dream wrote before it stopped. - `CANCELED("canceled")` A cancel request stopped the dream before it reached `completed` or `failed`. If `outputs` references a memory store, that memory store keeps what the dream wrote. `usage` can keep changing after the cancel. - `BetaDreamUsage usage` The dream's token counts, which stop changing once its `status` is `completed` or `failed`. After a cancel, they can keep changing. - `long cacheCreationInputTokens` The dream's input tokens that were written to the prompt cache, for both the 5-minute and 1-hour cache durations. format: int32 - `long cacheReadInputTokens` The dream's input tokens that were read from the prompt cache. format: int32 - `long inputTokens` The dream's input tokens that weren't read from or written to the prompt cache. format: int32 - `long outputTokens` The tokens that the model generated for the dream. format: int32 ### Example ```java package com.anthropic.example; import com.anthropic.client.AnthropicClient; import com.anthropic.client.okhttp.AnthropicOkHttpClient; import com.anthropic.models.beta.dreams.BetaDream; import com.anthropic.models.beta.dreams.DreamCancelParams; public final class Main { private Main() {} public static void main(String[] args) { AnthropicClient client = AnthropicOkHttpClient.fromEnv(); BetaDream betaDream = client.beta().dreams().cancel("dream_id"); } } ``` #### Response (200) ```json { "id": "id", "archived_at": "2019-12-27T18:11:19.117Z", "created_at": "2019-12-27T18:11:19.117Z", "ended_at": "2019-12-27T18:11:19.117Z", "error": { "message": "message", "type": "type" }, "inputs": [ { "memory_store_id": "x", "type": "memory_store" } ], "instructions": "instructions", "model": { "id": "x", "speed": "standard" }, "output_behavior": { "type": "create_new" }, "outputs": [ { "memory_store_id": "memory_store_id", "type": "memory_store" } ], "session_id": "session_id", "status": "pending", "type": "dream", "usage": { "cache_creation_input_tokens": 0, "cache_read_input_tokens": 0, "input_tokens": 0, "output_tokens": 0 } } ``` ## Archive a Dream `BetaDream beta().dreams().archive(params = DreamArchiveParams.none(), requestOptions = RequestOptions.none())` **POST** `/v1/dreams/{dream_id}/archive` Hide a `completed`, `failed`, or `canceled` dream from the default list of dreams. Archiving a `pending` or `running` dream returns a 400 error, so cancel it first. Archiving an archived dream returns it unchanged. An archived dream can still be fetched by ID. Archiving can't be undone. See the [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#archive-a-dream) to learn more about archiving dreams. ### Parameters - `DreamArchiveParams params` - `Optional dreamId` (path parameter) The ID of the dream to archive (`drm_...`). - `Optional> betas` (header parameter) This endpoint is in beta: requests must send `dreaming-2026-04-21` in this header. - `MESSAGE_BATCHES_2024_09_24("message-batches-2024-09-24")` - `PROMPT_CACHING_2024_07_31("prompt-caching-2024-07-31")` - `COMPUTER_USE_2024_10_22("computer-use-2024-10-22")` - `COMPUTER_USE_2025_01_24("computer-use-2025-01-24")` - `PDFS_2024_09_25("pdfs-2024-09-25")` - `TOKEN_COUNTING_2024_11_01("token-counting-2024-11-01")` - `TOKEN_EFFICIENT_TOOLS_2025_02_19("token-efficient-tools-2025-02-19")` - `OUTPUT_128K_2025_02_19("output-128k-2025-02-19")` - `FILES_API_2025_04_14("files-api-2025-04-14")` - `MCP_CLIENT_2025_04_04("mcp-client-2025-04-04")` - `MCP_CLIENT_2025_11_20("mcp-client-2025-11-20")` - `DEV_FULL_THINKING_2025_05_14("dev-full-thinking-2025-05-14")` - `INTERLEAVED_THINKING_2025_05_14("interleaved-thinking-2025-05-14")` - `CODE_EXECUTION_2025_05_22("code-execution-2025-05-22")` - `EXTENDED_CACHE_TTL_2025_04_11("extended-cache-ttl-2025-04-11")` - `CONTEXT_1M_2025_08_07("context-1m-2025-08-07")` - `CONTEXT_MANAGEMENT_2025_06_27("context-management-2025-06-27")` - `MODEL_CONTEXT_WINDOW_EXCEEDED_2025_08_26("model-context-window-exceeded-2025-08-26")` - `SKILLS_2025_10_02("skills-2025-10-02")` - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` - `USER_PROFILES_2026_08_18("user-profiles-2026-08-18")` - `USER_PROFILES_2026_09_04("user-profiles-2026-09-04")` - `ADVISOR_TOOL_2026_03_01("advisor-tool-2026-03-01")` - `MANAGED_AGENTS_2026_04_01("managed-agents-2026-04-01")` - `CACHE_DIAGNOSIS_2026_04_07("cache-diagnosis-2026-04-07")` - `DREAMING_2026_04_21("dreaming-2026-04-21")` - `THINKING_TOKEN_COUNT_2026_05_13("thinking-token-count-2026-05-13")` - `SERVER_SIDE_FALLBACK_2026_06_01("server-side-fallback-2026-06-01")` - `SERVER_SIDE_FALLBACK_2026_07_01("server-side-fallback-2026-07-01")` - `FALLBACK_CREDIT_2026_06_01("fallback-credit-2026-06-01")` - `FALLBACK_CREDIT_2026_07_01("fallback-credit-2026-07-01")` - `AGENT_MEMORY_2026_07_22("agent-memory-2026-07-22")` - `MID_CONVERSATION_TOOL_CHANGES_2026_07_01("mid-conversation-tool-changes-2026-07-01")` - `COMPACT_2026_01_12("compact-2026-01-12")` - `COMPUTER_USE_2025_11_24("computer-use-2025-11-24")` - `MCP_TUNNELS_2026_06_22("mcp-tunnels-2026-06-22")` - `STRUCTURED_OUTPUTS_2025_11_13("structured-outputs-2025-11-13")` - `TASK_BUDGETS_2026_03_13("task-budgets-2026-03-13")` - `THINKING_DISPLAY_UPDATES_2026_08_18("thinking-display-updates-2026-08-18")` - `CE_USER_MANAGEMENT_2026_07_13("ce-user-management-2026-07-13")` - `MID_CONVERSATION_OUTPUT_CONFIG_2026_07_01("mid-conversation-output-config-2026-07-01")` - `THINKING_BINDING_CONTROLS_2026_08_01("thinking-binding-controls-2026-08-01")` - `MID_CONVERSATION_SYSTEM_CLEAR_AT_2026_08_21("mid-conversation-system-clear-at-2026-08-21")` - `COMPACT_2026_09_04("compact-2026-09-04")` - `INLINE_TOOLS_2026_09_15("inline-tools-2026-09-15")` - `MCP_CLIENT_2026_09_15("mcp-client-2026-09-15")` - `CE_PLUGINS_2026_09_01("ce-plugins-2026-09-01")` - `SPEND_LIMIT_READS_2026_09_26("spend-limit-reads-2026-09-26")` - `TELEMETRY_DESTINATIONS_2026_08_11("telemetry-destinations-2026-08-11")` - `Optional workspaceId` (header parameter) Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`). Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace. ### Returns - `class BetaDream` An asynchronous job that reads a memory store and past sessions, then writes a reorganized version of that memory store. By default the dream writes its result to a new memory store and doesn't change the input memory store. With `output_behavior` set to `update_existing`, it writes its result into the input memory store instead. 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. See the [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#how-it-works) for what a dream reads and produces. - `Type type` - `String id` The unique ID of the dream (`drm_...`). - `Optional archivedAt` When the dream was archived, in RFC 3339, or `null` if it hasn't been archived. format: date-time - `LocalDateTime createdAt` When the dream was created, in RFC 3339. Lists of dreams are sorted by this time, newest first. format: date-time - `Optional endedAt` When the dream reached `completed`, `failed`, or `canceled`, in RFC 3339, or `null` if it is still `pending` or `running`. format: date-time - `Optional error` Why the dream failed, or `null` if `status` isn't `failed`. - `String type` A code for why the dream failed, such as `timeout` or `internal_error`. The [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#errors) lists common error codes and when they occur. - `String message` A human-readable explanation of why the dream failed. - `List inputs` The sources that the dream reads, from the request that created it. - `class BetaDreamMemoryStoreInput` The memory store that a dream reads, given as an entry in `inputs`. With `output_behavior` set to `update_existing`, the dream writes its result into this memory store. Otherwise the dream doesn't change it. - `Type type` - `String memoryStoreId` The ID of the memory store for the dream to read (`memstore_...`). The memory store must be in the same workspace as the dream and must not be archived. minLength: 1 - `class BetaDreamSessionsInput` The sessions that a dream reads, given as an entry in `inputs`. - `Type type` - `List sessionIds` The IDs of the sessions whose transcripts the dream reads (`sesn_...`). 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. The [limits table in the Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#limits) lists all the limits on a dream. - `Optional instructions` The guidance given when the dream was created, or `null` if none was given. - `BetaDreamModelConfig model` The model that runs a dream, from the request that created it. The dream uses this model for all of its work. The response always gives the model as an object, even if the request gave only a model ID. - `String id` The ID of the model that runs the dream, as given in the request that created it. minLength: 1, maxLength: 256 - `Optional speed` How fast the model generates output for the dream. Always `standard`. - `STANDARD("standard")` - `FAST("fast")` - `BetaOutputBehavior outputBehavior` Where the dream writes its result, as set in the request that created the dream. If that request left out `output_behavior`, the dream used the `create_new` behavior. - `class BetaOutputBehaviorCreateNew` Write the result to a new memory store that starts as a copy of the input memory store. This is the default. The new memory store is in the same workspace as the dream. The dream doesn't change the input memory store. - `Type type` - `class BetaOutputBehaviorUpdateExisting` Write the result into the input memory store instead of a new memory store. The credential must be allowed to write memory stores, or the request returns a 403 error. While another `update_existing` dream on the same memory store hasn't fully stopped, the request returns a 409 error. - `Type type` - `String memoryStoreId` The ID of the memory store for the dream to write its result to (`memstore_...`). It must be the memory store in the `memory_store` entry of `inputs`. minLength: 1 - `List outputs` The memory store that holds the dream's result, as a one-item array, or an empty array until the dream records that memory store. 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`. See the [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#use-the-output) for how to review and use the result. - `Type type` - `String memoryStoreId` The ID of the memory store that the dream writes its result to (`memstore_...`). With `output_behavior` set to `create_new`, this is a new memory store. With `update_existing`, it is the input memory store. - `Optional sessionId` The ID of the session that runs the dream (`sesn_...`), or `null` if that session hasn't started. Stream that session's events to follow what the dream reads and writes. See the [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#watch-the-pipeline-run) for how to watch a running dream. - `BetaDreamStatus status` Where a dream is in its lifecycle. `completed`, `failed`, and `canceled` are final: once a dream has one of these statuses, its status doesn't change again. See the [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#lifecycle) for what each status means. - `PENDING("pending")` The dream is waiting to start and hasn't read its inputs yet. `outputs` is empty and every `usage` count is zero. - `RUNNING("running")` The dream is reading its inputs and writing its result. `usage` updates while the dream has this status. - `COMPLETED("completed")` The dream finished and its output memory store holds the complete result. - `FAILED("failed")` The dream stopped with an error, which `error` describes. If `outputs` references a memory store, that memory store keeps what the dream wrote before it stopped. - `CANCELED("canceled")` A cancel request stopped the dream before it reached `completed` or `failed`. If `outputs` references a memory store, that memory store keeps what the dream wrote. `usage` can keep changing after the cancel. - `BetaDreamUsage usage` The dream's token counts, which stop changing once its `status` is `completed` or `failed`. After a cancel, they can keep changing. - `long cacheCreationInputTokens` The dream's input tokens that were written to the prompt cache, for both the 5-minute and 1-hour cache durations. format: int32 - `long cacheReadInputTokens` The dream's input tokens that were read from the prompt cache. format: int32 - `long inputTokens` The dream's input tokens that weren't read from or written to the prompt cache. format: int32 - `long outputTokens` The tokens that the model generated for the dream. format: int32 ### Example ```java package com.anthropic.example; import com.anthropic.client.AnthropicClient; import com.anthropic.client.okhttp.AnthropicOkHttpClient; import com.anthropic.models.beta.dreams.BetaDream; import com.anthropic.models.beta.dreams.DreamArchiveParams; public final class Main { private Main() {} public static void main(String[] args) { AnthropicClient client = AnthropicOkHttpClient.fromEnv(); BetaDream betaDream = client.beta().dreams().archive("dream_id"); } } ``` #### Response (200) ```json { "id": "id", "archived_at": "2019-12-27T18:11:19.117Z", "created_at": "2019-12-27T18:11:19.117Z", "ended_at": "2019-12-27T18:11:19.117Z", "error": { "message": "message", "type": "type" }, "inputs": [ { "memory_store_id": "x", "type": "memory_store" } ], "instructions": "instructions", "model": { "id": "x", "speed": "standard" }, "output_behavior": { "type": "create_new" }, "outputs": [ { "memory_store_id": "memory_store_id", "type": "memory_store" } ], "session_id": "session_id", "status": "pending", "type": "dream", "usage": { "cache_creation_input_tokens": 0, "cache_read_input_tokens": 0, "input_tokens": 0, "output_tokens": 0 } } ``` ## Domain types ### Beta Dream - `class BetaDream` An asynchronous job that reads a memory store and past sessions, then writes a reorganized version of that memory store. By default the dream writes its result to a new memory store and doesn't change the input memory store. With `output_behavior` set to `update_existing`, it writes its result into the input memory store instead. 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. See the [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#how-it-works) for what a dream reads and produces. - `Type type` - `String id` The unique ID of the dream (`drm_...`). - `Optional archivedAt` When the dream was archived, in RFC 3339, or `null` if it hasn't been archived. format: date-time - `LocalDateTime createdAt` When the dream was created, in RFC 3339. Lists of dreams are sorted by this time, newest first. format: date-time - `Optional endedAt` When the dream reached `completed`, `failed`, or `canceled`, in RFC 3339, or `null` if it is still `pending` or `running`. format: date-time - `Optional error` Why the dream failed, or `null` if `status` isn't `failed`. - `String type` A code for why the dream failed, such as `timeout` or `internal_error`. The [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#errors) lists common error codes and when they occur. - `String message` A human-readable explanation of why the dream failed. - `List inputs` The sources that the dream reads, from the request that created it. - `class BetaDreamMemoryStoreInput` The memory store that a dream reads, given as an entry in `inputs`. With `output_behavior` set to `update_existing`, the dream writes its result into this memory store. Otherwise the dream doesn't change it. - `Type type` - `String memoryStoreId` The ID of the memory store for the dream to read (`memstore_...`). The memory store must be in the same workspace as the dream and must not be archived. minLength: 1 - `class BetaDreamSessionsInput` The sessions that a dream reads, given as an entry in `inputs`. - `Type type` - `List sessionIds` The IDs of the sessions whose transcripts the dream reads (`sesn_...`). 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. The [limits table in the Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#limits) lists all the limits on a dream. - `Optional instructions` The guidance given when the dream was created, or `null` if none was given. - `BetaDreamModelConfig model` The model that runs a dream, from the request that created it. The dream uses this model for all of its work. The response always gives the model as an object, even if the request gave only a model ID. - `String id` The ID of the model that runs the dream, as given in the request that created it. minLength: 1, maxLength: 256 - `Optional speed` How fast the model generates output for the dream. Always `standard`. - `STANDARD("standard")` - `FAST("fast")` - `BetaOutputBehavior outputBehavior` Where the dream writes its result, as set in the request that created the dream. If that request left out `output_behavior`, the dream used the `create_new` behavior. - `class BetaOutputBehaviorCreateNew` Write the result to a new memory store that starts as a copy of the input memory store. This is the default. The new memory store is in the same workspace as the dream. The dream doesn't change the input memory store. - `Type type` - `class BetaOutputBehaviorUpdateExisting` Write the result into the input memory store instead of a new memory store. The credential must be allowed to write memory stores, or the request returns a 403 error. While another `update_existing` dream on the same memory store hasn't fully stopped, the request returns a 409 error. - `Type type` - `String memoryStoreId` The ID of the memory store for the dream to write its result to (`memstore_...`). It must be the memory store in the `memory_store` entry of `inputs`. minLength: 1 - `List outputs` The memory store that holds the dream's result, as a one-item array, or an empty array until the dream records that memory store. 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`. See the [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#use-the-output) for how to review and use the result. - `Type type` - `String memoryStoreId` The ID of the memory store that the dream writes its result to (`memstore_...`). With `output_behavior` set to `create_new`, this is a new memory store. With `update_existing`, it is the input memory store. - `Optional sessionId` The ID of the session that runs the dream (`sesn_...`), or `null` if that session hasn't started. Stream that session's events to follow what the dream reads and writes. See the [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#watch-the-pipeline-run) for how to watch a running dream. - `BetaDreamStatus status` Where a dream is in its lifecycle. `completed`, `failed`, and `canceled` are final: once a dream has one of these statuses, its status doesn't change again. See the [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#lifecycle) for what each status means. - `PENDING("pending")` The dream is waiting to start and hasn't read its inputs yet. `outputs` is empty and every `usage` count is zero. - `RUNNING("running")` The dream is reading its inputs and writing its result. `usage` updates while the dream has this status. - `COMPLETED("completed")` The dream finished and its output memory store holds the complete result. - `FAILED("failed")` The dream stopped with an error, which `error` describes. If `outputs` references a memory store, that memory store keeps what the dream wrote before it stopped. - `CANCELED("canceled")` A cancel request stopped the dream before it reached `completed` or `failed`. If `outputs` references a memory store, that memory store keeps what the dream wrote. `usage` can keep changing after the cancel. - `BetaDreamUsage usage` The dream's token counts, which stop changing once its `status` is `completed` or `failed`. After a cancel, they can keep changing. - `long cacheCreationInputTokens` The dream's input tokens that were written to the prompt cache, for both the 5-minute and 1-hour cache durations. format: int32 - `long cacheReadInputTokens` The dream's input tokens that were read from the prompt cache. format: int32 - `long inputTokens` The dream's input tokens that weren't read from or written to the prompt cache. format: int32 - `long outputTokens` The tokens that the model generated for the dream. format: int32 ### Beta Dream Error - `class BetaDreamError` Failure detail for a Dream whose `status` is `failed`. - `String type` A code for why the dream failed, such as `timeout` or `internal_error`. The [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#errors) lists common error codes and when they occur. - `String message` A human-readable explanation of why the dream failed. ### Beta Dream Input - `class BetaDreamInput: union` A source that a dream reads, such as a memory store or a set of sessions. - `class BetaDreamMemoryStoreInput` The memory store that a dream reads, given as an entry in `inputs`. With `output_behavior` set to `update_existing`, the dream writes its result into this memory store. Otherwise the dream doesn't change it. - `Type type` - `String memoryStoreId` The ID of the memory store for the dream to read (`memstore_...`). The memory store must be in the same workspace as the dream and must not be archived. minLength: 1 - `class BetaDreamSessionsInput` The sessions that a dream reads, given as an entry in `inputs`. - `Type type` - `List sessionIds` The IDs of the sessions whose transcripts the dream reads (`sesn_...`). 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. The [limits table in the Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#limits) lists all the limits on a dream. ### Beta Dream Memory Store Input - `class BetaDreamMemoryStoreInput` The memory store that a dream reads, given as an entry in `inputs`. With `output_behavior` set to `update_existing`, the dream writes its result into this memory store. Otherwise the dream doesn't change it. - `Type type` - `String memoryStoreId` The ID of the memory store for the dream to read (`memstore_...`). The memory store must be in the same workspace as the dream and must not be archived. minLength: 1 ### Beta Dream Memory Store Output - `class BetaDreamMemoryStoreOutput` The memory store that holds a dream's result, as an entry in `outputs`. - `Type type` - `String memoryStoreId` The ID of the memory store that the dream writes its result to (`memstore_...`). With `output_behavior` set to `create_new`, this is a new memory store. With `update_existing`, it is the input memory store. ### Beta Dream Model Config - `class BetaDreamModelConfig` The model that runs a dream, from the request that created it. The dream uses this model for all of its work. The response always gives the model as an object, even if the request gave only a model ID. - `String id` The ID of the model that runs the dream, as given in the request that created it. minLength: 1, maxLength: 256 - `Optional speed` How fast the model generates output for the dream. Always `standard`. - `STANDARD("standard")` - `FAST("fast")` ### Beta Dream Model Config Param - `class BetaDreamModelConfigParam` The object form of `model` in a request to create a dream. - `String id` The ID of the model to run the dream with. The ID can be 1 to 256 characters long. The [limits table in the Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#limits) lists the supported models. minLength: 1, maxLength: 256 - `Optional speed` How fast the model generates output for the dream. Defaults to `standard`. Dreams accept only `standard`. - `STANDARD("standard")` - `FAST("fast")` ### Beta Dream Output - `class BetaDreamOutput` An entry in a dream's `outputs` that references the memory store holding its result. - `Type type` - `String memoryStoreId` The ID of the memory store that the dream writes its result to (`memstore_...`). With `output_behavior` set to `create_new`, this is a new memory store. With `update_existing`, it is the input memory store. ### Beta Dream Sessions Input - `class BetaDreamSessionsInput` The sessions that a dream reads, given as an entry in `inputs`. - `Type type` - `List sessionIds` The IDs of the sessions whose transcripts the dream reads (`sesn_...`). 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. The [limits table in the Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#limits) lists all the limits on a dream. ### Beta Dream Status - `enum BetaDreamStatus` Where a dream is in its lifecycle. `completed`, `failed`, and `canceled` are final: once a dream has one of these statuses, its status doesn't change again. See the [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#lifecycle) for what each status means. - `PENDING("pending")` The dream is waiting to start and hasn't read its inputs yet. `outputs` is empty and every `usage` count is zero. - `RUNNING("running")` The dream is reading its inputs and writing its result. `usage` updates while the dream has this status. - `COMPLETED("completed")` The dream finished and its output memory store holds the complete result. - `FAILED("failed")` The dream stopped with an error, which `error` describes. If `outputs` references a memory store, that memory store keeps what the dream wrote before it stopped. - `CANCELED("canceled")` A cancel request stopped the dream before it reached `completed` or `failed`. If `outputs` references a memory store, that memory store keeps what the dream wrote. `usage` can keep changing after the cancel. ### Beta Dream Usage - `class BetaDreamUsage` The tokens that a dream has used so far. The counts are zero while the dream is `pending` and update while it is `running`. They can keep changing after a cancel. See the [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams?sdk_languages=java#billing) for how dreams are billed. See the [prompt caching guide](https://platform.claude.com/docs/en/build-with-claude/prompt-caching?sdk_languages=java#tracking-cache-performance) for how the input token counts add up. - `long cacheCreationInputTokens` The dream's input tokens that were written to the prompt cache, for both the 5-minute and 1-hour cache durations. format: int32 - `long cacheReadInputTokens` The dream's input tokens that were read from the prompt cache. format: int32 - `long inputTokens` The dream's input tokens that weren't read from or written to the prompt cache. format: int32 - `long outputTokens` The tokens that the model generated for the dream. format: int32 ### Beta Dreaming Error - `class BetaDreamingError: union` - `class BetaInvalidRequestError` - `JsonValue type = "invalid_request_error"` - `String message` - `class BetaAuthenticationError` - `JsonValue type = "authentication_error"` - `String message` - `class BetaBillingError` - `JsonValue type = "billing_error"` - `String message` - `class BetaPermissionError` - `JsonValue type = "permission_error"` - `String message` - `class BetaNotFoundError` - `JsonValue type = "not_found_error"` - `String message` - `class BetaRateLimitError` - `JsonValue type = "rate_limit_error"` - `String message` - `class BetaGatewayTimeoutError` - `JsonValue type = "timeout_error"` - `String message` - `class BetaApiError` - `JsonValue type = "api_error"` - `String message` - `class BetaOverloadedError` - `JsonValue type = "overloaded_error"` - `String message` - `class BetaTargetStoreHeldError` Returned with status 409 when a request to create a dream sets `output_behavior` to `update_existing` and another dream that writes into the same memory store hasn't fully stopped. The other dream is `pending` or `running`, or it has just stopped and is still finishing its last writes. `message` gives the ID of the other dream when the server can identify it. If that dream has already reached `completed`, `failed`, or `canceled`, retry after a short wait. Otherwise, wait for the other dream to end or cancel it, then retry. The response sets the `x-should-retry` header to `false`. - `JsonValue type = "conflict_error"` - `Optional message` A human-readable explanation of why the memory store can't be used yet, with the ID of the dream that is using it when the server can identify it. ### Beta Output Behavior - `class BetaOutputBehavior: union` Which memory store a dream writes its result to. Defaults to `create_new` when left out of a create request. - `class BetaOutputBehaviorCreateNew` Write the result to a new memory store that starts as a copy of the input memory store. This is the default. The new memory store is in the same workspace as the dream. The dream doesn't change the input memory store. - `Type type` - `class BetaOutputBehaviorUpdateExisting` Write the result into the input memory store instead of a new memory store. The credential must be allowed to write memory stores, or the request returns a 403 error. While another `update_existing` dream on the same memory store hasn't fully stopped, the request returns a 409 error. - `Type type` - `String memoryStoreId` The ID of the memory store for the dream to write its result to (`memstore_...`). It must be the memory store in the `memory_store` entry of `inputs`. minLength: 1 ### Beta Output Behavior Create New - `class BetaOutputBehaviorCreateNew` Write the result to a new memory store that starts as a copy of the input memory store. This is the default. The new memory store is in the same workspace as the dream. The dream doesn't change the input memory store. - `Type type` ### Beta Output Behavior Update Existing - `class BetaOutputBehaviorUpdateExisting` Write the result into the input memory store instead of a new memory store. The credential must be allowed to write memory stores, or the request returns a 403 error. While another `update_existing` dream on the same memory store hasn't fully stopped, the request returns a 409 error. - `Type type` - `String memoryStoreId` The ID of the memory store for the dream to write its result to (`memstore_...`). It must be the memory store in the `memory_store` entry of `inputs`. minLength: 1 ### Beta Target Store Held Error - `class BetaTargetStoreHeldError` Returned with status 409 when a request to create a dream sets `output_behavior` to `update_existing` and another dream that writes into the same memory store hasn't fully stopped. The other dream is `pending` or `running`, or it has just stopped and is still finishing its last writes. `message` gives the ID of the other dream when the server can identify it. If that dream has already reached `completed`, `failed`, or `canceled`, retry after a short wait. Otherwise, wait for the other dream to end or cancel it, then retry. The response sets the `x-should-retry` header to `false`. - `JsonValue type = "conflict_error"` - `Optional message` A human-readable explanation of why the memory store can't be used yet, with the ID of the dream that is using it when the server can identify it.