anthropic 2.1.0 → 2.3.0

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

@@ -7,14 +7,59 @@ module Anthropic
         # @return [Anthropic::Resources::Beta::Messages::Batches]
         attr_reader :batches
 
+        # Runs the tool calls of a conversation until the model gives its final reply.
+        #
+        # The runner sends its requests on a message thread, so that each request after the first
+        # carries only the messages that are new. Pass `thread: false` to send the whole history
+        # with every request instead.
+        #
         # @param params [Anthropic::Models::Beta::MessageCreateParams]
         #
+        # @option params [false, nil] :thread `false` turns the message thread off; `nil` leaves it on.
+        #
+        # @raise [ArgumentError] if `thread` is anything else
+        #
         # @return [Anthropic::Helpers::Tools::Runner]
         def tool_runner(params)
           params = params.to_h.transform_keys(&:to_sym)
           warn_thinking_enabled(params)
           max_iterations = params.delete(:max_iterations)
-          Anthropic::Helpers::Tools::Runner.new(@client, params:, max_iterations:)
+          thread = runner_thread(params)
+          Anthropic::Helpers::Tools::Runner.new(@client, params:, max_iterations:, thread:)
+        end
+
+        # Creates a message thread: a conversation that the API keeps between requests, so that
+        # each turn sends only the messages that are new. It sends no request.
+        #
+        # Takes the keywords of {#create} except `thread` and `stream`. `messages` is optional and
+        # seeds the history, which the first turn sends.
+        #
+        # @param params [Hash{Symbol=>Object}]
+        #
+        # @option params [Symbol] :unsupported_request_behavior What a turn does when the API cannot
+        #   serve the request on a thread: `:error` (the default) raises the error, and
+        #   `:continue_unthreaded` sends the turn again, and every later turn, with the whole
+        #   history and no thread.
+        #
+        # @raise [ArgumentError] if `thread` or `stream` is given
+        #
+        # @raise [NotImplementedError] if the client's platform has no message threads
+        #
+        # @return [Anthropic::Helpers::Threads::BetaMessageThread]
+        def thread(params)
+          unless @client.message_threads?
+            raise NotImplementedError.new(
+              "Message threads are not available on this client. Use `#create` with the whole history instead."
+            )
+          end
+
+          params = params.to_h.transform_keys(&:to_sym)
+          unsupported_request_behavior = params.delete(:unsupported_request_behavior) || :error
+          Anthropic::Helpers::Threads::BetaMessageThread.new(
+            @client,
+            params:,
+            unsupported_request_behavior:
+          )
         end
 
         # See {Anthropic::Resources::Beta::Messages#stream_raw} for streaming counterpart.
@@ -31,7 +76,7 @@ module Anthropic
         # Some parameter documentations has been truncated, see
         # {Anthropic::Models::Beta::MessageCreateParams} for more details.
         #
-        # @overload create(max_tokens:, messages:, model:, cache_control: nil, compaction: 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, thinking: nil, tool_choice: nil, tools: nil, betas: nil, user_profile_id: nil, workspace_id: nil, request_options: {})
+        # @overload create(max_tokens:, messages:, model:, cache_control: nil, compaction: 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, thinking: nil, thread: nil, tool_choice: nil, tools: nil, betas: nil, user_profile_id: nil, workspace_id: nil, request_options: {})
         #
         # @param max_tokens [Integer] Body param: The maximum number of tokens to generate before stopping.
         #
@@ -73,6 +118,8 @@ module Anthropic
         #
         # @param thinking [Anthropic::Models::Beta::BetaThinkingConfigEnabled, Anthropic::Models::Beta::BetaThinkingConfigDisabled, Anthropic::Models::Beta::BetaThinkingConfigBetweenTools, Anthropic::Models::Beta::BetaThinkingConfigAdaptive] Body param: Configuration for Claude's thinking.
         #
