anthropic 1.45.0 → 1.47.0

data/lib/anthropic/models/beta/beta_webhook_session_status_terminated_event_data.rb

@@ -5,7 +5,7 @@ module Anthropic
     module Beta
       class BetaWebhookSessionStatusTerminatedEventData < Anthropic::Internal::Type::BaseModel
         # @!attribute id
-        #   ID of the resource that triggered the event.
+        #   ID of the session that triggered the event.
         #
         #   @return [String]
         required :id, String
@@ -26,7 +26,7 @@ module Anthropic
         required :workspace_id, String
 
         # @!method initialize(id:, organization_id:, workspace_id:, type: :"session.status_terminated")
-        #   @param id [String] ID of the resource that triggered the event.
+        #   @param id [String] ID of the session that triggered the event.
         #
         #   @param organization_id [String]
         #

data/lib/anthropic/models/beta/beta_webhook_session_thread_created_event_data.rb

@@ -5,7 +5,7 @@ module Anthropic
     module Beta
       class BetaWebhookSessionThreadCreatedEventData < Anthropic::Internal::Type::BaseModel
         # @!attribute id
-        #   ID of the resource that triggered the event.
+        #   ID of the session that triggered the event.
         #
         #   @return [String]
         required :id, String
@@ -26,7 +26,7 @@ module Anthropic
         required :workspace_id, String
 
         # @!method initialize(id:, organization_id:, workspace_id:, type: :"session.thread_created")
-        #   @param id [String] ID of the resource that triggered the event.
+        #   @param id [String] ID of the session that triggered the event.
         #
         #   @param organization_id [String]
         #

data/lib/anthropic/models/beta/beta_webhook_session_thread_idled_event_data.rb

@@ -5,7 +5,7 @@ module Anthropic
     module Beta
       class BetaWebhookSessionThreadIdledEventData < Anthropic::Internal::Type::BaseModel
         # @!attribute id
-        #   ID of the resource that triggered the event.
+        #   ID of the session that triggered the event.
         #
         #   @return [String]
         required :id, String
@@ -26,7 +26,7 @@ module Anthropic
         required :workspace_id, String
 
         # @!method initialize(id:, organization_id:, workspace_id:, type: :"session.thread_idled")
-        #   @param id [String] ID of the resource that triggered the event.
+        #   @param id [String] ID of the session that triggered the event.
         #
         #   @param organization_id [String]
         #

data/lib/anthropic/models/beta/beta_webhook_session_thread_terminated_event_data.rb

@@ -5,7 +5,7 @@ module Anthropic
     module Beta
       class BetaWebhookSessionThreadTerminatedEventData < Anthropic::Internal::Type::BaseModel
         # @!attribute id
-        #   ID of the resource that triggered the event.
+        #   ID of the session that triggered the event.
         #
         #   @return [String]
         required :id, String
@@ -26,7 +26,7 @@ module Anthropic
         required :workspace_id, String
 
         # @!method initialize(id:, organization_id:, workspace_id:, type: :"session.thread_terminated")
-        #   @param id [String] ID of the resource that triggered the event.
+        #   @param id [String] ID of the session that triggered the event.
         #
         #   @param organization_id [String]
         #

data/lib/anthropic/models/beta/beta_webhook_vault_archived_event_data.rb

@@ -5,7 +5,7 @@ module Anthropic
     module Beta
       class BetaWebhookVaultArchivedEventData < Anthropic::Internal::Type::BaseModel
         # @!attribute id
-        #   ID of the resource that triggered the event.
+        #   ID of the vault that triggered the event.
         #
         #   @return [String]
         required :id, String
@@ -26,7 +26,7 @@ module Anthropic
         required :workspace_id, String
 
         # @!method initialize(id:, organization_id:, workspace_id:, type: :"vault.archived")
-        #   @param id [String] ID of the resource that triggered the event.
+        #   @param id [String] ID of the vault that triggered the event.
         #
         #   @param organization_id [String]
         #

data/lib/anthropic/models/beta/beta_webhook_vault_created_event_data.rb

@@ -5,7 +5,7 @@ module Anthropic
     module Beta
       class BetaWebhookVaultCreatedEventData < Anthropic::Internal::Type::BaseModel
         # @!attribute id
