anthropic 1.68.0 → 1.76.0

data/lib/anthropic/resources/beta/deployment_runs.rb

@@ -6,11 +6,16 @@ module Anthropic
       class DeploymentRuns
         # Get Deployment Run
         #
-        # @overload retrieve(deployment_run_id, betas: nil, request_options: {})
+        # Some parameter documentations has been truncated, see
+        # {Anthropic::Models::Beta::DeploymentRunRetrieveParams} for more details.
+        #
+        # @overload retrieve(deployment_run_id, betas: nil, workspace_id: nil, request_options: {})
+        #
+        # @param deployment_run_id [String] Unique identifier of the deployment run.
         #
-        # @param deployment_run_id [String] Path parameter deployment_run_id
+        # @param betas [Array<Symbol, String, Anthropic::Models::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
         #
-        # @param betas [Array<String, Symbol, Anthropic::Models::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
+        # @param workspace_id [String] Optional header to select the Workspace for this request. The value is a Workspa
         #
         # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -22,7 +27,7 @@ module Anthropic
           @client.request(
             method: :get,
             path: ["v1/deployment_runs/%1$s?beta=true", deployment_run_id],
-            headers: parsed.transform_keys(betas: "anthropic-beta"),
+            headers: parsed.transform_keys(betas: "anthropic-beta", workspace_id: "anthropic-workspace-id"),
             model: Anthropic::Beta::BetaManagedAgentsDeploymentRun,
             options: {extra_headers: {"anthropic-beta" => "managed-agents-2026-04-01"}, **options}
           )
@@ -33,7 +38,7 @@ module Anthropic
         # Some parameter documentations has been truncated, see
         # {Anthropic::Models::Beta::DeploymentRunListParams} for more details.
         #
-        # @overload list(created_at_gt: nil, created_at_gte: nil, created_at_lt: nil, created_at_lte: nil, deployment_id: nil, has_error: nil, limit: nil, page: nil, trigger_type: nil, betas: nil, request_options: {})
+        # @overload list(created_at_gt: nil, created_at_gte: nil, created_at_lt: nil, created_at_lte: nil, deployment_id: nil, has_error: nil, limit: nil, page: nil, trigger_type: nil, betas: nil, workspace_id: nil, request_options: {})
         #
         # @param created_at_gt [Time] Query param: Return runs created strictly after this time (exclusive).
         #
@@ -53,7 +58,9 @@ module Anthropic
         #
         # @param trigger_type [Symbol, Anthropic::Models::Beta::BetaManagedAgentsTriggerType] Query param: Filter runs by what triggered them. Omit to return all runs.
         #
-        # @param betas [Array<String, Symbol, Anthropic::Models::AnthropicBeta>] Header param: Optional header to specify the beta version(s) you want to use.
+        # @param betas [Array<Symbol, String, Anthropic::Models::AnthropicBeta>] Header param: Optional header to specify the beta version(s) you want to use.
+        #
+        # @param workspace_id [String] Header param: Optional header to select the Workspace for this request. The valu
         #
         # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -84,7 +91,10 @@ module Anthropic
               created_at_lt: "created_at[lt]",
               created_at_lte: "created_at[lte]"
             ),
-            headers: parsed.except(*query_params).transform_keys(betas: "anthropic-beta"),
+            headers: parsed.except(*query_params).transform_keys(
+              betas: "anthropic-beta",
+              workspace_id: "anthropic-workspace-id"
+            ),
             page: Anthropic::Internal::PageCursor,
             model: Anthropic::Beta::BetaManagedAgentsDeploymentRun,
             options: {extra_headers: {"anthropic-beta" => "managed-agents-2026-04-01"}, **options}

data/lib/anthropic/resources/beta/deployments.rb

@@ -9,9 +9,9 @@ module Anthropic
         # Some parameter documentations has been truncated, see
         # {Anthropic::Models::Beta::DeploymentCreateParams} for more details.
         #
-        # @overload create(agent:, environment_id:, initial_events:, name:, budget: nil, description: nil, metadata: nil, resources: nil, schedule: nil, vault_ids: nil, betas: nil, request_options: {})
+        # @overload create(agent:, environment_id:, initial_events:, name:, budget: nil, description: nil, metadata: nil, resources: nil, schedule: nil, vault_ids: nil, betas: nil, workspace_id: nil, request_options: {})
         #