+        # @param thread [Anthropic::Models::Beta::BetaThreadCreateParams, Anthropic::Models::Beta::BetaThreadContinueParams, nil] Body param: Server-held conversation state (a Thread). `{"type": "create"}` asks
+        #
         # @param tool_choice [Anthropic::Models::Beta::BetaToolChoiceAuto, Anthropic::Models::Beta::BetaToolChoiceAny, Anthropic::Models::Beta::BetaToolChoiceTool, Anthropic::Models::Beta::BetaToolChoiceNone] Body param: How the model should use the provided tools. The model can use a spe
         #
         # @param tools [Array<Anthropic::Models::Beta::BetaTool, Anthropic::Models::Beta::BetaToolBash20241022, Anthropic::Models::Beta::BetaToolBash20250124, Anthropic::Models::Beta::BetaCodeExecutionTool20250522, Anthropic::Models::Beta::BetaCodeExecutionTool20250825, Anthropic::Models::Beta::BetaCodeExecutionTool20260120, Anthropic::Models::Beta::BetaCodeExecutionTool20260521, Anthropic::Models::Beta::BetaBrowserToolset20260801, Anthropic::Models::Beta::BetaToolComputerUse20241022, Anthropic::Models::Beta::BetaMemoryTool20250818, Anthropic::Models::Beta::BetaToolComputerUse20250124, Anthropic::Models::Beta::BetaToolTextEditor20241022, Anthropic::Models::Beta::BetaToolComputerUse20251124, Anthropic::Models::Beta::BetaComputerToolset20260801, Anthropic::Models::Beta::BetaToolTextEditor20250124, Anthropic::Models::Beta::BetaToolTextEditor20250429, Anthropic::Models::Beta::BetaToolTextEditor20250728, Anthropic::Models::Beta::BetaWebSearchTool20250305, Anthropic::Models::Beta::BetaWebFetchTool20250910, Anthropic::Models::Beta::BetaWebSearchTool20260209, Anthropic::Models::Beta::BetaWebFetchTool20260209, Anthropic::Models::Beta::BetaWebFetchTool20260309, Anthropic::Models::Beta::BetaWebSearchTool20260318, Anthropic::Models::Beta::BetaWebFetchTool20260318, Anthropic::Models::Beta::BetaAdvisorTool20260301, Anthropic::Models::Beta::BetaToolSearchToolBm25_20251119, Anthropic::Models::Beta::BetaToolSearchToolRegex20251119, Anthropic::Models::Beta::BetaMCPToolset>] Body param: Definitions of tools that the model may use.
