anthropic 2.2.0 → 2.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0fa0ec3e782fb7fc0c20e1c0a5e85c5c7b8b83891d1e42a3e604b22936a3e52a
-  data.tar.gz: 1ffcd5af0856f4677a04899b7c0e5c2b2703da055d14a58aa1042a710d89e466
+  metadata.gz: 966256d58040463f96bc820d6844ca2666e883f7d95fc5a0b4eabdcb38d492b3
+  data.tar.gz: 5a6d56ebd76d1ca114631890c6aed7bfdb404110fd551ce54f6f8382f31c67c9
 SHA512:
-  metadata.gz: 5dc4b3c320eae3c0aad79ec29f21235792820cc8d946ad64b849a81403be3cfeac29bddd270d5db09a6744aee60ada26dc0dd1a42129d584a35377a4389ab2af
-  data.tar.gz: 06a39cffd5d2f99b951bc98e34967972c17da8a04da48395ae2d426640b71ad36649b6053f704c53112c5050861d4825664dca1947d65af7df66f64f3d2832d0
+  metadata.gz: b2fba9a6ffa90d4f066db487200544e6e2c033baee8822e8602a44ecd5caf43d50bf5fe6334317f02bc99bf9484742ea321c1bed40976dd4abbc11eff431e5ed
+  data.tar.gz: 3f34e914b18b97faff00e5137fa33e86cc7d31b511f0e88ac3f0c0859b3f19200bb3ce36a138bdd47a0f26ed86b4121051d6ad82e86a6aeb9b3f735b66665496

data/CHANGELOG.md

@@ -1,5 +1,75 @@
 # Changelog
 
+## [2.4.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v2.3.0...v2.4.0) (2026-11-02)
+
+### Features
+
+* **api:** add GA methods for analytics, spend limits and RBAC
+* **api:** add named beta types for unified metrics and RBAC delete responses
+* **api:** add shared analytics order and increase request actor types
+* **api:** add tool_use_limit_reached_error and compaction_limit_reached_error session error types
+* **api:** add types for analytics group_by and spend limit period filters
+* **api:** add user_profile_id to External Keys and Workspaces
+
+
+### Bug Fixes
+
+* **api:** make spend_limit nullable in the spend limit increase request approve response
+* **api:** require always-sent analytics fields and drop the unused project product field
+* **client:** raise the typed API error, not `TypeError`, when the `error` in an error response is not a hash
+
+
+### Chores
+
+* **ci:** remove unused build upload steps
+* **docs:** clarify the Slack channel id description
+* **docs:** clarify what disabling the Compliance API stops
+* **docs:** clarify what the capability_access_all role action grants
+* **docs:** link Dreams model fields to the supported models section
+* **docs:** update example user ID in Admin API examples
+* **internal:** add a section for each repository's own review rules
+
+### Documentation
+
+* add a description to the AnthropicBeta type
+* correct the error class documented for next_page and fix typos
+* **examples:** use current model IDs
+* **readme:** point to the docs site for documentation
+
+## [2.3.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v2.2.0...v2.3.0) (2026-10-23)
+
+### Features
+
+* **api:** add Claude Tag endpoints for Claude Enterprise organizations
+* **google-cloud:** add user profiles and send them to the organization endpoint; `user_profiles` calls used to raise `NotImplementedError`
+
+
+### Bug Fixes
+
+* **bedrock:** `BedrockClient` with an API key takes its region from `AWS_REGION`, then `AWS_DEFAULT_REGION`, when `aws_region` is not passed
+* **client:** link the long-request error message to the SDK documentation
+
+
+### Chores
+
+* **client:** stop sending query params hardcoded in endpoint paths
+* **docs:** improve the descriptions of the code execution tool and its encrypted results
+* **docs:** reword work queue, skill and external key descriptions
+* **docs:** update descriptions of the per-user usage and cost reports
+* **internal:** carry endpoint path query params to the request layer
+* **internal:** check the repository by owner and public name in workflows
+* **internal:** lint against mixing a module into a class from outside
+* **internal:** read the beta route qualifier instead of the beta=true query
+* **internal:** remove preview build upload from CI
+* **internal:** stop expecting the beta query param in tests
+* **internal:** test that rbi and sig declare every public method
+
+
+### Documentation
+
+* **google-cloud:** update the product name
+* update the README and the example request
+
 ## [2.2.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v2.1.0...v2.2.0) (2026-10-23)
 
 ### Features

data/README.md

