anthropic 1.78.0 → 1.80.0

data/rbi/anthropic/models/beta/beta_managed_agents_aws_role_execution_identity_params.rbi

@@ -0,0 +1,42 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    BetaManagedAgentsAWSRoleExecutionIdentityParams =
+      Beta::BetaManagedAgentsAWSRoleExecutionIdentityParams
+
+    module Beta
+      class BetaManagedAgentsAWSRoleExecutionIdentityParams < Anthropic::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Anthropic::Beta::BetaManagedAgentsAWSRoleExecutionIdentityParams,
+              Anthropic::Internal::AnyHash
+            )
+          end
+
+        # The IAM role's ARN, e.g. "arn:aws:iam::123456789012:role/my-agent-runner".
+        # Maximum 2048 characters.
+        sig { returns(String) }
+        attr_accessor :role_arn
+
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        # An AWS IAM role principal.
+        sig { params(role_arn: String, type: Symbol).returns(T.attached_class) }
+        def self.new(
+          # The IAM role's ARN, e.g. "arn:aws:iam::123456789012:role/my-agent-runner".
+          # Maximum 2048 characters.
+          role_arn:,
+          type: :aws_role
+        )
+        end
+
+        sig { override.returns({ role_arn: String, type: Symbol }) }
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/anthropic/models/beta/beta_managed_agents_execution_identity.rbi