-        #   ID of the resource that triggered the event.
+        #   ID of the vault that triggered the event.
         #
         #   @return [String]
         required :id, String
@@ -26,7 +26,7 @@ module Anthropic
         required :workspace_id, String
 
         # @!method initialize(id:, organization_id:, workspace_id:, type: :"vault.created")
-        #   @param id [String] ID of the resource that triggered the event.
+        #   @param id [String] ID of the vault that triggered the event.
         #
         #   @param organization_id [String]
         #

data/lib/anthropic/models/beta/beta_webhook_vault_credential_archived_event_data.rb

@@ -5,7 +5,7 @@ module Anthropic
     module Beta
       class BetaWebhookVaultCredentialArchivedEventData < Anthropic::Internal::Type::BaseModel
         # @!attribute id
-        #   ID of the resource that triggered the event.
+        #   ID of the vault credential that triggered the event.
         #
         #   @return [String]
         required :id, String
@@ -32,7 +32,7 @@ module Anthropic
         required :workspace_id, String
 
         # @!method initialize(id:, organization_id:, vault_id:, workspace_id:, type: :"vault_credential.archived")
-        #   @param id [String] ID of the resource that triggered the event.
+        #   @param id [String] ID of the vault credential that triggered the event.
         #
         #   @param organization_id [String]
         #

data/lib/anthropic/models/beta/beta_webhook_vault_credential_created_event_data.rb

@@ -5,7 +5,7 @@ module Anthropic
     module Beta
       class BetaWebhookVaultCredentialCreatedEventData < Anthropic::Internal::Type::BaseModel
         # @!attribute id
-        #   ID of the resource that triggered the event.
+        #   ID of the vault credential that triggered the event.
         #
         #   @return [String]
         required :id, String
@@ -32,7 +32,7 @@ module Anthropic
         required :workspace_id, String
 
         # @!method initialize(id:, organization_id:, vault_id:, workspace_id:, type: :"vault_credential.created")
-        #   @param id [String] ID of the resource that triggered the event.
+        #   @param id [String] ID of the vault credential that triggered the event.
         #
         #   @param organization_id [String]
         #

data/lib/anthropic/models/beta/beta_webhook_vault_credential_deleted_event_data.rb

@@ -5,7 +5,7 @@ module Anthropic
     module Beta
       class BetaWebhookVaultCredentialDeletedEventData < Anthropic::Internal::Type::BaseModel
         # @!attribute id
-        #   ID of the resource that triggered the event.
+        #   ID of the vault credential that triggered the event.
         #
         #   @return [String]
         required :id, String
@@ -32,7 +32,7 @@ module Anthropic
         required :workspace_id, String
 
         # @!method initialize(id:, organization_id:, vault_id:, workspace_id:, type: :"vault_credential.deleted")
-        #   @param id [String] ID of the resource that triggered the event.
+        #   @param id [String] ID of the vault credential that triggered the event.
         #
         #   @param organization_id [String]
         #

data/lib/anthropic/models/beta/beta_webhook_vault_credential_refresh_failed_event_data.rb

@@ -5,7 +5,7 @@ module Anthropic
     module Beta
       class BetaWebhookVaultCredentialRefreshFailedEventData < Anthropic::Internal::Type::BaseModel
         # @!attribute id
-        #   ID of the resource that triggered the event.
+        #   ID of the vault credential that triggered the event.
         #
         #   @return [String]
         required :id, String
@@ -32,7 +32,7 @@ module Anthropic
         required :workspace_id, String
 
         # @!method initialize(id:, organization_id:, vault_id:, workspace_id:, type: :"vault_credential.refresh_failed")
-        #   @param id [String] ID of the resource that triggered the event.
+        #   @param id [String] ID of the vault credential that triggered the event.
         #
         #   @param organization_id [String]
         #

data/lib/anthropic/models/beta/beta_webhook_vault_deleted_event_data.rb

@@ -5,7 +5,7 @@ module Anthropic
     module Beta
       class BetaWebhookVaultDeletedEventData < Anthropic::Internal::Type::BaseModel
         # @!attribute id
-        #   ID of the resource that triggered the event.
+        #   ID of the vault that triggered the event.
         #
         #   @return [String]
         required :id, String