@@ -15,7 +15,7 @@ Add to your application's Gemfile:
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "anthropic", "~> 2.2.0"
+gem "anthropic", "~> 2.4.0"
 ```
 
 <!-- x-release-please-end -->
@@ -33,7 +33,7 @@ anthropic = Anthropic::Client.new(
 message = anthropic.messages.create(
   max_tokens: 1024,
   messages: [{role: "user", content: "Hello, Claude"}],
-  model: "claude-opus-5-5"
+  model: Anthropic::Model::CLAUDE_OPUS_5_5
 )
 
 puts(message.content)
@@ -44,47 +44,6 @@ puts(message.content)
 
 Ruby 3.2.0+
 
-## OpenTelemetry
-
-Spans are on by default.
-Register a tracer provider with OpenTelemetry, for example with `OpenTelemetry::SDK.configure`, and every client reports each API call as a span.
-No client option is needed.
-Each request also carries the trace context in the headers that the registered propagator writes, such as `traceparent`, with or without a tracer provider.
-
-The `open_telemetry` client option changes the default:
-
-- `open_telemetry: {tracer_provider: provider}` uses `provider` instead of the registered tracer provider.
-- `open_telemetry: {propagation: false}` sends no trace context headers, such as `traceparent` and `baggage`, with the client's requests.
-  It is for an application whose HTTP client instrumentation already sends them, so that a request does not carry them twice. The spans are unaffected.
-- `open_telemetry: false` turns the spans and the trace context headers off. It is short for `{traces: false}`, which is short for `{traces: {enabled: false}}`.
-- `open_telemetry: {traces: {content_mode: :content}}` adds the messages, stop sequences, and tool calls to the spans.
-  It also adds `url.query` and `url.full` to the span of a request whose query has an `email`, `path_prefix` or `expected_content_sha256` parameter, which has neither otherwise.
-- `open_telemetry: {traces: {max_content_bytes: 65_536}}` sets the most bytes of content that one span holds, in place of 0.75 MB.
-  A span whose content is cut to fit has `anthropic.content.truncated`.
-
-`open_telemetry: true` is short for `{traces: true}`, and `traces: true` is short for `traces: {enabled: true}`.
-With `enabled: false`, the other keys of `traces` are unused.
-What the option leaves unset has its default.
-
-A client that is given no `open_telemetry` option reads the environment when it is made: `ANTHROPIC_OPEN_TELEMETRY=false` turns its spans and the trace context headers off, `ANTHROPIC_OPEN_TELEMETRY_PROPAGATION=false` turns only the headers off, `ANTHROPIC_OPEN_TELEMETRY_TRACES_CONTENT_MODE=content` adds the content, and `ANTHROPIC_OPEN_TELEMETRY_TRACES_MAX_CONTENT_BYTES=65536` sets the most bytes.
-A client that is given the option, even `true` or `{}`, reads none of these variables: `open_telemetry: true` turns the spans on whatever `ANTHROPIC_OPEN_TELEMETRY` says.
-
-The keys of the option, and of its `traces`, can be Symbols or Strings, and a key that the option does not have raises `ArgumentError`.
-So does a `propagation` other than `true` or `false`, a `content_mode` other than `:metadata_only` or `:content`, and a `max_content_bytes` that is not an Integer of 1 or more.
-An environment variable with such a value is ignored.
-
-One request option sets `gen_ai.conversation.id` on the span of a call:
-
-```ruby
-anthropic.messages.create(**params, request_options: {open_telemetry: {conversation_id: id}})
-```
-
-`conversation_id` is the only key of the request option, and any other key raises `ArgumentError`: the tracer provider, `propagation` and the `traces` settings belong to the client.
-Without it, the span of a request to a Session thread, such as `beta.sessions.threads.retrieve`, has the thread's ID as its `gen_ai.conversation.id`.
-
-In the content mode, the content of a streamed response comes from the message that `messages.stream` accumulates.
-The span of a `messages.stream_raw` call has the request's content only.
-
 ## Contributing
 
 See [CONTRIBUTING.md](./CONTRIBUTING.md).

data/lib/anthropic/client.rb

@@ -118,7 +118,7 @@ module Anthropic
       if expected_time > default_time || (max_nonstreaming_tokens && max_tokens > max_nonstreaming_tokens)
         raise ArgumentError.new(
           "Streaming is required for operations that may take longer than 10 minutes. " \
-          "See https://github.com/anthropics/anthropic-sdk-ruby#long-requests for more details"
+          "See https://platform.claude.com/docs/en/cli-sdks-libraries/sdks/ruby#streaming for more details"
         )
       end
 

data/lib/anthropic/errors.rb

@@ -156,7 +156,7 @@ module Anthropic
       #
       # @return [self]
       def self.for(url:, status:, headers:, body:, request:, response:, message: nil)
-        error_type = body.dig(:error, :type) if body.is_a?(Hash)
+        error_type = Anthropic::Internal::Util.dig(body, [:error, :type])
         error_type = error_type.to_sym if error_type.is_a?(String)
 
         kwargs =

data/lib/anthropic/helpers/bedrock/client.rb

@@ -28,6 +28,7 @@ module Anthropic
         #
         # @param aws_region [String, nil] Enforce the AWS Region to use. If unset, the region is set according to the
         #   AWS SDK's default resolution order, described at https://github.com/aws/aws-sdk-ruby?tab=readme-ov-file#configuration
+        #   With an API key, defaults to `ENV["AWS_REGION"]`, then `ENV["AWS_DEFAULT_REGION"]`.
         #
         # @param aws_access_key [String, nil]  Optional AWS access key to use for authentication. Overrides profile and credential provider chain
         #
@@ -118,7 +119,7 @@ module Anthropic
               credentials: @aws_credentials
             )
           else
-            @aws_region = aws_region
+            @aws_region = aws_region || env_lookup("AWS_REGION", "AWS_DEFAULT_REGION")
           end
 
           base_url = ENV["ANTHROPIC_BEDROCK_BASE_URL"] if base_url.to_s.empty?
@@ -309,14 +310,16 @@ module Anthropic
         private def validate_bedrock_request!(request_components)
           # Id-parameterized routes pass `path` as an Array whose first element
           # is the format string (e.g. `["v1/messages/batches/%1$s", id]`).
-          case Array(request_components[:path]).first.to_s
+          path = Array(request_components[:path]).first.to_s
+          beta = request_components.dig(:qualifiers, :beta) == "true" || path.include?("?beta=true")
+          case path
           in %r{^v1/messages/batches}
             message = "The Batch API is not supported in Bedrock yet"
             raise NotImplementedError.new(message)
           in %r{v1/messages/count_tokens}
             message = "Token counting is not supported in Bedrock yet"
             raise NotImplementedError.new(message)
-          in %r{v1/models\?beta=true}
+          in %r{v1/models(\?|\z)} if beta
             # rubocop:disable Layout/LineLength
             message = "Please instead use https://docs.anthropic.com/en/api/claude-on-amazon-bedrock#list-available-models to list available models on Bedrock."
             # rubocop:enable Layout/LineLength

data/lib/anthropic/helpers/google_cloud/client.rb

@@ -3,14 +3,14 @@
 module Anthropic
   module Helpers
     module GoogleCloud
-      # Client for Claude Platform on Google Cloud — the first-party Anthropic
-      # API served through the Google Cloud gateway.
+      # Client for Claude Models on Google Cloud (Anthropic managed) — the
+      # first-party Anthropic API served through the Google Cloud gateway.
       #
       # This is distinct from {Anthropic::VertexClient}, which targets the
       # `:rawPredict` publisher-model API (publisher model IDs, messages
       # only). This client speaks the full first-party Anthropic API: requests
       # pass through the gateway unchanged — standard `/v1/*` paths, standard
-      # model names. The gateway does not serve the User Profiles API.
+      # model names.
       class Client < Anthropic::Client
         # OAuth2 scope required to call the gateway.
         SCOPE = "https://www.googleapis.com/auth/cloud-platform"
@@ -26,9 +26,9 @@ module Anthropic
         # served from a base with no workspace in it.
         ORGANIZATION_URL_TEMPLATE = "#{LOCATION_URL_TEMPLATE}/claudeOrganization/invoke".freeze
 
-        ORGANIZATION_PATH_PREFIX = "/v1/organizations/"
+        ORGANIZATION_PATH_PATTERN = %r{\A/v1/(?:organizations/|user_profiles(?:/|\z))}
 
-        private_constant :LOCATION_URL_TEMPLATE, :ORGANIZATION_PATH_PREFIX
+        private_constant :LOCATION_URL_TEMPLATE, :ORGANIZATION_PATH_PATTERN
 
         # @return [String, nil]
         attr_reader :project
@@ -63,7 +63,8 @@ module Anthropic
         # @param workspace_id [String, nil] Defaults to
         #   `ENV["ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID"]`. Required when the base
         #   URL is derived, except for organization-level routes
-        #   (`/v1/organizations/`), which need no workspace ID.
+        #   (`/v1/organizations/` and `/v1/user_profiles`), which need no
+        #   workspace ID.
         #
         # @param base_url [String, nil] Override the gateway base URL for every
         #   route. Defaults to `ENV["ANTHROPIC_GOOGLE_CLOUD_BASE_URL"]`, otherwise
@@ -154,10 +155,7 @@ module Anthropic
           # No first-party credential is ever passed up, and
           # {#resolve_default_credentials?} keeps the parent from discovering
           # one; `base_url` is always resolved by this point, so the parent's
-          # `ANTHROPIC_BASE_URL` fallback never applies. The parent wires up
-          # every resource; {#user_profiles} withholds the one the gateway does
-          # not serve, and {#build_request} refuses the user profile routes
-          # however the resource is reached.
+          # `ANTHROPIC_BASE_URL` fallback never applies.
           super(
             base_url: base_url,
             timeout: timeout,
@@ -175,13 +173,6 @@ module Anthropic
         # @see Anthropic::Client#resolve_default_credentials?
         private def resolve_default_credentials? = false
 
-        # User profiles are not supported on the Google Cloud gateway.
-        #
-        # @raise [NotImplementedError]
-        def user_profiles
-          raise NotImplementedError.new("User profiles are not supported on the Google Cloud gateway.")
-        end
-
         # @api private
         #
         # @param req [Hash{Symbol=>Object}] .
@@ -219,15 +210,8 @@ module Anthropic
         #   @option opts [Float, nil] :timeout
         #
         # @raise [ArgumentError]
-        # @raise [NotImplementedError]
         # @return [Hash{Symbol=>Object}]
         private def build_request(req, opts)
-          # Id-parameterized routes pass `path` as an Array whose first element
-          # is the format string (e.g. `["v1/user_profiles/%1$s", id]`).
-          if Array(req[:path]).first.to_s.start_with?("v1/user_profiles")
-            raise NotImplementedError.new("User profiles are not supported on the Google Cloud gateway.")
-          end
-
           request = super
           return request if @organization_base_url.nil?
 
@@ -238,7 +222,7 @@ module Anthropic
           return request unless under_base_url
 
           path = url.path.delete_prefix(base_url.path)
-          if path.start_with?(ORGANIZATION_PATH_PREFIX)
+          if path.match?(ORGANIZATION_PATH_PATTERN)
             url = url.dup
             url.path = "#{@organization_base_url.path}#{path}"
             {**request, url: url}

data/lib/anthropic/helpers/refusal_fallback.rb

@@ -225,8 +225,7 @@ module Anthropic
       return false unless req.method == :post
       return false unless req.body.is_a?(Hash)
       return false unless req.url.path&.end_with?("/v1/messages")
-      query = URI.decode_www_form(req.url.query.to_s).to_h
-      query["beta"] == "true"
+      req.metadata.dig(:qualifiers, :beta) == "true"
     end
 
     # @return [Anthropic::APIRequest] `req` with `@betas` appended to the

data/lib/anthropic/helpers/stainless_helper_header.rb

@@ -24,8 +24,9 @@ module Anthropic
         # The {HEADER} value to set after appending `value` to whatever is
         # already present in `headers` — existing tags keep their position, the
         # new tag goes at the end, duplicates are dropped, joined as one
-        # comma-separated string. The backend logs the header as one opaque
-        # string, so a second header line or a clobbered value loses data.
+        # comma-separated string. The new tag is merged into the existing value
+        # rather than replacing it, because a second header line or a clobbered
+        # value loses data.
         #
         # @param headers [Hash{String => String}]
         # @param value [String]

data/lib/anthropic/helpers/threads/beta_message_thread.rb

@@ -525,8 +525,7 @@ module Anthropic
         # Whether the turn should be sent again because the API rejected its `thread` in a way the
         # thread has now adjusted for.
         def recovers_from?(error)
-          body = error.body
-          code = body.is_a?(Hash) ? body.dig(:error, :details, :error_code) : nil
+          code = Anthropic::Internal::Util.dig(error.body, [:error, :details, :error_code])
           unsupported = code == UNSUPPORTED_REQUEST_ERROR_CODE
           not_found = code == NOT_FOUND_ERROR_CODE
           # The API may be unable to store a conversation whose new thread it does not hold either.

data/lib/anthropic/internal/bidirectional_page_cursor.rb

@@ -30,7 +30,7 @@ module Anthropic
         !next_page_.to_s.empty?
       end
 
-      # @raise [Anthropic::HTTP::Error]
+      # @raise [Anthropic::Errors::APIError]
       # @return [self]
       def next_page
         unless next_page?

data/lib/anthropic/internal/page.rb

@@ -35,7 +35,7 @@ module Anthropic
         !data.to_a.empty? && (@req.dig(:query, :before_id) ? !first_id.to_s.empty? : !last_id.to_s.empty?)
       end
 
-      # @raise [Anthropic::HTTP::Error]
+      # @raise [Anthropic::Errors::APIError]
       # @return [self]
       def next_page
         unless next_page?

data/lib/anthropic/internal/page_cursor.rb

@@ -27,7 +27,7 @@ module Anthropic
         !next_page_.to_s.empty?
       end
 
-      # @raise [Anthropic::HTTP::Error]
+      # @raise [Anthropic::Errors::APIError]
       # @return [self]
       def next_page
         unless next_page?

data/lib/anthropic/internal/report_page_cursor.rb

@@ -35,7 +35,7 @@ module Anthropic
         !next_page_.to_s.empty?
       end
 
-      # @raise [Anthropic::HTTP::Error]
+      # @raise [Anthropic::Errors::APIError]
       # @return [self]
       def next_page
         unless next_page?

data/lib/anthropic/internal/token_page.rb

@@ -32,7 +32,7 @@ module Anthropic
         !data.to_a.empty? && !next_page_.to_s.empty?
       end
 
-      # @raise [Anthropic::HTTP::Error]
+      # @raise [Anthropic::Errors::APIError]
       # @return [self]
       def next_page
         unless next_page?

data/lib/anthropic/internal/tracing.rb

@@ -180,6 +180,34 @@ module Anthropic
         ORGANIZATION_RATE_LIMITS_LIST = "anthropic.organization.rate_limits.list"
         ORGANIZATION_COMPLIANCE_SETTINGS_RETRIEVE = "anthropic.organization.compliance_settings.retrieve"
         ORGANIZATION_COMPLIANCE_SETTINGS_UPDATE = "anthropic.organization.compliance_settings.update"
+        ORGANIZATION_ANALYTICS_SUMMARIES_LIST = "anthropic.organization.analytics.summaries.list"
+        ORGANIZATION_ANALYTICS_USERS_LIST = "anthropic.organization.analytics.users.list"
+        ORGANIZATION_ANALYTICS_APPS_CHAT_PROJECTS_LIST =
+          "anthropic.organization.analytics.apps.chat.projects.list"
+        ORGANIZATION_ANALYTICS_CONNECTORS_LIST = "anthropic.organization.analytics.connectors.list"
+        ORGANIZATION_ANALYTICS_PLUGINS_LIST = "anthropic.organization.analytics.plugins.list"
+        ORGANIZATION_ANALYTICS_SKILLS_LIST = "anthropic.organization.analytics.skills.list"
+        ORGANIZATION_ANALYTICS_ARTIFACTS_LIST = "anthropic.organization.analytics.artifacts.list"
+        ORGANIZATION_SPEND_LIMITS_EFFECTIVE_LIST = "anthropic.organization.spend_limits.effective.list"
+        ORGANIZATION_SPEND_LIMITS_INCREASE_REQUESTS_RETRIEVE =
+          "anthropic.organization.spend_limits.increase_requests.retrieve"
+        ORGANIZATION_SPEND_LIMITS_INCREASE_REQUESTS_LIST =
+          "anthropic.organization.spend_limits.increase_requests.list"
+        ORGANIZATION_SPEND_LIMITS_INCREASE_REQUESTS_APPROVE =
+          "anthropic.organization.spend_limits.increase_requests.approve"
+        ORGANIZATION_SPEND_LIMITS_INCREASE_REQUESTS_DENY =
+          "anthropic.organization.spend_limits.increase_requests.deny"
+        ORGANIZATION_RBAC_GROUPS_CREATE = "anthropic.organization.rbac_groups.create"
+        ORGANIZATION_RBAC_GROUPS_RETRIEVE = "anthropic.organization.rbac_groups.retrieve"
+        ORGANIZATION_RBAC_GROUPS_UPDATE = "anthropic.organization.rbac_groups.update"
+        ORGANIZATION_RBAC_GROUPS_LIST = "anthropic.organization.rbac_groups.list"
+        ORGANIZATION_RBAC_GROUPS_DELETE = "anthropic.organization.rbac_groups.delete"
+        ORGANIZATION_RBAC_GROUPS_MEMBERS_LIST = "anthropic.organization.rbac_groups.members.list"
+        ORGANIZATION_RBAC_GROUPS_MEMBERS_ADD = "anthropic.organization.rbac_groups.members.add"
+        ORGANIZATION_RBAC_GROUPS_MEMBERS_REMOVE = "anthropic.organization.rbac_groups.members.remove"
+        ORGANIZATION_RBAC_ROLES_RETRIEVE = "anthropic.organization.rbac_roles.retrieve"
+        ORGANIZATION_RBAC_ROLES_LIST = "anthropic.organization.rbac_roles.list"
+        ORGANIZATION_RBAC_ROLES_PERMISSIONS_LIST = "anthropic.organization.rbac_roles.permissions.list"
         AGENTS_CREATE = "anthropic.agents.create"
         AGENTS_RETRIEVE = "anthropic.agents.retrieve"
         AGENTS_UPDATE = "anthropic.agents.update"
@@ -273,14 +301,6 @@ module Anthropic
         TUNNELS_CERTIFICATES_RETRIEVE = "anthropic.tunnels.certificates.retrieve"
         TUNNELS_CERTIFICATES_LIST = "anthropic.tunnels.certificates.list"
         TUNNELS_CERTIFICATES_ARCHIVE = "anthropic.tunnels.certificates.archive"
-        ORGANIZATION_ANALYTICS_SUMMARIES_LIST = "anthropic.organization.analytics.summaries.list"
-        ORGANIZATION_ANALYTICS_USERS_LIST = "anthropic.organization.analytics.users.list"
-        ORGANIZATION_ANALYTICS_APPS_CHAT_PROJECTS_LIST =
-          "anthropic.organization.analytics.apps.chat.projects.list"
-        ORGANIZATION_ANALYTICS_CONNECTORS_LIST = "anthropic.organization.analytics.connectors.list"
-        ORGANIZATION_ANALYTICS_PLUGINS_LIST = "anthropic.organization.analytics.plugins.list"
-        ORGANIZATION_ANALYTICS_SKILLS_LIST = "anthropic.organization.analytics.skills.list"
-        ORGANIZATION_ANALYTICS_ARTIFACTS_LIST = "anthropic.organization.analytics.artifacts.list"
         ORGANIZATION_ANALYTICS_USAGE_LIST = "anthropic.organization.analytics.usage.list"
         ORGANIZATION_ANALYTICS_COST_LIST = "anthropic.organization.analytics.cost.list"
         ORGANIZATION_ANALYTICS_USAGE_REPORT_LIST = "anthropic.organization.analytics.usage_report.list"
@@ -291,26 +311,6 @@ module Anthropic
         ORGANIZATION_SPEND_LIMITS_LIST = "anthropic.organization.spend_limits.list"
         ORGANIZATION_SPEND_LIMITS_DELETE = "anthropic.organization.spend_limits.delete"
         ORGANIZATION_SPEND_LIMITS_SET = "anthropic.organization.spend_limits.set"
-        ORGANIZATION_SPEND_LIMITS_EFFECTIVE_LIST = "anthropic.organization.spend_limits.effective.list"
-        ORGANIZATION_SPEND_LIMITS_INCREASE_REQUESTS_RETRIEVE =
-          "anthropic.organization.spend_limits.increase_requests.retrieve"
-        ORGANIZATION_SPEND_LIMITS_INCREASE_REQUESTS_LIST =
-          "anthropic.organization.spend_limits.increase_requests.list"
-        ORGANIZATION_SPEND_LIMITS_INCREASE_REQUESTS_APPROVE =
-          "anthropic.organization.spend_limits.increase_requests.approve"
-        ORGANIZATION_SPEND_LIMITS_INCREASE_REQUESTS_DENY =
-          "anthropic.organization.spend_limits.increase_requests.deny"
-        ORGANIZATION_RBAC_GROUPS_CREATE = "anthropic.organization.rbac_groups.create"
-        ORGANIZATION_RBAC_GROUPS_RETRIEVE = "anthropic.organization.rbac_groups.retrieve"
-        ORGANIZATION_RBAC_GROUPS_UPDATE = "anthropic.organization.rbac_groups.update"
-        ORGANIZATION_RBAC_GROUPS_LIST = "anthropic.organization.rbac_groups.list"
-        ORGANIZATION_RBAC_GROUPS_DELETE = "anthropic.organization.rbac_groups.delete"
-        ORGANIZATION_RBAC_GROUPS_MEMBERS_LIST = "anthropic.organization.rbac_groups.members.list"
-        ORGANIZATION_RBAC_GROUPS_MEMBERS_ADD = "anthropic.organization.rbac_groups.members.add"
-        ORGANIZATION_RBAC_GROUPS_MEMBERS_REMOVE = "anthropic.organization.rbac_groups.members.remove"
-        ORGANIZATION_RBAC_ROLES_RETRIEVE = "anthropic.organization.rbac_roles.retrieve"
-        ORGANIZATION_RBAC_ROLES_LIST = "anthropic.organization.rbac_roles.list"
-        ORGANIZATION_RBAC_ROLES_PERMISSIONS_LIST = "anthropic.organization.rbac_roles.permissions.list"
         ORGANIZATION_PLUGINS_CREATE = "anthropic.organization.plugins.create"
         ORGANIZATION_PLUGINS_RETRIEVE = "anthropic.organization.plugins.retrieve"
         ORGANIZATION_PLUGINS_UPDATE = "anthropic.organization.plugins.update"
@@ -353,6 +353,26 @@ module Anthropic
         ORGANIZATION_WEBHOOKS_DELETE = "anthropic.organization.webhooks.delete"
         ORGANIZATION_WEBHOOKS_REGENERATE_SIGNING_SECRET =
           "anthropic.organization.webhooks.regenerate_signing_secret"
+        ORGANIZATION_CLAUDE_TAG_SLACK_CHANNELS_CREATE = "anthropic.organization.claude_tag.slack_channels.create"
+        ORGANIZATION_CLAUDE_TAG_SLACK_CHANNELS_RETRIEVE =
+          "anthropic.organization.claude_tag.slack_channels.retrieve"
+        ORGANIZATION_CLAUDE_TAG_SLACK_CHANNELS_UPDATE = "anthropic.organization.claude_tag.slack_channels.update"
+        ORGANIZATION_CLAUDE_TAG_SLACK_CHANNELS_LIST = "anthropic.organization.claude_tag.slack_channels.list"
+        ORGANIZATION_CLAUDE_TAG_SLACK_CHANNELS_DELETE = "anthropic.organization.claude_tag.slack_channels.delete"
+        ORGANIZATION_CLAUDE_TAG_SLACK_WORKSPACES_RETRIEVE =
+          "anthropic.organization.claude_tag.slack_workspaces.retrieve"
+        ORGANIZATION_CLAUDE_TAG_SLACK_WORKSPACES_UPDATE =
+          "anthropic.organization.claude_tag.slack_workspaces.update"
+        ORGANIZATION_CLAUDE_TAG_SLACK_WORKSPACES_LIST = "anthropic.organization.claude_tag.slack_workspaces.list"
+        ORGANIZATION_CLAUDE_TAG_BUNDLES_RETRIEVE = "anthropic.organization.claude_tag.bundles.retrieve"
+        ORGANIZATION_CLAUDE_TAG_BUNDLES_LIST = "anthropic.organization.claude_tag.bundles.list"
+        ORGANIZATION_CLAUDE_TAG_BUNDLES_TARGETS_CREATE =
+          "anthropic.organization.claude_tag.bundles.targets.create"
+        ORGANIZATION_CLAUDE_TAG_BUNDLES_TARGETS_RETRIEVE =
+          "anthropic.organization.claude_tag.bundles.targets.retrieve"
+        ORGANIZATION_CLAUDE_TAG_BUNDLES_TARGETS_LIST = "anthropic.organization.claude_tag.bundles.targets.list"
+        ORGANIZATION_CLAUDE_TAG_BUNDLES_TARGETS_DELETE =
+          "anthropic.organization.claude_tag.bundles.targets.delete"
       end
 
       # @type [Hash{String=>String}]

data/lib/anthropic/internal/transport/base_client.rb

@@ -41,6 +41,7 @@ module Anthropic
               :page,
               :stream,
               :model,
+              :qualifiers,
               :span_name,
               :span_attributes,
               :span_created_id,
@@ -100,6 +101,8 @@ module Anthropic
           #
           #   @option request [Float] :timeout
           #
+          #   @option request [Hash{Symbol=>String}, nil] :qualifiers
+          #
           #   @option request [Array<String>, nil] :span_query
           #
           #   @option request [Array<String>, nil] :span_content_query
@@ -129,7 +132,7 @@ module Anthropic
 
             case [url.scheme, location.scheme]
             in ["https", "http"]
-              message = "Tried to redirect to a insecure URL"
+              message = "Tried to redirect to an insecure URL"
               raise Anthropic::Errors::APIConnectionError.new(
                 url: url,
                 response: response_headers,
@@ -335,6 +338,9 @@ module Anthropic
         #
         #   @option req [Anthropic::Internal::Type::Converter, Class, nil] :model
         #
+        #   @option req [Hash{Symbol=>String}, nil] :qualifiers internal: the query pairs that tell the operation apart from the others with its
+        #   path in the OpenAPI document
+        #
         #   @option req [String, nil] :span_name
         #
         #   @option req [Hash{String=>Object}, nil] :span_attributes
@@ -428,6 +434,7 @@ module Anthropic
             body: body,
             max_retries: opts.fetch(:max_retries, @max_retries),
             timeout: timeout,
+            qualifiers: req[:qualifiers],
             user_header_keys: user_header_keys,
             # For paginated requests `model` is the page's *item* type, not the
             # response envelope's — middleware `parse` falls back to the raw
@@ -439,7 +446,7 @@ module Anthropic
             span_content_query: req[:span_content_query],
             options: opts.except(:middleware),
             middleware: request_middleware,
-            metadata: {}
+            metadata: {qualifiers: req[:qualifiers]}.compact
           }
         end
 
@@ -540,6 +547,8 @@ module Anthropic
         #
         #   @option request [Float] :timeout
         #
+        #   @option request [Hash{Symbol=>String}, nil] :qualifiers
+        #
         #   @option request [Array<String>, nil] :span_query
         #
         #   @option request [Array<String>, nil] :span_content_query
@@ -738,7 +747,7 @@ module Anthropic
         # Execute the request specified by `req`. This is the method that all resource
         # methods call into.
         #
-        # @overload request(method, path, query: {}, headers: {}, body: nil, unwrap: nil, page: nil, stream: nil, model: Anthropic::Internal::Type::Unknown, span_name: nil, span_attributes: nil, span_created_id: nil, span_route: nil, span_query: nil, span_content_query: nil, options: {})
+        # @overload request(method, path, query: {}, headers: {}, body: nil, unwrap: nil, page: nil, stream: nil, model: Anthropic::Internal::Type::Unknown, qualifiers: nil, span_name: nil, span_attributes: nil, span_created_id: nil, span_route: nil, span_query: nil, span_content_query: nil, options: {})
         #
         # @param method [Symbol]
         #
@@ -758,6 +767,9 @@ module Anthropic
         #
         # @param model [Anthropic::Internal::Type::Converter, Class, nil]
         #
+        # @param qualifiers [Hash{Symbol=>String}, nil] internal: the query pairs that tell the operation apart from the others with its
+        # path in the OpenAPI document
+        #
         # @param span_name [String, nil]
         #
         # @param span_attributes [Hash{String=>Object}, nil]
@@ -913,6 +925,7 @@ module Anthropic
                 T::Class[Anthropic::Internal::Type::BaseStream[T.anything, Anthropic::Internal::Type::BaseModel]]
               ),
               model: T.nilable(Anthropic::Internal::Type::Converter::Input),
+              qualifiers: T.nilable(T::Hash[Symbol, String]),
               span_name: T.nilable(String),
               span_attributes: T.nilable(T::Hash[String, T.anything]),
               span_created_id: T.nilable(T.any(String, T::Hash[String, Symbol])),
@@ -932,6 +945,7 @@ module Anthropic
               body: T.anything,
               max_retries: Integer,
               timeout: Float,
+              qualifiers: T.nilable(T::Hash[Symbol, String]),
               user_header_keys: T::Array[String],
               cast_to: T.nilable(Anthropic::Internal::Type::Converter::Input),
               stream: T.nilable(T::Class[T.anything]),

data/lib/anthropic/models/anthropic_beta.rb

@@ -2,6 +2,10 @@
 
 module Anthropic
   module Models
+    # Beta names you can send in the `anthropic-beta` header.
+    #
+    # See [Beta headers](https://platform.claude.com/docs/en/api/beta-headers) for how
+    # to send them and where to find the name a feature needs.
     module AnthropicBeta
       extend Anthropic::Internal::Type::Union
 
@@ -113,6 +117,8 @@ module Anthropic
 
       variant const: -> { Anthropic::Models::AnthropicBeta::ANALYTICS_USAGE_COST_2026_08_24 }
 
+      variant const: -> { Anthropic::Models::AnthropicBeta::EXPERIMENTAL_CLAUDE_TAG_2026_10_21 }
+
       variant String
 
       # @!method self.variants
@@ -178,6 +184,7 @@ module Anthropic
       WEBHOOKS_2026_10_07 = :"webhooks-2026-10-07"
       MESSAGE_THREADS_2026_08_12 = :"message-threads-2026-08-12"
       ANALYTICS_USAGE_COST_2026_08_24 = :"analytics-usage-cost-2026-08-24"
+      EXPERIMENTAL_CLAUDE_TAG_2026_10_21 = :"experimental-claude-tag-2026-10-21"
 
       # @!endgroup
     end

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

@@ -43,8 +43,16 @@ module Anthropic
         optional :strict, Anthropic::Internal::Type::Boolean
 
         # @!method initialize(allowed_callers: nil, cache_control: nil, defer_loading: nil, strict: nil, name: :code_execution, type: :code_execution_20260120)
-        #   Code execution tool with REPL state persistence (daemon mode + gVisor
-        #   checkpoint).
+        #   A `tools` entry for the code execution tool, version `code_execution_20260120`.
+        #   It adds REPL state persistence to version `code_execution_20250825`.
+        #
+        #   REPL state persistence applies with programmatic tool calling. With it, the
+        #   Python interpreter state, such as variable bindings, persists across requests
+        #   that reuse the container.
+        #
+        #   See the
+        #   [code execution tool guide](https://platform.claude.com/docs/en/agents-and-tools/tool-use/code-execution-tool#tool-versions)
+        #   to learn what each tool version adds.
         #
         #   Some parameter documentations has been truncated, see
         #   {Anthropic::Models::Beta::BetaCodeExecutionTool20260120} for more details.

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

@@ -10,7 +10,11 @@ module Anthropic
 
         variant -> { Anthropic::Beta::BetaCodeExecutionResultBlock }
 
-        # Code execution result with encrypted stdout for PFC + web_search results.
+        # The output and exit code of Python code that Claude ran with the code execution tool, with standard output in encrypted form.
+        #
+        # The API returns this block in place of `code_execution_result` when the code called the web search tool.
+        #
+        # See the [programmatic tool calling guide](https://platform.claude.com/docs/en/agents-and-tools/tool-use/programmatic-tool-calling) to learn more about programmatic tool calling.
         variant -> { Anthropic::Beta::BetaEncryptedCodeExecutionResultBlock }
 
         # @!method self.variants