-        # @param agent [String, Anthropic::Models::Beta::BetaManagedAgentsAgentParams] Body param: Agent to deploy. Accepts the `agent` ID string, which pins the lates
+        # @param agent [Anthropic::Models::Beta::BetaManagedAgentsAgentParams, String] Body param: Agent to deploy. Accepts the `agent` ID string, which pins the lates
         #
         # @param environment_id [String] Body param: ID of the `environment` defining the container configuration for ses
         #
@@ -19,7 +19,7 @@ module Anthropic
         #
         # @param name [String] Body param: Human-readable name for the deployment.
         #
-        # @param budget [Anthropic::Models::Beta::BetaManagedAgentsBudgetLimit, nil] Body param: A hard spend ceiling. The session stops issuing new model requests o
+        # @param budget [Anthropic::Models::Beta::BetaManagedAgentsBudgetLimit, nil] Body param: Enforced spend ceiling stamped onto each session created from this d
         #
         # @param description [String, nil] Body param: Description of what the deployment does.
         #
@@ -27,11 +27,13 @@ module Anthropic
         #
         # @param resources [Array<Anthropic::Models::Beta::BetaManagedAgentsGitHubRepositoryResourceParams, Anthropic::Models::Beta::BetaManagedAgentsFileResourceParams, Anthropic::Models::Beta::BetaManagedAgentsMemoryStoreResourceParam>] Body param: Resources (e.g. repositories, files) to mount into each session's co
         #
-        # @param schedule [Anthropic::Models::Beta::BetaManagedAgentsScheduleParams, nil] Body param: 5-field POSIX cron schedule. Literal wall-clock matching in the conf
+        # @param schedule [Anthropic::Models::Beta::BetaManagedAgentsScheduleParams, nil] Body param: Optional recurring cron schedule. When present, the deployment fires
         #
         # @param vault_ids [Array<String>] Body param: Vault IDs for stored credentials the agent can use during sessions c
         #
-        # @param betas [Array<String, Symbol, Anthropic::Models::AnthropicBeta>] Header param: Optional header to specify the beta version(s) you want to use.
+        # @param betas [Array<Symbol, String, Anthropic::Models::AnthropicBeta>] Header param: Optional header to specify the beta version(s) you want to use.
+        #
+        # @param workspace_id [String] Header param: Optional header to select the Workspace for this request. The valu
         #
         # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -40,7 +42,7 @@ module Anthropic
         # @see Anthropic::Models::Beta::DeploymentCreateParams
         def create(params)
           parsed, options = Anthropic::Beta::DeploymentCreateParams.dump_request(params)