@@ -26,7 +26,7 @@ module Anthropic
         required :workspace_id, String
 
         # @!method initialize(id:, organization_id:, workspace_id:, type: :"vault.deleted")
-        #   @param id [String] ID of the resource that triggered the event.
+        #   @param id [String] ID of the vault that triggered the event.
         #
         #   @param organization_id [String]
         #

data/lib/anthropic/models/beta/message_create_params.rb

@@ -134,6 +134,40 @@ module Anthropic
         #   @return [Anthropic::Models::Beta::BetaDiagnosticsParam, nil]
         optional :diagnostics, -> { Anthropic::Beta::BetaDiagnosticsParam }, nil?: true
 
+        # @!attribute fallback_credit_token
+        #   The `fallback_credit_token` from a prior refusal's `stop_details`.
+        #
+        #   When a preceding request was refused and returned a `fallback_credit_token`,
+        #   pass that code here on the retry to have the retry's cache-creation tokens for
+        #   the prefix that was warm on the refused model billed at the cache-read rate.
+        #   Must be redeemed by the same organization and workspace, with the same request
+        #   body (optionally extended by one appended `assistant` message whose content is
+        #   the partial text — with any trailing whitespace stripped from the final text
+        #   block — and paired server-tool blocks streamed before the refusal; the
+        #   appended-assistant form is not available for requests with `output_format` set
+        #   or forced `tool_choice`), on an eligible fallback model, on the same platform,
+        #   and within 5 minutes of the refusal; a mismatch is a 400. A token minted
+        #   mid-server-tool-loop whose partial content was continuable may only be redeemed
+        #   with the appended-assistant form — if an exact-body retry is rejected with a 400
+        #   saying the token must be redeemed by continuing the partial response, retry with
+        #   the appended-assistant form instead.
+        #
+        #   When the appended-assistant form is used on a model that otherwise disallows
+        #   assistant-turn prefill, this token also authorizes that one prefill.
+        #
+        #   @return [String, nil]
+        optional :fallback_credit_token, String, nil?: true
+
+        # @!attribute fallbacks
+        #   Opt-in server-side retry on one or more substitute models when the requested
+        #   model declines for policy reasons. Tried in order: if the first entry also
+        #   declines, the second is tried, and so on.
+        #
+        #   @return [Array<Anthropic::Models::Beta::BetaFallbackParam>, nil]
+        optional :fallbacks,
+                 -> { Anthropic::Internal::Type::ArrayOf[Anthropic::Beta::BetaFallbackParam] },
+                 nil?: true
+
         # @!attribute inference_geo
         #   Specifies the geographic region for inference processing. If not specified, the
         #   workspace's `default_inference_geo` is used.
@@ -374,7 +408,7 @@ module Anthropic
         #   @return [Array<String, Symbol, Anthropic::Models::AnthropicBeta>, nil]
         optional :betas, -> { Anthropic::Internal::Type::ArrayOf[union: Anthropic::AnthropicBeta] }
 
-        # @!method initialize(max_tokens:, messages:, model:, cache_control: nil, container: nil, context_management: nil, diagnostics: nil, inference_geo: nil, mcp_servers: nil, metadata: nil, output_config: nil, output_format: nil, service_tier: nil, speed: nil, stop_sequences: nil, system_: nil, temperature: nil, thinking: nil, tool_choice: nil, tools: nil, top_k: nil, top_p: nil, user_profile_id: nil, betas: nil, request_options: {})
+        # @!method initialize(max_tokens:, messages:, model:, cache_control: nil, container: nil, context_management: nil, diagnostics: nil, fallback_credit_token: nil, fallbacks: nil, inference_geo: nil, mcp_servers: nil, metadata: nil, output_config: nil, output_format: nil, service_tier: nil, speed: nil, stop_sequences: nil, system_: nil, temperature: nil, thinking: nil, tool_choice: nil, tools: nil, top_k: nil, top_p: nil, user_profile_id: nil, betas: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {Anthropic::Models::Beta::MessageCreateParams} for more details.
         #
@@ -392,6 +426,10 @@ module Anthropic
         #
         #   @param diagnostics [Anthropic::Models::Beta::BetaDiagnosticsParam, nil] Request-level diagnostics. Currently carries the previous response
         #