@@ -122,10 +169,11 @@ module Anthropic
               workspace_id: "anthropic-workspace-id"
             }
           @client.request(
+            qualifiers: {beta: "true"},
             span_name: Anthropic::Internal::Tracing::SpanName::MESSAGES_CREATE,
             span_route: "/v1/messages",
             method: :post,
-            path: "v1/messages?beta=true",
+            path: "v1/messages",
             headers: parsed.slice(*header_params.keys).transform_keys(header_params),
             body: parsed.except(*header_params.keys),
             model: Anthropic::Beta::BetaMessage,
@@ -148,7 +196,7 @@ module Anthropic
         # Some parameter documentations has been truncated, see
         # {Anthropic::Models::Beta::MessageCreateParams} for more details.
         #
-        # @overload stream_raw(max_tokens:, messages:, model:, cache_control: nil, compaction: 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, thinking: nil, tool_choice: nil, tools: nil, betas: nil, user_profile_id: nil, workspace_id: nil, request_options: {})
+        # @overload stream_raw(max_tokens:, messages:, model:, cache_control: nil, compaction: 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, thinking: nil, thread: nil, tool_choice: nil, tools: nil, betas: nil, user_profile_id: nil, workspace_id: nil, request_options: {})
         #
         # @param max_tokens [Integer] Body param: The maximum number of tokens to generate before stopping.
         #
@@ -190,6 +238,8 @@ module Anthropic
         #
         # @param thinking [Anthropic::Models::Beta::BetaThinkingConfigEnabled, Anthropic::Models::Beta::BetaThinkingConfigDisabled, Anthropic::Models::Beta::BetaThinkingConfigBetweenTools, Anthropic::Models::Beta::BetaThinkingConfigAdaptive] Body param: Configuration for Claude's thinking.
         #
+        # @param thread [Anthropic::Models::Beta::BetaThreadCreateParams, Anthropic::Models::Beta::BetaThreadContinueParams, nil] Body param: Server-held conversation state (a Thread). `{"type": "create"}` asks
+        #
         # @param tool_choice [Anthropic::Models::Beta::BetaToolChoiceAuto, Anthropic::Models::Beta::BetaToolChoiceAny, Anthropic::Models::Beta::BetaToolChoiceTool, Anthropic::Models::Beta::BetaToolChoiceNone] Body param: How the model should use the provided tools. The model can use a spe
         #
         # @param tools [Array<Anthropic::Models::Beta::BetaTool, Anthropic::Models::Beta::BetaToolBash20241022, Anthropic::Models::Beta::BetaToolBash20250124, Anthropic::Models::Beta::BetaCodeExecutionTool20250522, Anthropic::Models::Beta::BetaCodeExecutionTool20250825, Anthropic::Models::Beta::BetaCodeExecutionTool20260120, Anthropic::Models::Beta::BetaCodeExecutionTool20260521, Anthropic::Models::Beta::BetaBrowserToolset20260801, Anthropic::Models::Beta::BetaToolComputerUse20241022, Anthropic::Models::Beta::BetaMemoryTool20250818, Anthropic::Models::Beta::BetaToolComputerUse20250124, Anthropic::Models::Beta::BetaToolTextEditor20241022, Anthropic::Models::Beta::BetaToolComputerUse20251124, Anthropic::Models::Beta::BetaComputerToolset20260801, Anthropic::Models::Beta::BetaToolTextEditor20250124, Anthropic::Models::Beta::BetaToolTextEditor20250429, Anthropic::Models::Beta::BetaToolTextEditor20250728, Anthropic::Models::Beta::BetaWebSearchTool20250305, Anthropic::Models::Beta::BetaWebFetchTool20250910, Anthropic::Models::Beta::BetaWebSearchTool20260209, Anthropic::Models::Beta::BetaWebFetchTool20260209, Anthropic::Models::Beta::BetaWebFetchTool20260309, Anthropic::Models::Beta::BetaWebSearchTool20260318, Anthropic::Models::Beta::BetaWebFetchTool20260318, Anthropic::Models::Beta::BetaAdvisorTool20260301, Anthropic::Models::Beta::BetaToolSearchToolBm25_20251119, Anthropic::Models::Beta::BetaToolSearchToolRegex20251119, Anthropic::Models::Beta::BetaMCPToolset>] Body param: Definitions of tools that the model may use.
@@ -224,10 +274,11 @@ module Anthropic
               workspace_id: "anthropic-workspace-id"
             }
           @client.request(
+            qualifiers: {beta: "true"},
             span_name: Anthropic::Internal::Tracing::SpanName::MESSAGES_CREATE,
             span_route: "/v1/messages",
             method: :post,
-            path: "v1/messages?beta=true",
+            path: "v1/messages",
             headers: stream_headers(
               "accept" => "text/event-stream",
               "accept-encoding" => "identity",
@@ -301,10 +352,11 @@ module Anthropic
               workspace_id: "anthropic-workspace-id"
             }
           @client.request(
+            qualifiers: {beta: "true"},
             span_name: Anthropic::Internal::Tracing::SpanName::MESSAGES_COUNT_TOKENS,
             span_route: "/v1/messages/count_tokens",
             method: :post,
-            path: "v1/messages/count_tokens?beta=true",
+            path: "v1/messages/count_tokens",
             headers: parsed.slice(*header_params.keys).transform_keys(header_params),
             body: parsed.except(*header_params.keys),
             model: Anthropic::Beta::BetaMessageTokensCount,
@@ -318,7 +370,7 @@ module Anthropic
         # Some parameter documentations has been truncated, see
         # {Anthropic::Models::Beta::MessageCreateParams} for more details.
         #
-        # @overload stream(max_tokens:, messages:, model:, cache_control: nil, compaction: 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, thinking: nil, tool_choice: nil, tools: nil, betas: nil, user_profile_id: nil, workspace_id: nil, request_options: {})
+        # @overload stream(max_tokens:, messages:, model:, cache_control: nil, compaction: 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, thinking: nil, thread: nil, tool_choice: nil, tools: nil, betas: nil, user_profile_id: nil, workspace_id: nil, request_options: {})
         #
         # @param max_tokens [Integer] Body param: The maximum number of tokens to generate before stopping.
         #
@@ -360,6 +412,8 @@ module Anthropic
         #
         # @param thinking [Anthropic::Models::Beta::BetaThinkingConfigEnabled, Anthropic::Models::Beta::BetaThinkingConfigDisabled, Anthropic::Models::Beta::BetaThinkingConfigBetweenTools, Anthropic::Models::Beta::BetaThinkingConfigAdaptive] Body param: Configuration for Claude's thinking.
         #
+        # @param thread [Anthropic::Models::Beta::BetaThreadCreateParams, Anthropic::Models::Beta::BetaThreadContinueParams, nil] Body param: Server-held conversation state (a Thread). `{"type": "create"}` asks
+        #
         # @param tool_choice [Anthropic::Models::Beta::BetaToolChoiceAuto, Anthropic::Models::Beta::BetaToolChoiceAny, Anthropic::Models::Beta::BetaToolChoiceTool, Anthropic::Models::Beta::BetaToolChoiceNone] Body param: How the model should use the provided tools. The model can use a spe
         #
         # @param tools [Array<Anthropic::Models::Beta::BetaTool, Anthropic::Models::Beta::BetaToolBash20241022, Anthropic::Models::Beta::BetaToolBash20250124, Anthropic::Models::Beta::BetaCodeExecutionTool20250522, Anthropic::Models::Beta::BetaCodeExecutionTool20250825, Anthropic::Models::Beta::BetaCodeExecutionTool20260120, Anthropic::Models::Beta::BetaCodeExecutionTool20260521, Anthropic::Models::Beta::BetaBrowserToolset20260801, Anthropic::Models::Beta::BetaToolComputerUse20241022, Anthropic::Models::Beta::BetaMemoryTool20250818, Anthropic::Models::Beta::BetaToolComputerUse20250124, Anthropic::Models::Beta::BetaToolTextEditor20241022, Anthropic::Models::Beta::BetaToolComputerUse20251124, Anthropic::Models::Beta::BetaComputerToolset20260801, Anthropic::Models::Beta::BetaToolTextEditor20250124, Anthropic::Models::Beta::BetaToolTextEditor20250429, Anthropic::Models::Beta::BetaToolTextEditor20250728, Anthropic::Models::Beta::BetaWebSearchTool20250305, Anthropic::Models::Beta::BetaWebFetchTool20250910, Anthropic::Models::Beta::BetaWebSearchTool20260209, Anthropic::Models::Beta::BetaWebFetchTool20260209, Anthropic::Models::Beta::BetaWebFetchTool20260309, Anthropic::Models::Beta::BetaWebSearchTool20260318, Anthropic::Models::Beta::BetaWebFetchTool20260318, Anthropic::Models::Beta::BetaAdvisorTool20260301, Anthropic::Models::Beta::BetaToolSearchToolBm25_20251119, Anthropic::Models::Beta::BetaToolSearchToolRegex20251119, Anthropic::Models::Beta::BetaMCPToolset>] Body param: Definitions of tools that the model may use.
@@ -381,6 +435,29 @@ module Anthropic
 
         private
 
+        # The message thread of a tool runner, `nil` when the runner sends the whole history with
+        # every request. Removes `thread` from `params`.
+        #
+        # @param params [Hash{Symbol=>Object}]
+        #
+        # @return [Anthropic::Helpers::Threads::BetaMessageThread, nil]
+        def runner_thread(params)
+          thread = params.delete(:thread)
+          unless thread.nil? || thread == false
+            raise ArgumentError.new(
+              "`thread` on a tool runner can only be `false`, got #{thread.inspect}. " \
+              "The runner sets `thread` for each request itself."
+            )
+          end
+          return nil if thread == false || !@client.message_threads?
+
+          Anthropic::Helpers::Threads::BetaMessageThread.new(
+            @client,
+            params: {},
+            unsupported_request_behavior: :continue_unthreaded
+          )
+        end
+
         def warn_thinking_enabled(parsed)
           if Anthropic::Resources::Messages::MODELS_TO_WARN_WITH_THINKING_ENABLED.include?(parsed[:model]) &&
              parsed[:thinking] &&

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

@@ -28,11 +28,12 @@ module Anthropic
         def retrieve(model_id, params = {})
           parsed, options = Anthropic::Beta::ModelRetrieveParams.dump_request(params)
           @client.request(
+            qualifiers: {beta: "true"},
             span_name: Anthropic::Internal::Tracing::SpanName::MODELS_RETRIEVE,
             span_attributes: {"anthropic.model.id" => model_id},
             span_route: "/v1/models/{model_id}",
             method: :get,
-            path: ["v1/models/%1$s?beta=true", model_id],
+            path: ["v1/models/%1$s", model_id],
             headers: parsed.transform_keys(betas: "anthropic-beta", workspace_id: "anthropic-workspace-id"),
             model: Anthropic::Beta::BetaModelInfo,
             options: options
@@ -71,11 +72,12 @@ module Anthropic
           parsed, options = Anthropic::Beta::ModelListParams.dump_request(params)
           query = Anthropic::Internal::Util.encode_query_params(parsed.slice(*query_params))
           @client.request(
+            qualifiers: {beta: "true"},
             span_name: Anthropic::Internal::Tracing::SpanName::MODELS_LIST,
             span_route: "/v1/models",
             span_query: %w[after_id before_id lifecycle limit],
             method: :get,
-            path: "v1/models?beta=true",
+            path: "v1/models",
             query: query,
             headers: parsed.except(*query_params).transform_keys(
               betas: "anthropic-beta",

data/lib/anthropic/resources/beta/organization/analytics/apps/chat/projects.rb

@@ -50,11 +50,12 @@ module Anthropic
                     Anthropic::Beta::Organization::Analytics::Apps::Chat::ProjectListParams.dump_request(params)
                   query = Anthropic::Internal::Util.encode_query_params(parsed)
                   @client.request(
+                    qualifiers: {beta: "true"},
                     span_name: Anthropic::Internal::Tracing::SpanName::ORGANIZATION_ANALYTICS_APPS_CHAT_PROJECTS_LIST,
                     span_route: "/v1/organizations/analytics/apps/chat/projects",
                     span_query: %w[date ending_date filter group_by limit order order_by page starting_date],
                     method: :get,
-                    path: "v1/organizations/analytics/apps/chat/projects?beta=true",
+                    path: "v1/organizations/analytics/apps/chat/projects",
                     query: query,
                     page: Anthropic::Internal::PageCursor,
                     model: Anthropic::Beta::Organization::BetaAnalyticsProjectActivity,

data/lib/anthropic/resources/beta/organization/analytics/artifacts.rb

@@ -38,11 +38,12 @@ module Anthropic
               parsed, options = Anthropic::Beta::Organization::Analytics::ArtifactListParams.dump_request(params)
               query = Anthropic::Internal::Util.encode_query_params(parsed)
               @client.request(
+                qualifiers: {beta: "true"},
                 span_name: Anthropic::Internal::Tracing::SpanName::ORGANIZATION_ANALYTICS_ARTIFACTS_LIST,
                 span_route: "/v1/organizations/analytics/artifacts",
                 span_query: %w[date filter group_by limit page],
                 method: :get,
-                path: "v1/organizations/analytics/artifacts?beta=true",
+                path: "v1/organizations/analytics/artifacts",
                 query: query,
                 page: Anthropic::Internal::PageCursor,
                 model: Anthropic::Beta::Organization::BetaAnalyticsArtifactActivity,

data/lib/anthropic/resources/beta/organization/analytics/connectors.rb

@@ -49,12 +49,13 @@ module Anthropic
               parsed, options = Anthropic::Beta::Organization::Analytics::ConnectorListParams.dump_request(params)
               query = Anthropic::Internal::Util.encode_query_params(parsed)
               @client.request(
+                qualifiers: {beta: "true"},
                 span_name: Anthropic::Internal::Tracing::SpanName::ORGANIZATION_ANALYTICS_CONNECTORS_LIST,
                 span_route: "/v1/organizations/analytics/connectors",
                 span_query: %w[date ending_date filter group_by limit order order_by page starting_date],
                 span_content_query: %w[filter],
                 method: :get,
-                path: "v1/organizations/analytics/connectors?beta=true",
+                path: "v1/organizations/analytics/connectors",
                 query: query,
                 page: Anthropic::Internal::PageCursor,
                 model: Anthropic::Beta::Organization::BetaAnalyticsConnectorActivity,

data/lib/anthropic/resources/beta/organization/analytics/cost.rb

@@ -0,0 +1,176 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Resources
+    class Beta
+      class Organization
+        class Analytics
+          class Cost
+            # Get cost in USD across a date range, broken out by dimension.
+            #
+            # Returns one row per combination of the requested `group_by[]` dimensions (and
+            # time bucket, when `time_bucket_width` is set) that has cost in the range, ranked
+            # by spend or ordered by time bucket; every combination is returned across pages.
+            # With no `group_by[]` and no `time_bucket_width`, a single row aggregates the
+            # whole range. Includes all cost, whether or not it is attributable to a seat
+            # user. Requires an API key with the `read:analytics` scope, or an Admin API key.
+            #
+            # Some parameter documentations has been truncated, see
+            # {Anthropic::Models::Beta::Organization::Analytics::CostListParams} for more
+            # details.
+            #
+            # @overload list(starting_at:, actor_ids: nil, actor_types: nil, agent_ids: nil, api_key_ids: nil, claude_tag_categories: nil, claude_tag_user_ids: nil, context_windows: nil, deployment_ids: nil, ending_at: nil, environment_ids: nil, exclude_deleted_users: nil, group_by: nil, inference_geos: nil, limit: nil, models: nil, order: nil, order_by: nil, page: nil, products: nil, rbac_group_ids: nil, service_tiers: nil, session_ids: nil, slack_channel_ids: nil, speeds: nil, time_bucket_width: nil, user_profile_ids: nil, workspace_ids: nil, betas: nil, request_options: {})
+            #
+            # @param starting_at [Time] Query param: Start of range, inclusive. RFC 3339 tz-aware. Must be within the la
+            #
+            # @param actor_ids [Array<String>, nil] Query param: Filter to usage attributed to specific identities, by tagged ID: a
+            #
+            # @param actor_types [Array<Symbol, Anthropic::Models::Beta::Organization::BetaAnalyticsActorType>, nil] Query param: Filter to usage attributed to specific kinds of identity. Use `grou
+            #
+            # @param agent_ids [Array<String>, nil] Query param: Filter to usage incurred by sessions of specific Claude Managed Age
+            #
+            # @param api_key_ids [Array<String>, nil] Query param: Filter to usage authenticated by specific API keys, by tagged API k
+            #
+            # @param claude_tag_categories [Array<Symbol, Anthropic::Models::Beta::Organization::BetaAnalyticsClaudeTagCategory>, nil] Query param: Filter to Claude Tag (Claude in Slack) usage in specific spend cate
+            #
+            # @param claude_tag_user_ids [Array<String>, nil] Query param: Filter to Claude Tag (Claude in Slack) usage attributed to specific
+            #
+            # @param context_windows [Array<Symbol, Anthropic::Models::Beta::Organization::BetaAnalyticsContextWindow>, nil] Query param: Filter to specific context-window pricing tiers. Use `group_by[]=co
+            #
+            # @param deployment_ids [Array<String>, nil] Query param: Filter to usage incurred by Claude Managed Agents sessions that spe
+            #
+            # @param ending_at [Time, nil] Query param: End of range, exclusive. Required when `time_bucket_width` is set.
+            #
+            # @param environment_ids [Array<String>, nil] Query param: Filter to usage incurred by Claude Managed Agents sessions that ran
+            #
+            # @param exclude_deleted_users [Boolean] Query param: If true, omit rows whose `actor` is a `user_actor` with `deleted: t
+            #
+            # @param group_by [Array<Symbol, Anthropic::Models::Beta::Organization::Analytics::BetaAnalyticsCostGroupBy>, nil] Query param: Dimensions to break cost out by (at most 5, not counting `cost_type
+            #
+            # @param inference_geos [Array<Symbol, Anthropic::Models::Beta::Organization::BetaAnalyticsInferenceGeoFilter>, nil] Query param: Filter to specific inference regions. `not_available` matches rows
+            #
+            # @param limit [Integer] Query param: Number of rows per page (1-1000, default 20). `cost_type`/`token_ty
+            #
+            # @param models [Array<String>, nil] Query param: Models to include. Defaults to all models. Use `group_by[]=model` t
+            #
+            # @param order [Symbol, Anthropic::Models::Beta::Organization::BetaAnalyticsUsageCostSortOrder] Query param: Sort direction of the `order_by` metric, or of the time buckets whe
+            #
+            # @param order_by [Symbol, Anthropic::Models::Beta::Organization::Analytics::BetaAnalyticsCostOrderBy] Query param: Row order. A metric ranks rows by that metric in the `order` direct
+            #
+            # @param page [String, nil] Query param: Opaque cursor from a previous response's `next_page` field.
+            #
+            # @param products [Array<Symbol, Anthropic::Models::Beta::Organization::BetaAnalyticsUsageCostProductFilter>, nil] Query param: Product surfaces to include. Defaults to all products.
+            #
+            # @param rbac_group_ids [Array<String>, nil] Query param: Filter to usage attributed to specific RBAC groups. Accepts tagged
+            #
+            # @param service_tiers [Array<Symbol, Anthropic::Models::Beta::Organization::BetaAnalyticsServiceTier>, nil] Query param: Filter to specific service tiers. Use `group_by[]=service_tier` to
+            #
+            # @param session_ids [Array<String>, nil] Query param: Filter to usage incurred by specific Claude Managed Agents sessions
+            #
+            # @param slack_channel_ids [Array<String>, nil] Query param: Filter to usage originating from specific Slack channels. Use `grou
+            #
+            # @param speeds [Array<Symbol, Anthropic::Models::Beta::Organization::BetaAnalyticsSpeed>, nil] Query param: Filter to fast or standard inference mode. Use `group_by[]=speed` t
+            #
+            # @param time_bucket_width [Symbol, Anthropic::Models::Beta::Organization::BetaAnalyticsTimeBucketWidth, nil] Query param: Time-bucket granularity. When set, rows are returned per time bucke
+            #
+            # @param user_profile_ids [Array<String>, nil] Query param: Filter to usage attributed to specific user profiles, by tagged use
+            #
+            # @param workspace_ids [Array<String>, nil] Query param: Filter to usage in specific workspaces, by tagged workspace ID (`wr
+            #
+            # @param betas [Array<Symbol, String, Anthropic::Models::AnthropicBeta>] Header param: This endpoint is in beta: requests must send `analytics-usage-cost
+            #
+            # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
+            #
+            # @return [Anthropic::Internal::ReportPageCursor<Anthropic::Models::Beta::Organization::Analytics::BetaAnalyticsCostItem>]
+            #
+            # @see Anthropic::Models::Beta::Organization::Analytics::CostListParams
+            def list(params)
+              query_params =
+                [
+                  :starting_at,
+                  :actor_ids,
+                  :actor_types,
+                  :agent_ids,
+                  :api_key_ids,
+                  :claude_tag_categories,
+                  :claude_tag_user_ids,
+                  :context_windows,
+                  :deployment_ids,
+                  :ending_at,
+                  :environment_ids,
+                  :exclude_deleted_users,
+                  :group_by,
+                  :inference_geos,
+                  :limit,
+                  :models,
+                  :order,
+                  :order_by,
+                  :page,
+                  :products,
+                  :rbac_group_ids,
+                  :service_tiers,
+                  :session_ids,
+                  :slack_channel_ids,
+                  :speeds,
+                  :time_bucket_width,
+                  :user_profile_ids,
+                  :workspace_ids
+                ]
+              parsed, options = Anthropic::Beta::Organization::Analytics::CostListParams.dump_request(params)
+              query = Anthropic::Internal::Util.encode_query_params(parsed.slice(*query_params))
+              @client.request(
+                qualifiers: {beta: "true"},
+                span_name: Anthropic::Internal::Tracing::SpanName::ORGANIZATION_ANALYTICS_COST_LIST,
+                span_route: "/v1/organizations/analytics/cost",
+                span_query: %w[
+                  actor_ids
+                  actor_types
+                  agent_ids
+                  api_key_ids
+                  claude_tag_categories
+                  claude_tag_user_ids
+                  context_windows
+                  deployment_ids
+                  ending_at
+                  environment_ids
+                  exclude_deleted_users
+                  group_by
+                  inference_geos
+                  limit
+                  models
+                  order
+                  order_by
+                  page
+                  products
+                  rbac_group_ids
+                  service_tiers
+                  session_ids
+                  slack_channel_ids
+                  speeds
+                  starting_at
+                  time_bucket_width
+                  user_profile_ids
+                  workspace_ids
+                ],
+                method: :get,
+                path: "v1/organizations/analytics/cost",
+                query: query,
+                headers: parsed.except(*query_params).transform_keys(betas: "anthropic-beta"),
+                page: Anthropic::Internal::ReportPageCursor,
+                model: Anthropic::Beta::Organization::Analytics::BetaAnalyticsCostItem,
+                options: {extra_headers: {"anthropic-beta" => "analytics-usage-cost-2026-08-24"}, **options}
+              )
+            end
+
+            # @api private
+            #
+            # @param client [Anthropic::Client]
+            def initialize(client:)
+              @client = client
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/anthropic/resources/beta/organization/analytics/cost_report.rb

@@ -6,12 +6,19 @@ module Anthropic
       class Organization
         class Analytics
           class CostReport
-            # Get cost in USD over time across a date range.
+            # [Legacy] Get cost in USD over time across a date range.
             #
-            # Returns cost bucketed by minute, hour, or day, optionally broken down by
-            # product, model, context window, inference region, speed, cost type, or token
-            # type. Available to organizations on a Claude Enterprise plan. Requires an API
-            # key with the `read:analytics` scope.
+            # Returns cost bucketed by minute, hour, or day, optionally broken down by one or
+            # more `group_by[]` dimensions, such as model or cost type. Available to
+            # organizations on a Claude Enterprise plan. Requires an API key with the
+            # `read:analytics` scope.
+            #
+            # This endpoint is one of the legacy Claude Enterprise usage and cost reports. For
+            # new integrations, use
+            # [`GET /v1/organizations/analytics/cost`](/docs/en/api/beta/organization/analytics/cost/list)
+            # in the Usage and Cost Analytics API instead. To move an existing integration,
+            # see
+            # [Migrate from the Claude Enterprise usage and cost reports](/docs/en/manage-claude/usage-cost-analytics-api#migrate-from-enterprise-analytics-reports).
             #
             # Some parameter documentations has been truncated, see
             # {Anthropic::Models::Beta::Organization::Analytics::CostReportListParams} for
@@ -60,6 +67,7 @@ module Anthropic
               parsed, options = Anthropic::Beta::Organization::Analytics::CostReportListParams.dump_request(params)
               query = Anthropic::Internal::Util.encode_query_params(parsed)
               @client.request(
+                qualifiers: {beta: "true"},
                 span_name: Anthropic::Internal::Tracing::SpanName::ORGANIZATION_ANALYTICS_COST_REPORT_LIST,
                 span_route: "/v1/organizations/analytics/cost_report",
                 span_query: %w[
@@ -81,7 +89,7 @@ module Anthropic
                   user_ids
                 ],
                 method: :get,
-                path: "v1/organizations/analytics/cost_report?beta=true",
+                path: "v1/organizations/analytics/cost_report",
                 query: query,
                 page: Anthropic::Internal::ReportPageCursor,
                 model: Anthropic::Beta::Organization::BetaAnalyticsCostReportTimeBucket,

data/lib/anthropic/resources/beta/organization/analytics/plugins.rb

@@ -52,12 +52,13 @@ module Anthropic
               parsed, options = Anthropic::Beta::Organization::Analytics::PluginListParams.dump_request(params)
               query = Anthropic::Internal::Util.encode_query_params(parsed)
               @client.request(
+                qualifiers: {beta: "true"},
                 span_name: Anthropic::Internal::Tracing::SpanName::ORGANIZATION_ANALYTICS_PLUGINS_LIST,
                 span_route: "/v1/organizations/analytics/plugins",
                 span_query: %w[date ending_date filter group_by limit order order_by page starting_date],
                 span_content_query: %w[filter],
                 method: :get,
-                path: "v1/organizations/analytics/plugins?beta=true",
+                path: "v1/organizations/analytics/plugins",
                 query: query,
                 page: Anthropic::Internal::PageCursor,
                 model: Anthropic::Beta::Organization::BetaAnalyticsPluginActivity,

data/lib/anthropic/resources/beta/organization/analytics/skills.rb

@@ -47,12 +47,13 @@ module Anthropic
               parsed, options = Anthropic::Beta::Organization::Analytics::SkillListParams.dump_request(params)
               query = Anthropic::Internal::Util.encode_query_params(parsed)
               @client.request(
+                qualifiers: {beta: "true"},
                 span_name: Anthropic::Internal::Tracing::SpanName::ORGANIZATION_ANALYTICS_SKILLS_LIST,
                 span_route: "/v1/organizations/analytics/skills",
                 span_query: %w[date ending_date filter group_by limit order order_by page starting_date],
                 span_content_query: %w[filter],
                 method: :get,
-                path: "v1/organizations/analytics/skills?beta=true",
+                path: "v1/organizations/analytics/skills",
                 query: query,
                 page: Anthropic::Internal::PageCursor,
                 model: Anthropic::Beta::Organization::BetaAnalyticsSkillActivity,

data/lib/anthropic/resources/beta/organization/analytics/summaries.rb

@@ -43,11 +43,12 @@ module Anthropic
               parsed, options = Anthropic::Beta::Organization::Analytics::SummaryListParams.dump_request(params)
               query = Anthropic::Internal::Util.encode_query_params(parsed)
               @client.request(
+                qualifiers: {beta: "true"},
                 span_name: Anthropic::Internal::Tracing::SpanName::ORGANIZATION_ANALYTICS_SUMMARIES_LIST,
                 span_route: "/v1/organizations/analytics/summaries",
                 span_query: %w[ending_date filter limit page starting_date],
                 method: :get,
-                path: "v1/organizations/analytics/summaries?beta=true",
+                path: "v1/organizations/analytics/summaries",
                 query: query,
                 page: Anthropic::Internal::PageCursor,
                 model: Anthropic::Beta::Organization::BetaAnalyticsSingleDayActivitySummary,