-          header_params = {betas: "anthropic-beta"}
+          header_params = {betas: "anthropic-beta", workspace_id: "anthropic-workspace-id"}
           @client.request(
             method: :post,
             path: "v1/deployments?beta=true",
@@ -53,11 +55,16 @@ module Anthropic
 
         # Get Deployment
         #
-        # @overload retrieve(deployment_id, betas: nil, request_options: {})
+        # Some parameter documentations has been truncated, see
+        # {Anthropic::Models::Beta::DeploymentRetrieveParams} for more details.
+        #
+        # @overload retrieve(deployment_id, betas: nil, workspace_id: nil, request_options: {})
         #
-        # @param deployment_id [String] Path parameter deployment_id
+        # @param deployment_id [String] Unique identifier of the deployment.
         #
-        # @param betas [Array<String, Symbol, Anthropic::Models::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
+        # @param betas [Array<Symbol, String, Anthropic::Models::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
+        #
+        # @param workspace_id [String] Optional header to select the Workspace for this request. The value is a Workspa
         #
         # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -69,7 +76,7 @@ module Anthropic
           @client.request(
             method: :get,
             path: ["v1/deployments/%1$s?beta=true", deployment_id],
-            headers: parsed.transform_keys(betas: "anthropic-beta"),
+            headers: parsed.transform_keys(betas: "anthropic-beta", workspace_id: "anthropic-workspace-id"),
             model: Anthropic::Beta::BetaManagedAgentsDeployment,
             options: {extra_headers: {"anthropic-beta" => "managed-agents-2026-04-01"}, **options}
           )
@@ -80,13 +87,13 @@ module Anthropic
         # Some parameter documentations has been truncated, see
         # {Anthropic::Models::Beta::DeploymentUpdateParams} for more details.
         #
-        # @overload update(deployment_id, agent: nil, budget: nil, description: nil, environment_id: nil, initial_events: nil, metadata: nil, name: nil, resources: nil, schedule: nil, vault_ids: nil, betas: nil, request_options: {})
+        # @overload update(deployment_id, agent: nil, budget: nil, description: nil, environment_id: nil, initial_events: nil, metadata: nil, name: nil, resources: nil, schedule: nil, vault_ids: nil, betas: nil, workspace_id: nil, request_options: {})
         #
-        # @param deployment_id [String] Path param: Path parameter deployment_id
+        # @param deployment_id [String] Path param: Unique identifier of the deployment to update.
         #
-        # @param agent [String, Anthropic::Models::Beta::BetaManagedAgentsAgentParams] Body param: Agent to deploy. Accepts the `agent` ID string, which re-pins to the
+        # @param agent [Anthropic::Models::Beta::BetaManagedAgentsAgentParams, String] Body param: Agent to deploy. Accepts the `agent` ID string, which re-pins to the
         #
-        # @param budget [Anthropic::Models::Beta::BetaManagedAgentsBudgetLimit, nil] Body param: A hard spend ceiling. The session stops issuing new model requests o
+        # @param budget [Anthropic::Models::Beta::BetaManagedAgentsBudgetLimit, nil] Body param: Spend ceiling for future sessions. Full replacement. Omit to preserv
         #
         # @param description [String, nil] Body param: Description. Omit to preserve; send empty string or null to clear.
         #
@@ -100,11 +107,13 @@ module Anthropic
         #
         # @param resources [Array<Anthropic::Models::Beta::BetaManagedAgentsGitHubRepositoryResourceParams, Anthropic::Models::Beta::BetaManagedAgentsFileResourceParams, Anthropic::Models::Beta::BetaManagedAgentsMemoryStoreResourceParam>, nil] Body param: Session resources. Full replacement. Omit to preserve; send empty ar
         #
-        # @param schedule [Anthropic::Models::Beta::BetaManagedAgentsScheduleParams, nil] Body param: 5-field POSIX cron schedule. Literal wall-clock matching in the conf
+        # @param schedule [Anthropic::Models::Beta::BetaManagedAgentsScheduleParams, nil] Body param: Cron schedule. Full replacement. Omit to preserve; send null to clea
         #
         # @param vault_ids [Array<String>, nil] Body param: Vault IDs. Full replacement. Omit to preserve; send empty array or n
         #
-        # @param betas [Array<String, Symbol, Anthropic::Models::AnthropicBeta>] Header param: Optional header to specify the beta version(s) you want to use.
+        # @param betas [Array<Symbol, String, Anthropic::Models::AnthropicBeta>] Header param: Optional header to specify the beta version(s) you want to use.
+        #
+        # @param workspace_id [String] Header param: Optional header to select the Workspace for this request. The valu
         #
         # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -113,7 +122,7 @@ module Anthropic
         # @see Anthropic::Models::Beta::DeploymentUpdateParams
         def update(deployment_id, params = {})
           parsed, options = Anthropic::Beta::DeploymentUpdateParams.dump_request(params)
-          header_params = {betas: "anthropic-beta"}
+          header_params = {betas: "anthropic-beta", workspace_id: "anthropic-workspace-id"}
           @client.request(
             method: :post,
             path: ["v1/deployments/%1$s?beta=true", deployment_id],
@@ -129,7 +138,7 @@ module Anthropic
         # Some parameter documentations has been truncated, see
         # {Anthropic::Models::Beta::DeploymentListParams} for more details.
         #
-        # @overload list(agent_id: nil, created_at_gte: nil, created_at_lte: nil, include_archived: nil, limit: nil, page: nil, status: nil, betas: nil, request_options: {})
+        # @overload list(agent_id: nil, created_at_gte: nil, created_at_lte: nil, include_archived: nil, limit: nil, page: nil, status: nil, betas: nil, workspace_id: nil, request_options: {})
         #
         # @param agent_id [String] Query param: Filter by agent ID.
         #
@@ -145,7 +154,9 @@ module Anthropic
         #
         # @param status [Symbol, Anthropic::Models::Beta::BetaManagedAgentsDeploymentStatus] Query param: Filter by status: `active` or `paused`. Omit for both. To include a
         #
-        # @param betas [Array<String, Symbol, Anthropic::Models::AnthropicBeta>] Header param: Optional header to specify the beta version(s) you want to use.
+        # @param betas [Array<Symbol, String, Anthropic::Models::AnthropicBeta>] Header param: Optional header to specify the beta version(s) you want to use.
+        #
+        # @param workspace_id [String] Header param: Optional header to select the Workspace for this request. The valu
         #
         # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -168,7 +179,10 @@ module Anthropic
             method: :get,
             path: "v1/deployments?beta=true",
             query: query.transform_keys(created_at_gte: "created_at[gte]", created_at_lte: "created_at[lte]"),
-            headers: parsed.except(*query_params).transform_keys(betas: "anthropic-beta"),
+            headers: parsed.except(*query_params).transform_keys(
+              betas: "anthropic-beta",
+              workspace_id: "anthropic-workspace-id"
+            ),
             page: Anthropic::Internal::PageCursor,
             model: Anthropic::Beta::BetaManagedAgentsDeployment,
             options: {extra_headers: {"anthropic-beta" => "managed-agents-2026-04-01"}, **options}
@@ -177,11 +191,16 @@ module Anthropic
 
         # Archive Deployment
         #
-        # @overload archive(deployment_id, betas: nil, request_options: {})
+        # Some parameter documentations has been truncated, see
+        # {Anthropic::Models::Beta::DeploymentArchiveParams} for more details.
+        #
+        # @overload archive(deployment_id, betas: nil, workspace_id: nil, request_options: {})
+        #
+        # @param deployment_id [String] Unique identifier of the deployment to archive.
         #
-        # @param deployment_id [String] Path parameter deployment_id
+        # @param betas [Array<Symbol, String, Anthropic::Models::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
         #
-        # @param betas [Array<String, Symbol, Anthropic::Models::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
+        # @param workspace_id [String] Optional header to select the Workspace for this request. The value is a Workspa
         #
         # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -193,7 +212,7 @@ module Anthropic
           @client.request(
             method: :post,
             path: ["v1/deployments/%1$s/archive?beta=true", deployment_id],
-            headers: parsed.transform_keys(betas: "anthropic-beta"),
+            headers: parsed.transform_keys(betas: "anthropic-beta", workspace_id: "anthropic-workspace-id"),
             model: Anthropic::Beta::BetaManagedAgentsDeployment,
             options: {extra_headers: {"anthropic-beta" => "managed-agents-2026-04-01"}, **options}
           )
@@ -201,11 +220,16 @@ module Anthropic
 
         # Pause Deployment
         #
-        # @overload pause(deployment_id, betas: nil, request_options: {})
+        # Some parameter documentations has been truncated, see
+        # {Anthropic::Models::Beta::DeploymentPauseParams} for more details.
+        #
+        # @overload pause(deployment_id, betas: nil, workspace_id: nil, request_options: {})
+        #
+        # @param deployment_id [String] Unique identifier of the deployment to pause.
         #
-        # @param deployment_id [String] Path parameter deployment_id
+        # @param betas [Array<Symbol, String, Anthropic::Models::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
         #
-        # @param betas [Array<String, Symbol, Anthropic::Models::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
+        # @param workspace_id [String] Optional header to select the Workspace for this request. The value is a Workspa
         #
         # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -217,7 +241,7 @@ module Anthropic
           @client.request(
             method: :post,
             path: ["v1/deployments/%1$s/pause?beta=true", deployment_id],
-            headers: parsed.transform_keys(betas: "anthropic-beta"),
+            headers: parsed.transform_keys(betas: "anthropic-beta", workspace_id: "anthropic-workspace-id"),
             model: Anthropic::Beta::BetaManagedAgentsDeployment,
             options: {extra_headers: {"anthropic-beta" => "managed-agents-2026-04-01"}, **options}
           )
@@ -225,11 +249,16 @@ module Anthropic
 
         # Run Deployment Now
         #
-        # @overload run(deployment_id, betas: nil, request_options: {})
+        # Some parameter documentations has been truncated, see
+        # {Anthropic::Models::Beta::DeploymentRunParams} for more details.
+        #
+        # @overload run(deployment_id, betas: nil, workspace_id: nil, request_options: {})
         #
-        # @param deployment_id [String] Path parameter deployment_id
+        # @param deployment_id [String] Unique identifier of the deployment to run.
         #
-        # @param betas [Array<String, Symbol, Anthropic::Models::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
+        # @param betas [Array<Symbol, String, Anthropic::Models::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
+        #
+        # @param workspace_id [String] Optional header to select the Workspace for this request. The value is a Workspa
         #
         # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -241,7 +270,7 @@ module Anthropic
           @client.request(
             method: :post,
             path: ["v1/deployments/%1$s/run?beta=true", deployment_id],
-            headers: parsed.transform_keys(betas: "anthropic-beta"),
+            headers: parsed.transform_keys(betas: "anthropic-beta", workspace_id: "anthropic-workspace-id"),
             model: Anthropic::Beta::BetaManagedAgentsDeploymentRun,
             options: {extra_headers: {"anthropic-beta" => "managed-agents-2026-04-01"}, **options}
           )
@@ -249,11 +278,16 @@ module Anthropic
 
         # Unpause Deployment
         #
-        # @overload unpause(deployment_id, betas: nil, request_options: {})
+        # Some parameter documentations has been truncated, see
+        # {Anthropic::Models::Beta::DeploymentUnpauseParams} for more details.
+        #
+        # @overload unpause(deployment_id, betas: nil, workspace_id: nil, request_options: {})
+        #
+        # @param deployment_id [String] Unique identifier of the deployment to unpause.
         #
-        # @param deployment_id [String] Path parameter deployment_id
+        # @param betas [Array<Symbol, String, Anthropic::Models::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
         #
-        # @param betas [Array<String, Symbol, Anthropic::Models::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
+        # @param workspace_id [String] Optional header to select the Workspace for this request. The value is a Workspa
         #
         # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -265,7 +299,7 @@ module Anthropic
           @client.request(
             method: :post,
             path: ["v1/deployments/%1$s/unpause?beta=true", deployment_id],
-            headers: parsed.transform_keys(betas: "anthropic-beta"),
+            headers: parsed.transform_keys(betas: "anthropic-beta", workspace_id: "anthropic-workspace-id"),
             model: Anthropic::Beta::BetaManagedAgentsDeployment,
             options: {extra_headers: {"anthropic-beta" => "managed-agents-2026-04-01"}, **options}
           )

data/lib/anthropic/resources/beta/dreams.rb

@@ -4,22 +4,34 @@ module Anthropic
   module Resources
     class Beta
       class Dreams
-        # Create a Dream
+        # 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#create-a-dream)
+        # to learn more about creating dreams.
         #
         # Some parameter documentations has been truncated, see
         # {Anthropic::Models::Beta::DreamCreateParams} for more details.
         #
-        # @overload create(inputs:, model:, instructions: nil, output_behavior: nil, betas: nil, request_options: {})
+        # @overload create(inputs:, model:, instructions: nil, output_behavior: nil, betas: nil, workspace_id: nil, request_options: {})
+        #
+        # @param inputs [Array<Anthropic::Models::Beta::BetaDreamMemoryStoreInput, Anthropic::Models::Beta::BetaDreamSessionsInput>] Body param: The memory store and sessions for the dream to read, as exactly one
         #
-        # @param inputs [Array<Anthropic::Models::Beta::BetaDreamMemoryStoreInput, Anthropic::Models::Beta::BetaDreamSessionsInput>] Body param
+        # @param model [Anthropic::Models::Beta::BetaDreamModelConfigParam, String] Body param: The model that runs a dream, given as a model ID or as an object wit
         #
-        # @param model [String, Anthropic::Models::Beta::BetaDreamModelConfigParam] Body param: Model identifier and configuration applied to every pipeline stage.
+        # @param instructions [String, nil] Body param: Guidance that steers how the dream reads the sessions and organizes
         #
-        # @param instructions [String, nil] Body param
+        # @param output_behavior [Anthropic::Models::Beta::BetaOutputBehaviorCreateNew, Anthropic::Models::Beta::BetaOutputBehaviorUpdateExisting] Body param: Which memory store a dream writes its result to. Defaults to `create
         #
-        # @param output_behavior [Anthropic::Models::Beta::BetaOutputBehaviorCreateNew, Anthropic::Models::Beta::BetaOutputBehaviorUpdateExisting] Body param: The default destination: the job creates a new output memory store a
+        # @param betas [Array<Symbol, String, Anthropic::Models::AnthropicBeta>] Header param: Optional header to specify the beta version(s) you want to use.
         #
-        # @param betas [Array<String, Symbol, Anthropic::Models::AnthropicBeta>] Header param: Optional header to specify the beta version(s) you want to use.
+        # @param workspace_id [String] Header param: Optional header to select the Workspace for this request. The valu
         #
         # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -28,7 +40,7 @@ module Anthropic
         # @see Anthropic::Models::Beta::DreamCreateParams
         def create(params)
           parsed, options = Anthropic::Beta::DreamCreateParams.dump_request(params)
-          header_params = {betas: "anthropic-beta"}
+          header_params = {betas: "anthropic-beta", workspace_id: "anthropic-workspace-id"}
           @client.request(
             method: :post,
             path: "v1/dreams?beta=true",
@@ -39,13 +51,24 @@ module Anthropic
           )
         end
 
-        # Get a Dream
+        # Get a dream by ID to check its status, output memory store, and token usage.
         #
-        # @overload retrieve(dream_id, betas: nil, request_options: {})
+        # Archived dreams are returned too.
+        #
+        # See the
+        # [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams#track-progress)
+        # for how to poll a dream and what each status means.
+        #
+        # Some parameter documentations has been truncated, see
+        # {Anthropic::Models::Beta::DreamRetrieveParams} for more details.
         #
-        # @param dream_id [String] Path parameter dream_id
+        # @overload retrieve(dream_id, betas: nil, workspace_id: nil, request_options: {})
         #
-        # @param betas [Array<String, Symbol, Anthropic::Models::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
+        # @param dream_id [String] The ID of the dream to get (`drm_...`).
+        #
+        # @param betas [Array<Symbol, String, Anthropic::Models::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
+        #
+        # @param workspace_id [String] Optional header to select the Workspace for this request. The value is a Workspa
         #
         # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -57,32 +80,40 @@ module Anthropic
           @client.request(
             method: :get,
             path: ["v1/dreams/%1$s?beta=true", dream_id],
-            headers: parsed.transform_keys(betas: "anthropic-beta"),
+            headers: parsed.transform_keys(betas: "anthropic-beta", workspace_id: "anthropic-workspace-id"),
             model: Anthropic::Beta::BetaDream,
             options: {extra_headers: {"anthropic-beta" => "dreaming-2026-04-21"}, **options}
           )
         end
 
-        # List 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#list-dreams)
+        # for how to page through dreams.
         #
         # Some parameter documentations has been truncated, see
         # {Anthropic::Models::Beta::DreamListParams} for more details.
         #
-        # @overload list(created_at_gt: nil, created_at_lt: nil, include_archived: nil, limit: nil, page: nil, statuses: nil, betas: nil, request_options: {})
+        # @overload list(created_at_gt: nil, created_at_lt: nil, include_archived: nil, limit: nil, page: nil, statuses: nil, betas: nil, workspace_id: nil, request_options: {})
+        #
+        # @param created_at_gt [Time] Query param: Return only dreams created after this time (exclusive), in RFC 3339
         #
-        # @param created_at_gt [Time] Query param: Return dreams with `created_at` strictly after this timestamp (excl
+        # @param created_at_lt [Time] Query param: Return only dreams created before this time (exclusive), in RFC 333
         #
-        # @param created_at_lt [Time] Query param: Return dreams with `created_at` strictly before this timestamp (exc
+        # @param include_archived [Boolean] Query param: Whether to include archived dreams. Defaults to `false`.
         #
-        # @param include_archived [Boolean] Query param: Query parameter for include_archived
+        # @param limit [Integer] Query param: The maximum number of dreams to return, from 1 to 100. Defaults to
         #
-        # @param limit [Integer] Query param: Query parameter for limit
+        # @param page [String] Query param: The cursor for the page to return, taken from `next_page` in a prev
         #
-        # @param page [String] Query param: Query parameter for page
+        # @param statuses [Array<Symbol, Anthropic::Models::Beta::BetaDreamStatus>] Query param: Return only dreams that have one of these statuses.
         #
-        # @param statuses [Array<Symbol, Anthropic::Models::Beta::BetaDreamStatus>] Query param: Filter by lifecycle status. Repeat the parameter to match any of mu
+        # @param betas [Array<Symbol, String, Anthropic::Models::AnthropicBeta>] Header param: Optional header to specify the beta version(s) you want to use.
         #
-        # @param betas [Array<String, Symbol, Anthropic::Models::AnthropicBeta>] Header param: Optional header to specify the beta version(s) you want to use.
+        # @param workspace_id [String] Header param: Optional header to select the Workspace for this request. The valu
         #
         # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -97,20 +128,37 @@ module Anthropic
             method: :get,
             path: "v1/dreams?beta=true",
             query: query.transform_keys(created_at_gt: "created_at[gt]", created_at_lt: "created_at[lt]"),
-            headers: parsed.except(*query_params).transform_keys(betas: "anthropic-beta"),
+            headers: parsed.except(*query_params).transform_keys(
+              betas: "anthropic-beta",
+              workspace_id: "anthropic-workspace-id"
+            ),
             page: Anthropic::Internal::PageCursor,
             model: Anthropic::Beta::BetaDream,
             options: {extra_headers: {"anthropic-beta" => "dreaming-2026-04-21"}, **options}
           )
         end
 
-        # Archive a Dream
+        # Hide a `completed`, `failed`, or `canceled` dream from the default list of
+        # dreams.
         #
-        # @overload archive(dream_id, betas: nil, request_options: {})
+        # 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.
         #
-        # @param dream_id [String] Path parameter dream_id
+        # See the
+        # [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams#archive-a-dream)
+        # to learn more about archiving dreams.
         #
-        # @param betas [Array<String, Symbol, Anthropic::Models::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
+        # Some parameter documentations has been truncated, see
+        # {Anthropic::Models::Beta::DreamArchiveParams} for more details.
+        #
+        # @overload archive(dream_id, betas: nil, workspace_id: nil, request_options: {})
+        #
+        # @param dream_id [String] The ID of the dream to archive (`drm_...`).
+        #
+        # @param betas [Array<Symbol, String, Anthropic::Models::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
+        #
+        # @param workspace_id [String] Optional header to select the Workspace for this request. The value is a Workspa
         #
         # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -122,19 +170,33 @@ module Anthropic
           @client.request(
             method: :post,
             path: ["v1/dreams/%1$s/archive?beta=true", dream_id],
-            headers: parsed.transform_keys(betas: "anthropic-beta"),
+            headers: parsed.transform_keys(betas: "anthropic-beta", workspace_id: "anthropic-workspace-id"),
             model: Anthropic::Beta::BetaDream,
             options: {extra_headers: {"anthropic-beta" => "dreaming-2026-04-21"}, **options}
           )
         end
 
-        # Cancel a Dream
+        # 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#cancel-a-dream)
+        # to learn more about canceling dreams.
+        #
+        # Some parameter documentations has been truncated, see
+        # {Anthropic::Models::Beta::DreamCancelParams} for more details.
+        #
+        # @overload cancel(dream_id, betas: nil, workspace_id: nil, request_options: {})
         #
-        # @overload cancel(dream_id, betas: nil, request_options: {})
+        # @param dream_id [String] The ID of the dream to cancel (`drm_...`).
         #
-        # @param dream_id [String] Path parameter dream_id
+        # @param betas [Array<Symbol, String, Anthropic::Models::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
         #
-        # @param betas [Array<String, Symbol, Anthropic::Models::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
+        # @param workspace_id [String] Optional header to select the Workspace for this request. The value is a Workspa
         #
         # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -146,7 +208,7 @@ module Anthropic
           @client.request(
             method: :post,
             path: ["v1/dreams/%1$s/cancel?beta=true", dream_id],
-            headers: parsed.transform_keys(betas: "anthropic-beta"),
+            headers: parsed.transform_keys(betas: "anthropic-beta", workspace_id: "anthropic-workspace-id"),
             model: Anthropic::Beta::BetaDream,
             options: {extra_headers: {"anthropic-beta" => "dreaming-2026-04-21"}, **options}
           )