+        #   @param fallback_credit_token [String, nil] The `fallback_credit_token` from a prior refusal's `stop_details`.
+        #
+        #   @param fallbacks [Array<Anthropic::Models::Beta::BetaFallbackParam>, nil] Opt-in server-side retry on one or more substitute models when the requested mod
+        #
         #   @param inference_geo [String, nil] Specifies the geographic region for inference processing. If not specified, the
         #
         #   @param mcp_servers [Array<Anthropic::Models::Beta::BetaRequestMCPServerURLDefinition>] MCP servers to be utilized in this request

data/lib/anthropic/models/beta/messages/batch_create_params.rb

@@ -189,6 +189,40 @@ module Anthropic
               #   @return [Anthropic::Models::Beta::BetaDiagnosticsParam, nil]
               optional :diagnostics, -> { Anthropic::Beta::BetaDiagnosticsParam }, nil?: true
 
+              # @!attribute fallback_credit_token
+              #   The `fallback_credit_token` from a prior refusal's `stop_details`.
+              #
+              #   When a preceding request was refused and returned a `fallback_credit_token`,
+              #   pass that code here on the retry to have the retry's cache-creation tokens for
+              #   the prefix that was warm on the refused model billed at the cache-read rate.
+              #   Must be redeemed by the same organization and workspace, with the same request
+              #   body (optionally extended by one appended `assistant` message whose content is
+              #   the partial text — with any trailing whitespace stripped from the final text
+              #   block — and paired server-tool blocks streamed before the refusal; the
+              #   appended-assistant form is not available for requests with `output_format` set
+              #   or forced `tool_choice`), on an eligible fallback model, on the same platform,
+              #   and within 5 minutes of the refusal; a mismatch is a 400. A token minted
+              #   mid-server-tool-loop whose partial content was continuable may only be redeemed
+              #   with the appended-assistant form — if an exact-body retry is rejected with a 400
+              #   saying the token must be redeemed by continuing the partial response, retry with
+              #   the appended-assistant form instead.
+              #
+              #   When the appended-assistant form is used on a model that otherwise disallows
+              #   assistant-turn prefill, this token also authorizes that one prefill.
+              #
+              #   @return [String, nil]
+              optional :fallback_credit_token, String, nil?: true
+
+              # @!attribute fallbacks
+              #   Opt-in server-side retry on one or more substitute models when the requested
+              #   model declines for policy reasons. Tried in order: if the first entry also
+              #   declines, the second is tried, and so on.
+              #
+              #   @return [Array<Anthropic::Models::Beta::BetaFallbackParam>, nil]
+              optional :fallbacks,
+                       -> { Anthropic::Internal::Type::ArrayOf[Anthropic::Beta::BetaFallbackParam] },
+                       nil?: true
+
               # @!attribute inference_geo
               #   Specifies the geographic region for inference processing. If not specified, the
               #   workspace's `default_inference_geo` is used.
@@ -436,7 +470,7 @@ module Anthropic
               #   @return [String, nil]
               optional :user_profile_id, String, nil?: true
 
-              # @!method initialize(max_tokens:, messages:, model:, cache_control: nil, container: nil, context_management: nil, diagnostics: nil, inference_geo: nil, mcp_servers: nil, metadata: nil, output_config: nil, output_format: nil, service_tier: nil, speed: nil, stop_sequences: nil, stream: nil, system_: nil, temperature: nil, thinking: nil, tool_choice: nil, tools: nil, top_k: nil, top_p: nil, user_profile_id: nil)
+              # @!method initialize(max_tokens:, messages:, model:, cache_control: nil, container: nil, context_management: nil, diagnostics: nil, fallback_credit_token: nil, fallbacks: nil, inference_geo: nil, mcp_servers: nil, metadata: nil, output_config: nil, output_format: nil, service_tier: nil, speed: nil, stop_sequences: nil, stream: nil, system_: nil, temperature: nil, thinking: nil, tool_choice: nil, tools: nil, top_k: nil, top_p: nil, user_profile_id: nil)
               #   Some parameter documentations has been truncated, see
               #   {Anthropic::Models::Beta::Messages::BatchCreateParams::Request::Params} for more
               #   details.