@@ -0,0 +1,85 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    BetaManagedAgentsExecutionIdentity =
+      Beta::BetaManagedAgentsExecutionIdentity
+
+    module Beta
+      # Execution principal for runs of this agent as returned in API responses.
+      module BetaManagedAgentsExecutionIdentity
+        extend Anthropic::Internal::Type::Union
+
+        Variants =
+          T.type_alias do
+            T.any(
+              Anthropic::Beta::BetaManagedAgentsAWSRoleExecutionIdentity,
+              Anthropic::Beta::BetaManagedAgentsServiceAccountExecutionIdentity
+            )
+          end
+
+        module Type
+          extend Anthropic::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                Anthropic::Beta::BetaManagedAgentsExecutionIdentity::Type
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          AWS_ROLE =
+            T.let(
+              :aws_role,
+              Anthropic::Beta::BetaManagedAgentsExecutionIdentity::Type::TaggedSymbol
+            )
+          SERVICE_ACCOUNT =
+            T.let(
+              :service_account,
+              Anthropic::Beta::BetaManagedAgentsExecutionIdentity::Type::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                Anthropic::Beta::BetaManagedAgentsExecutionIdentity::Type::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+
+        sig do
+          override.returns(
+            T::Array[
+              Anthropic::Beta::BetaManagedAgentsExecutionIdentity::Variants
+            ]
+          )
+        end
+        def self.variants
+        end
+
+        # Creates a new instance of the variant class whose `type` matches the given
+        # value, passing the remaining arguments to its constructor.
+        sig do
+          params(
+            type:
+              Anthropic::Beta::BetaManagedAgentsExecutionIdentity::Type::OrSymbol,
+            role_arn: String
+          ).returns(
+            Anthropic::Beta::BetaManagedAgentsExecutionIdentity::Variants
+          )
+        end
+        def self.new(
+          type:,
+          # The IAM role's ARN.
+          role_arn: nil
+        )
+        end
+      end
+    end
+  end
+end

data/rbi/anthropic/models/beta/beta_managed_agents_execution_identity_params.rbi

@@ -0,0 +1,87 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    BetaManagedAgentsExecutionIdentityParams =
+      Beta::BetaManagedAgentsExecutionIdentityParams
+
+    module Beta
+      # Execution principal for runs of this agent: `service_account` (the default) or
+      # `aws_role`.
+      module BetaManagedAgentsExecutionIdentityParams
+        extend Anthropic::Internal::Type::Union
+
+        Variants =
+          T.type_alias do
+            T.any(
+              Anthropic::Beta::BetaManagedAgentsAWSRoleExecutionIdentityParams,
+              Anthropic::Beta::BetaManagedAgentsServiceAccountExecutionIdentityParams
+            )
+          end
+
+        module Type
+          extend Anthropic::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                Anthropic::Beta::BetaManagedAgentsExecutionIdentityParams::Type
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          AWS_ROLE =
+            T.let(
+              :aws_role,
+              Anthropic::Beta::BetaManagedAgentsExecutionIdentityParams::Type::TaggedSymbol
+            )
+          SERVICE_ACCOUNT =
+            T.let(
+              :service_account,
+              Anthropic::Beta::BetaManagedAgentsExecutionIdentityParams::Type::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                Anthropic::Beta::BetaManagedAgentsExecutionIdentityParams::Type::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+
+        sig do
+          override.returns(
+            T::Array[
+              Anthropic::Beta::BetaManagedAgentsExecutionIdentityParams::Variants
+            ]
+          )
+        end
+        def self.variants
+        end
+
+        # Creates a new instance of the variant class whose `type` matches the given
+        # value, passing the remaining arguments to its constructor.
+        sig do
+          params(
+            type:
+              Anthropic::Beta::BetaManagedAgentsExecutionIdentityParams::Type::OrSymbol,
+            role_arn: String
+          ).returns(
+            Anthropic::Beta::BetaManagedAgentsExecutionIdentityParams::Variants
+          )
+        end
+        def self.new(
+          type:,
+          # The IAM role's ARN, e.g. "arn:aws:iam::123456789012:role/my-agent-runner".
+          # Maximum 2048 characters.
+          role_arn: nil
+        )
+        end
+      end
+    end
+  end
+end

data/rbi/anthropic/models/beta/beta_managed_agents_model.rbi

@@ -108,14 +108,12 @@ module Anthropic
             Anthropic::Beta::BetaManagedAgentsModel::TaggedSymbol
           )
 
-        # Fastest model with near-frontier intelligence
         CLAUDE_HAIKU_4_5 =
           T.let(
             :"claude-haiku-4-5",
             Anthropic::Beta::BetaManagedAgentsModel::TaggedSymbol
           )
 
-        # Fastest model with near-frontier intelligence
         CLAUDE_HAIKU_4_5_20251001 =
           T.let(
             :"claude-haiku-4-5-20251001",

data/rbi/anthropic/models/beta/beta_managed_agents_service_account_execution_identity.rbi

@@ -0,0 +1,32 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    BetaManagedAgentsServiceAccountExecutionIdentity =
+      Beta::BetaManagedAgentsServiceAccountExecutionIdentity
+
+    module Beta
+      class BetaManagedAgentsServiceAccountExecutionIdentity < Anthropic::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Anthropic::Beta::BetaManagedAgentsServiceAccountExecutionIdentity,
+              Anthropic::Internal::AnyHash
+            )
+          end
+
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        # The Anthropic-managed service account as returned in API responses.
+        sig { params(type: Symbol).returns(T.attached_class) }
+        def self.new(type: :service_account)
+        end
+
+        sig { override.returns({ type: Symbol }) }
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/anthropic/models/beta/beta_managed_agents_service_account_execution_identity_params.rbi

@@ -0,0 +1,33 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    BetaManagedAgentsServiceAccountExecutionIdentityParams =
+      Beta::BetaManagedAgentsServiceAccountExecutionIdentityParams
+
+    module Beta
+      class BetaManagedAgentsServiceAccountExecutionIdentityParams < Anthropic::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Anthropic::Beta::BetaManagedAgentsServiceAccountExecutionIdentityParams,
+              Anthropic::Internal::AnyHash
+            )
+          end
+
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        # The Anthropic-managed service account — the default execution principal. Carries
+        # no identifier.
+        sig { params(type: Symbol).returns(T.attached_class) }
+        def self.new(type: :service_account)
+        end
+
+        sig { override.returns({ type: Symbol }) }
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/anthropic/models/beta/beta_managed_agents_session_agent.rbi

@@ -20,6 +20,14 @@ module Anthropic
         sig { returns(T.nilable(String)) }
         attr_accessor :description
 