@@ -460,6 +494,10 @@ module Anthropic
               #
               #   @param diagnostics [Anthropic::Models::Beta::BetaDiagnosticsParam, nil] Request-level diagnostics. Currently carries the previous response
               #
+              #   @param fallback_credit_token [String, nil] The `fallback_credit_token` from a prior refusal's `stop_details`.
+              #
+              #   @param fallbacks [Array<Anthropic::Models::Beta::BetaFallbackParam>, nil] Opt-in server-side retry on one or more substitute models when the requested mod
+              #
               #   @param inference_geo [String, nil] Specifies the geographic region for inference processing. If not specified, the
               #
               #   @param mcp_servers [Array<Anthropic::Models::Beta::BetaRequestMCPServerURLDefinition>] MCP servers to be utilized in this request

data/lib/anthropic/models/beta/session_list_params.rb

@@ -71,7 +71,7 @@ module Anthropic
         optional :order, enum: -> { Anthropic::Beta::SessionListParams::Order }
 
         # @!attribute page
-        #   Opaque pagination cursor from a previous response's next_page.
+        #   Opaque pagination cursor from a previous response.
         #
         #   @return [String, nil]
         optional :page, String
@@ -114,7 +114,7 @@ module Anthropic
         #
         #   @param order [Symbol, Anthropic::Models::Beta::SessionListParams::Order] Sort direction for results, ordered by created_at. Defaults to desc (newest firs
         #
-        #   @param page [String] Opaque pagination cursor from a previous response's next_page.
+        #   @param page [String] Opaque pagination cursor from a previous response.
         #
         #   @param statuses [Array<Symbol, Anthropic::Models::Beta::SessionListParams::Status>] Filter by session status. Repeat the parameter to match any of multiple statuses
         #

data/lib/anthropic/models/model.rb

@@ -9,6 +9,10 @@ module Anthropic
     module Model
       extend Anthropic::Internal::Type::Union
 
+      variant const: -> { Anthropic::Models::Model::CLAUDE_FABLE_5 }
+
+      variant const: -> { Anthropic::Models::Model::CLAUDE_MYTHOS_5 }
+
       variant const: -> { Anthropic::Models::Model::CLAUDE_OPUS_4_8 }
 
       variant const: -> { Anthropic::Models::Model::CLAUDE_OPUS_4_7 }
@@ -56,6 +60,12 @@ module Anthropic
 
       # @!group
 
+      # Next generation of intelligence for the hardest knowledge work and coding problems
+      CLAUDE_FABLE_5 = :"claude-fable-5"
+
+      # Most capable model for cybersecurity and biology research
+      CLAUDE_MYTHOS_5 = :"claude-mythos-5"
+
       # Frontier intelligence for long-running agents and coding
       CLAUDE_OPUS_4_8 = :"claude-opus-4-8"
 
@@ -63,6 +73,9 @@ module Anthropic
       CLAUDE_OPUS_4_7 = :"claude-opus-4-7"
 
       # New class of intelligence, strongest in coding and cybersecurity
+      # @deprecated Will reach end-of-life on June 30, 2026. Please migrate to claude-mythos-5.
+      # Visit https://docs.anthropic.com/en/docs/resources/model-deprecations for more
+      # information.
       CLAUDE_MYTHOS_PREVIEW = :"claude-mythos-preview"
 
       # Frontier intelligence for long-running agents and coding

data/lib/anthropic/models/refusal_stop_details.rb

@@ -47,6 +47,7 @@ module Anthropic
 
         CYBER = :cyber
         BIO = :bio
+        REASONING_EXTRACTION = :reasoning_extraction
 
         # @!method self.values
         #   @return [Array<Symbol>]

data/lib/anthropic/models/tool_search_tool_result_error_param.rb

@@ -13,8 +13,14 @@ module Anthropic
       #   @return [Symbol, :tool_search_tool_result_error]
       required :type, const: :tool_search_tool_result_error
 
-      # @!method initialize(error_code:, type: :tool_search_tool_result_error)
+      # @!attribute error_message
+      #
+      #   @return [String, nil]
+      optional :error_message, String, nil?: true
+
+      # @!method initialize(error_code:, error_message: nil, type: :tool_search_tool_result_error)
       #   @param error_code [Symbol, Anthropic::Models::ToolSearchToolResultErrorCode]
+      #   @param error_message [String, nil]
       #   @param type [Symbol, :tool_search_tool_result_error]
     end
   end

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

@@ -16,9 +16,9 @@ module Anthropic
         #
         # @param model [Symbol, String, Anthropic::Models::Beta::BetaManagedAgentsModel, Anthropic::Models::Beta::BetaManagedAgentsModelConfigParams] Body param: Model identifier. Accepts the [model string](https://platform.claude
         #
-        # @param name [String] Body param: Human-readable name for the agent. 1-256 characters.
+        # @param name [String] Body param: Human-readable name for the agent.
         #
-        # @param description [String, nil] Body param: Description of what the agent does. Up to 2048 characters.
+        # @param description [String, nil] Body param: Description of what the agent does.
         #
         # @param mcp_servers [Array<Anthropic::Models::Beta::BetaManagedAgentsURLMCPServerParams>] Body param: MCP servers this agent connects to. Maximum 20. Names must be unique
         #
@@ -26,9 +26,9 @@ module Anthropic
         #
         # @param multiagent [Anthropic::Models::Beta::BetaManagedAgentsMultiagentParams, nil] Body param: A coordinator topology: the session's primary thread orchestrates wo
         #
-        # @param skills [Array<Anthropic::Models::Beta::BetaManagedAgentsAnthropicSkillParams, Anthropic::Models::Beta::BetaManagedAgentsCustomSkillParams>] Body param: Skills available to the agent. Maximum 20.
+        # @param skills [Array<Anthropic::Models::Beta::BetaManagedAgentsAnthropicSkillParams, Anthropic::Models::Beta::BetaManagedAgentsCustomSkillParams>] Body param: Skills available to the agent.
         #
-        # @param system_ [String, nil] Body param: System prompt for the agent. Up to 100,000 characters.
+        # @param system_ [String, nil] Body param: System prompt for the agent.
         #
         # @param tools [Array<Anthropic::Models::Beta::BetaManagedAgentsAgentToolset20260401Params, Anthropic::Models::Beta::BetaManagedAgentsMCPToolsetParams, Anthropic::Models::Beta::BetaManagedAgentsCustomToolParams>] Body param: Tool configurations available to the agent. Maximum of 128 tools acr
         #
@@ -95,7 +95,7 @@ module Anthropic
         #
         # @param version [Integer] Body param: The agent's current version, used to prevent concurrent overwrites.
         #
-        # @param description [String, nil] Body param: Description. Up to 2048 characters. Omit to preserve; send empty str
+        # @param description [String, nil] Body param: Description. Omit to preserve; send empty string or null to clear.
         #
         # @param mcp_servers [Array<Anthropic::Models::Beta::BetaManagedAgentsURLMCPServerParams>, nil] Body param: MCP servers. Full replacement. Omit to preserve; send empty array or
         #
@@ -105,11 +105,11 @@ module Anthropic
         #
         # @param multiagent [Anthropic::Models::Beta::BetaManagedAgentsMultiagentParams, nil] Body param: A coordinator topology: the session's primary thread orchestrates wo
         #
-        # @param name [String] Body param: Human-readable name. 1-256 characters. Omit to preserve. Cannot be c
+        # @param name [String] Body param: Human-readable name. Must be non-empty. Omit to preserve. Cannot be
         #
         # @param skills [Array<Anthropic::Models::Beta::BetaManagedAgentsAnthropicSkillParams, Anthropic::Models::Beta::BetaManagedAgentsCustomSkillParams>, nil] Body param: Skills. Full replacement. Omit to preserve; send empty array or null
         #
-        # @param system_ [String, nil] Body param: System prompt. Up to 100,000 characters. Omit to preserve; send empt
+        # @param system_ [String, nil] Body param: System prompt. Omit to preserve; send empty string or null to clear.
         #
         # @param tools [Array<Anthropic::Models::Beta::BetaManagedAgentsAgentToolset20260401Params, Anthropic::Models::Beta::BetaManagedAgentsMCPToolsetParams, Anthropic::Models::Beta::BetaManagedAgentsCustomToolParams>, nil] Body param: Tool configurations available to the agent. Full replacement. Omit t
         #

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