+        # Execution principal snapshotted from the agent at session creation. Always
+        # present; `{"type": "service_account"}` when runs carry no customer-named
+        # principal.
+        sig do
+          returns(Anthropic::Beta::BetaManagedAgentsExecutionIdentity::Variants)
+        end
+        attr_accessor :execution_identity
+
         sig do
           returns(
             T::Array[Anthropic::Beta::BetaManagedAgentsMCPServerURLDefinition]
@@ -89,6 +97,11 @@ module Anthropic
           params(
             id: String,
             description: T.nilable(String),
+            execution_identity:
+              T.any(
+                Anthropic::Beta::BetaManagedAgentsAWSRoleExecutionIdentity::OrHash,
+                Anthropic::Beta::BetaManagedAgentsServiceAccountExecutionIdentity::OrHash
+              ),
             mcp_servers:
               T::Array[
                 Anthropic::Beta::BetaManagedAgentsMCPServerURLDefinition::OrHash
@@ -126,6 +139,10 @@ module Anthropic
         def self.new(
           id:,
           description:,
+          # Execution principal snapshotted from the agent at session creation. Always
+          # present; `{"type": "service_account"}` when runs carry no customer-named
+          # principal.
+          execution_identity:,
           mcp_servers:,
           # Model identifier and configuration.
           model:,
@@ -146,6 +163,8 @@ module Anthropic
             {
               id: String,
               description: T.nilable(String),
+              execution_identity:
+                Anthropic::Beta::BetaManagedAgentsExecutionIdentity::Variants,
               mcp_servers:
                 T::Array[
                   Anthropic::Beta::BetaManagedAgentsMCPServerURLDefinition

data/rbi/anthropic/models/beta/beta_managed_agents_session_multiagent_coordinator.rbi

@@ -138,6 +138,11 @@ module Anthropic
                 ),
               id: String,
               description: T.nilable(String),
+              execution_identity:
+                T.any(
+                  Anthropic::Beta::BetaManagedAgentsAWSRoleExecutionIdentity::OrHash,
+                  Anthropic::Beta::BetaManagedAgentsServiceAccountExecutionIdentity::OrHash
+                ),
               mcp_servers:
                 T::Array[
                   Anthropic::Beta::BetaManagedAgentsMCPServerURLDefinition::OrHash
@@ -170,6 +175,10 @@ module Anthropic
             model:,
             id: nil,
             description: nil,
+            # Execution principal snapshotted from the agent at session creation. Always
+            # present; `{"type": "service_account"}` when runs carry no customer-named
+            # principal.
+            execution_identity: nil,
             mcp_servers: nil,
             name: nil,
             skills: nil,

data/rbi/anthropic/models/beta/beta_managed_agents_session_thread_agent.rbi

@@ -21,6 +21,14 @@ module Anthropic
         sig { returns(T.nilable(String)) }
         attr_accessor :description
 
+        # Execution principal snapshotted from the agent at session creation. Always
+        # present; `{"type": "service_account"}` when runs carry no customer-named
+        # principal.
+        sig do
+          returns(Anthropic::Beta::BetaManagedAgentsExecutionIdentity::Variants)
+        end
+        attr_accessor :execution_identity
+
         sig do
           returns(
             T::Array[Anthropic::Beta::BetaManagedAgentsMCPServerURLDefinition]
@@ -80,6 +88,11 @@ module Anthropic
           params(
             id: String,
             description: T.nilable(String),
+            execution_identity:
+              T.any(
+                Anthropic::Beta::BetaManagedAgentsAWSRoleExecutionIdentity::OrHash,
+                Anthropic::Beta::BetaManagedAgentsServiceAccountExecutionIdentity::OrHash
+              ),
             mcp_servers:
               T::Array[
                 Anthropic::Beta::BetaManagedAgentsMCPServerURLDefinition::OrHash
@@ -110,6 +123,10 @@ module Anthropic
         def self.new(
           id:,
           description:,
+          # Execution principal snapshotted from the agent at session creation. Always
+          # present; `{"type": "service_account"}` when runs carry no customer-named
+          # principal.
+          execution_identity:,
           mcp_servers:,
           # Model identifier and configuration.
           model:,
@@ -127,6 +144,8 @@ module Anthropic
             {
               id: String,
               description: T.nilable(String),
+              execution_identity:
+                Anthropic::Beta::BetaManagedAgentsExecutionIdentity::Variants,
               mcp_servers:
                 T::Array[
                   Anthropic::Beta::BetaManagedAgentsMCPServerURLDefinition

data/rbi/anthropic/models/beta/beta_message_delta_usage.rbi

@@ -49,7 +49,6 @@ module Anthropic
         # (model sampling iterations, such as the turns of a server-side tool use loop),
         # this allows you to:
         #
-        # - Determine which iterations exceeded long context thresholds (>=200k tokens)
         # - Calculate the context window size from the last `message` entry
         # - Understand token accumulation across server-side tool use loops
         #
@@ -151,7 +150,6 @@ module Anthropic
           # (model sampling iterations, such as the turns of a server-side tool use loop),
           # this allows you to:
           #
-          # - Determine which iterations exceeded long context thresholds (>=200k tokens)
           # - Calculate the context window size from the last `message` entry
           # - Understand token accumulation across server-side tool use loops
           #

data/rbi/anthropic/models/beta/beta_thinking_config_adaptive.rbi

@@ -33,8 +33,9 @@ module Anthropic
 
         # Controls how thinking content appears in the response. When set to `summarized`,
         # thinking is returned normally. When set to `omitted`, thinking content is
-        # redacted but a signature is returned for multi-turn continuity. Defaults to
-        # `summarized`.
+        # redacted but a signature is returned for multi-turn continuity. The default
+        # depends on the model; see
+        # [Controlling thinking display](https://platform.claude.com/docs/en/build-with-claude/thinking#controlling-thinking-display).
         sig do
           returns(
             T.nilable(
@@ -62,8 +63,9 @@ module Anthropic
           block_binding: nil,
           # Controls how thinking content appears in the response. When set to `summarized`,
           # thinking is returned normally. When set to `omitted`, thinking content is
-          # redacted but a signature is returned for multi-turn continuity. Defaults to
-          # `summarized`.
+          # redacted but a signature is returned for multi-turn continuity. The default
+          # depends on the model; see
+          # [Controlling thinking display](https://platform.claude.com/docs/en/build-with-claude/thinking#controlling-thinking-display).
           display_: nil,
           type: :adaptive
         )
@@ -87,8 +89,9 @@ module Anthropic
 
         # Controls how thinking content appears in the response. When set to `summarized`,
         # thinking is returned normally. When set to `omitted`, thinking content is
-        # redacted but a signature is returned for multi-turn continuity. Defaults to
-        # `summarized`.
+        # redacted but a signature is returned for multi-turn continuity. The default
+        # depends on the model; see
+        # [Controlling thinking display](https://platform.claude.com/docs/en/build-with-claude/thinking#controlling-thinking-display).
         module Display
           extend Anthropic::Internal::Type::Enum
 

data/rbi/anthropic/models/beta/beta_thinking_config_enabled.rbi

@@ -45,8 +45,9 @@ module Anthropic
 
         # Controls how thinking content appears in the response. When set to `summarized`,
         # thinking is returned normally. When set to `omitted`, thinking content is
-        # redacted but a signature is returned for multi-turn continuity. Defaults to
-        # `summarized`.
+        # redacted but a signature is returned for multi-turn continuity. The default
+        # depends on the model; see
+        # [Controlling thinking display](https://platform.claude.com/docs/en/build-with-claude/thinking#controlling-thinking-display).
         sig do
           returns(
             T.nilable(
@@ -85,8 +86,9 @@ module Anthropic
           block_binding: nil,
           # Controls how thinking content appears in the response. When set to `summarized`,
           # thinking is returned normally. When set to `omitted`, thinking content is
-          # redacted but a signature is returned for multi-turn continuity. Defaults to
-          # `summarized`.
+          # redacted but a signature is returned for multi-turn continuity. The default
+          # depends on the model; see
+          # [Controlling thinking display](https://platform.claude.com/docs/en/build-with-claude/thinking#controlling-thinking-display).
           display_: nil,
           type: :enabled
         )
@@ -111,8 +113,9 @@ module Anthropic
 
         # Controls how thinking content appears in the response. When set to `summarized`,
         # thinking is returned normally. When set to `omitted`, thinking content is
-        # redacted but a signature is returned for multi-turn continuity. Defaults to
-        # `summarized`.
+        # redacted but a signature is returned for multi-turn continuity. The default
+        # depends on the model; see
+        # [Controlling thinking display](https://platform.claude.com/docs/en/build-with-claude/thinking#controlling-thinking-display).
         module Display
           extend Anthropic::Internal::Type::Enum
 

data/rbi/anthropic/models/beta/beta_thinking_config_param.rbi

@@ -5,15 +5,16 @@ module Anthropic
     BetaThinkingConfigParam = Beta::BetaThinkingConfigParam
 
     module Beta
-      # Configuration for enabling Claude's extended thinking.
+      # Configuration for Claude's thinking.
       #
-      # When enabled, responses include `thinking` content blocks showing Claude's
-      # thinking process before the final answer. Requires a minimum budget of 1,024
-      # tokens and counts towards your `max_tokens` limit.
+      # With `{"type": "adaptive"}`, Claude decides when and how much to think. With
+      # `{"type": "enabled"}` (manual extended thinking), you set a `budget_tokens` of
+      # at least 1,024. Thinking tokens count toward your `max_tokens` limit.
       #
-      # See
-      # [extended thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking)
-      # for details.
+      # Which `type` values are accepted, and what happens when you omit `thinking`,
+      # depend on the model. See
+      # [thinking](https://platform.claude.com/docs/en/build-with-claude/thinking#configuring-thinking)
+      # for each model's behavior.
       module BetaThinkingConfigParam
         extend Anthropic::Internal::Type::Union
 
@@ -113,8 +114,9 @@ module Anthropic
           block_binding: nil,
           # Controls how thinking content appears in the response. When set to `summarized`,
           # thinking is returned normally. When set to `omitted`, thinking content is
-          # redacted but a signature is returned for multi-turn continuity. Defaults to
-          # `summarized`.
+          # redacted but a signature is returned for multi-turn continuity. The default
+          # depends on the model; see
+          # [Controlling thinking display](https://platform.claude.com/docs/en/build-with-claude/thinking#controlling-thinking-display).
           display_: nil
         )
         end

data/rbi/anthropic/models/beta/beta_thinking_types.rbi

@@ -24,9 +24,27 @@ module Anthropic
         end
         attr_writer :adaptive
 
+        # Whether the model accepts thinking with type 'between_tools' (thinking turned
+        # off, and any short progress updates the model writes between tool calls come
+        # back as thinking blocks). False exactly when a request that sends it gets a 400
+        # from this model. A request that sends 'between_tools' can still be rejected for
+        # another reason, such as an effort level the model does not allow with thinking
+        # off.
+        sig { returns(Anthropic::Beta::BetaCapabilitySupport) }
+        attr_reader :between_tools
+
+        sig do
+          params(
+            between_tools: Anthropic::Beta::BetaCapabilitySupport::OrHash
+          ).void
+        end
+        attr_writer :between_tools
+
         # Whether the model accepts thinking with type 'disabled' (thinking turned off).
         # False exactly when a request that sends it gets a 400 from this model. True on a
-        # model that does not support thinking.
+        # model that does not support thinking. A request that sends 'disabled' can still
+        # be rejected for another reason, such as an effort level the model does not allow
+        # with thinking off.
         sig { returns(Anthropic::Beta::BetaCapabilitySupport) }
         attr_reader :disabled
 
@@ -50,6 +68,7 @@ module Anthropic
         sig do
           params(
             adaptive: Anthropic::Beta::BetaCapabilitySupport::OrHash,
+            between_tools: Anthropic::Beta::BetaCapabilitySupport::OrHash,
             disabled: Anthropic::Beta::BetaCapabilitySupport::OrHash,
             enabled: Anthropic::Beta::BetaCapabilitySupport::OrHash
           ).returns(T.attached_class)
@@ -58,9 +77,18 @@ module Anthropic
           # Whether the model accepts thinking with type 'adaptive' (the model decides
           # whether and how much to think).
           adaptive:,
+          # Whether the model accepts thinking with type 'between_tools' (thinking turned
+          # off, and any short progress updates the model writes between tool calls come
+          # back as thinking blocks). False exactly when a request that sends it gets a 400
+          # from this model. A request that sends 'between_tools' can still be rejected for
+          # another reason, such as an effort level the model does not allow with thinking
+          # off.
+          between_tools:,
           # Whether the model accepts thinking with type 'disabled' (thinking turned off).
           # False exactly when a request that sends it gets a 400 from this model. True on a
-          # model that does not support thinking.
+          # model that does not support thinking. A request that sends 'disabled' can still
+          # be rejected for another reason, such as an effort level the model does not allow
+          # with thinking off.
           disabled:,
           # Whether the model accepts thinking with type 'enabled' (extended thinking with a
           # caller-set `budget_tokens`).
@@ -72,6 +100,7 @@ module Anthropic
           override.returns(
             {
               adaptive: Anthropic::Beta::BetaCapabilitySupport,
+              between_tools: Anthropic::Beta::BetaCapabilitySupport,
               disabled: Anthropic::Beta::BetaCapabilitySupport,
               enabled: Anthropic::Beta::BetaCapabilitySupport
             }

data/rbi/anthropic/models/beta/beta_usage.rbi

@@ -62,7 +62,6 @@ module Anthropic
         # (model sampling iterations, such as the turns of a server-side tool use loop),
         # this allows you to:
         #
-        # - Determine which iterations exceeded long context thresholds (>=200k tokens)
         # - Calculate the context window size from the last `message` entry
         # - Understand token accumulation across server-side tool use loops
         #
@@ -188,7 +187,6 @@ module Anthropic
           # (model sampling iterations, such as the turns of a server-side tool use loop),
           # this allows you to:
           #
-          # - Determine which iterations exceeded long context thresholds (>=200k tokens)
           # - Calculate the context window size from the last `message` entry
           # - Understand token accumulation across server-side tool use loops
           #

data/rbi/anthropic/models/beta/deployment_archive_params.rbi

@@ -19,7 +19,8 @@ module Anthropic
         sig { returns(String) }
         attr_accessor :deployment_id
 
-        # Optional header to specify the beta version(s) you want to use.
+        # This endpoint is in beta: requests must send `managed-agents-2026-04-01` in this
+        # header.
         sig do
           returns(
             T.nilable(
@@ -59,7 +60,8 @@ module Anthropic
         def self.new(
           # Unique identifier of the deployment to archive.
           deployment_id:,
-          # Optional header to specify the beta version(s) you want to use.
+          # This endpoint is in beta: requests must send `managed-agents-2026-04-01` in this
+          # header.
           betas: nil,
           # Optional header to select the Workspace for this request. The value is a
           # Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).

data/rbi/anthropic/models/beta/deployment_create_params.rbi

@@ -133,7 +133,8 @@ module Anthropic
         sig { params(vault_ids: T::Array[String]).void }
         attr_writer :vault_ids
 
-        # Optional header to specify the beta version(s) you want to use.
+        # This endpoint is in beta: requests must send `managed-agents-2026-04-01` in this
+        # header.
         sig do
           returns(
             T.nilable(
@@ -234,7 +235,8 @@ module Anthropic
           # Vault IDs for stored credentials the agent can use during sessions created from
           # this deployment. Maximum 50.
           vault_ids: nil,
-          # Optional header to specify the beta version(s) you want to use.
+          # This endpoint is in beta: requests must send `managed-agents-2026-04-01` in this
+          # header.
           betas: nil,
           # Optional header to select the Workspace for this request. The value is a
           # Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).