@@ -40,7 +40,7 @@ module Anthropic
         # Learn more about the Messages API in our
         # [user guide](https://docs.claude.com/en/docs/initial-setup)
         #
-        # @overload create(max_tokens:, messages:, model:, cache_control: nil, container: nil, context_management: nil, diagnostics: nil, inference_geo: nil, mcp_servers: nil, metadata: nil, output_config: nil, output_format: nil, service_tier: nil, speed: nil, stop_sequences: nil, system_: nil, temperature: nil, thinking: nil, tool_choice: nil, tools: nil, top_k: nil, top_p: nil, user_profile_id: nil, betas: nil, request_options: {})
+        # @overload create(max_tokens:, messages:, model:, cache_control: nil, container: nil, context_management: nil, diagnostics: nil, fallback_credit_token: nil, fallbacks: nil, inference_geo: nil, mcp_servers: nil, metadata: nil, output_config: nil, output_format: nil, service_tier: nil, speed: nil, stop_sequences: nil, system_: nil, temperature: nil, thinking: nil, tool_choice: nil, tools: nil, top_k: nil, top_p: nil, user_profile_id: nil, betas: nil, request_options: {})
         #
         # @param max_tokens [Integer] Body param: The maximum number of tokens to generate before stopping.
         #
@@ -56,6 +56,10 @@ module Anthropic
         #
         # @param diagnostics [Anthropic::Models::Beta::BetaDiagnosticsParam, nil] Body param: Request-level diagnostics. Currently carries the previous response
         #
+        # @param fallback_credit_token [String, nil] Body param: The `fallback_credit_token` from a prior refusal's `stop_details`.
+        #
+        # @param fallbacks [Array<Anthropic::Models::Beta::BetaFallbackParam>, nil] Body param: Opt-in server-side retry on one or more substitute models when the r
+        #
         # @param inference_geo [String, nil] Body param: Specifies the geographic region for inference processing. If not spe
         #
         # @param mcp_servers [Array<Anthropic::Models::Beta::BetaRequestMCPServerURLDefinition>] Body param: MCP servers to be utilized in this request
@@ -150,7 +154,7 @@ module Anthropic
         # Learn more about the Messages API in our
         # [user guide](https://docs.claude.com/en/docs/initial-setup)
         #
-        # @overload stream_raw(max_tokens:, messages:, model:, cache_control: nil, container: nil, context_management: nil, diagnostics: nil, inference_geo: nil, mcp_servers: nil, metadata: nil, output_config: nil, output_format: nil, service_tier: nil, speed: nil, stop_sequences: nil, system_: nil, temperature: nil, thinking: nil, tool_choice: nil, tools: nil, top_k: nil, top_p: nil, user_profile_id: nil, betas: nil, request_options: {})
+        # @overload stream_raw(max_tokens:, messages:, model:, cache_control: nil, container: nil, context_management: nil, diagnostics: nil, fallback_credit_token: nil, fallbacks: nil, inference_geo: nil, mcp_servers: nil, metadata: nil, output_config: nil, output_format: nil, service_tier: nil, speed: nil, stop_sequences: nil, system_: nil, temperature: nil, thinking: nil, tool_choice: nil, tools: nil, top_k: nil, top_p: nil, user_profile_id: nil, betas: nil, request_options: {})
         #
         # @param max_tokens [Integer] Body param: The maximum number of tokens to generate before stopping.
         #
@@ -166,6 +170,10 @@ module Anthropic
         #
         # @param diagnostics [Anthropic::Models::Beta::BetaDiagnosticsParam, nil] Body param: Request-level diagnostics. Currently carries the previous response
         #
+        # @param fallback_credit_token [String, nil] Body param: The `fallback_credit_token` from a prior refusal's `stop_details`.
+        #
+        # @param fallbacks [Array<Anthropic::Models::Beta::BetaFallbackParam>, nil] Body param: Opt-in server-side retry on one or more substitute models when the r
+        #
         # @param inference_geo [String, nil] Body param: Specifies the geographic region for inference processing. If not spe
         #
         # @param mcp_servers [Array<Anthropic::Models::Beta::BetaRequestMCPServerURLDefinition>] Body param: MCP servers to be utilized in this request

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

@@ -140,7 +140,7 @@ module Anthropic
         #
         # @param order [Symbol, Anthropic::Models::Beta::SessionListParams::Order] Query param: Sort direction for results, ordered by created_at. Defaults to desc
         #
-        # @param page [String] Query param: Opaque pagination cursor from a previous response's next_page.
+        # @param page [String] Query param: Opaque pagination cursor from a previous response.
         #
         # @param statuses [Array<Symbol, Anthropic::Models::Beta::SessionListParams::Status>] Query param: Filter by session status. Repeat the parameter to match any of mult
         #

data/lib/anthropic/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Anthropic
-  VERSION = "1.45.0"
+  VERSION = "1.47.0"
 end

data/lib/anthropic.rb

@@ -205,6 +205,12 @@ require_relative "anthropic/models/beta/beta_encrypted_code_execution_result_blo
 require_relative "anthropic/models/beta/beta_encrypted_code_execution_result_block_param"
 require_relative "anthropic/models/beta/beta_environment"
 require_relative "anthropic/models/beta/beta_environment_delete_response"
+require_relative "anthropic/models/beta/beta_fallback_block"
+require_relative "anthropic/models/beta/beta_fallback_block_param"
+require_relative "anthropic/models/beta/beta_fallback_info"
+require_relative "anthropic/models/beta/beta_fallback_info_param"
+require_relative "anthropic/models/beta/beta_fallback_message_iteration_usage"
+require_relative "anthropic/models/beta/beta_fallback_param"
 require_relative "anthropic/models/beta/beta_file_document_source"
 require_relative "anthropic/models/beta/beta_file_image_source"
 require_relative "anthropic/models/beta/beta_file_scope"

data/rbi/anthropic/models/anthropic_beta.rbi

@@ -118,6 +118,16 @@ module Anthropic
           :"thinking-token-count-2026-05-13",
           Anthropic::AnthropicBeta::TaggedSymbol
         )
+      SERVER_SIDE_FALLBACK_2026_06_01 =
+        T.let(
+          :"server-side-fallback-2026-06-01",
+          Anthropic::AnthropicBeta::TaggedSymbol
+        )
+      FALLBACK_CREDIT_2026_06_01 =
+        T.let(
+          :"fallback-credit-2026-06-01",
+          Anthropic::AnthropicBeta::TaggedSymbol
+        )
     end
   end
 end

data/rbi/anthropic/models/beta/agent_create_params.rbi

@@ -30,11 +30,11 @@ module Anthropic
         end
         attr_accessor :model
 
-        # Human-readable name for the agent. 1-256 characters.
+        # Human-readable name for the agent.
         sig { returns(String) }
         attr_accessor :name
 
-        # Description of what the agent does. Up to 2048 characters.
+        # Description of what the agent does.
         sig { returns(T.nilable(String)) }
         attr_accessor :description
 
@@ -84,7 +84,7 @@ module Anthropic
         end
         attr_writer :multiagent
 
-        # Skills available to the agent. Maximum 20.
+        # Skills available to the agent.
         sig do
           returns(
             T.nilable(
@@ -112,7 +112,7 @@ module Anthropic
         end
         attr_writer :skills
 
-        # System prompt for the agent. Up to 100,000 characters.
+        # System prompt for the agent.
         sig { returns(T.nilable(String)) }
         attr_accessor :system_
 
@@ -209,9 +209,9 @@ module Anthropic
           # e.g. `claude-opus-4-6`, or a `model_config` object for additional configuration
           # control
           model:,
-          # Human-readable name for the agent. 1-256 characters.
+          # Human-readable name for the agent.
           name:,
-          # Description of what the agent does. Up to 2048 characters.
+          # Description of what the agent does.
           description: nil,
           # MCP servers this agent connects to. Maximum 20. Names must be unique within the
           # array.
@@ -222,9 +222,9 @@ module Anthropic
           # A coordinator topology: the session's primary thread orchestrates work by
           # spawning session threads, each running an agent drawn from the `agents` roster.
           multiagent: nil,
-          # Skills available to the agent. Maximum 20.
+          # Skills available to the agent.
           skills: nil,
-          # System prompt for the agent. Up to 100,000 characters.
+          # System prompt for the agent.
           system_: nil,
           # Tool configurations available to the agent. Maximum of 128 tools across all
           # toolsets allowed.