anthropic 2.0.0 → 2.2.0

data/lib/anthropic/models/user_profile_enforcement_action_reason.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    # Why Anthropic placed this enforcement action: `unsupported_region`,
+    # `fraud_or_abuse`, `high_harm`, `usage_policy_violation`, `account_compromise` or
+    # `unspecified`. More values may be added; read a value you do not recognize as
+    # `unspecified`.
+    module UserProfileEnforcementActionReason
+      extend Anthropic::Internal::Type::Enum
+
+      UNSUPPORTED_REGION = :unsupported_region
+      FRAUD_OR_ABUSE = :fraud_or_abuse
+      HIGH_HARM = :high_harm
+      USAGE_POLICY_VIOLATION = :usage_policy_violation
+      ACCOUNT_COMPROMISE = :account_compromise
+      UNSPECIFIED = :unspecified
+
+      # @!method self.values
+      #   @return [Array<Symbol>]
+    end
+  end
+end

data/lib/anthropic/models/user_profile_enforcement_action_restriction.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    class UserProfileEnforcementActionRestriction < Anthropic::Internal::Type::BaseModel
+      # @!attribute id
+      #   The action's ID (`enac_...`), stable while the action is open.
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute action
+      #   The next step on the action: `verify` or `null`. `verify`: the end user can
+      #   clear it now by passing an identity check. `null`: there is nothing the end user
+      #   can do now to clear it, including while Anthropic reviews an identity check the
+      #   end user submitted.
+      #
+      #   @return [Symbol, Anthropic::Models::UserProfileEnforcementActionNextStep, nil]
+      required :action, enum: -> { Anthropic::UserProfileEnforcementActionNextStep }, nil?: true
+
+      # @!attribute expires_at
+      #   When the action ends on its own, in RFC 3339 format; it stops showing once this
+      #   time has passed. `null` when it has no end date, and always `null` when `reason`
+      #   is `account_compromise`.
+      #
+      #   @return [Time, nil]
+      required :expires_at, Time, nil?: true
+
+      # @!attribute opened_at
+      #   When Anthropic opened the action, in RFC 3339 format.
+      #
+      #   @return [Time]
+      required :opened_at, Time
+
+      # @!attribute reason
+      #   Why Anthropic placed the limit: `unsupported_region`, `fraud_or_abuse`,
+      #   `high_harm`, `usage_policy_violation`, `account_compromise` or `unspecified`.
+      #
+      #   @return [Symbol, Anthropic::Models::UserProfileEnforcementActionReason]
+      required :reason, enum: -> { Anthropic::UserProfileEnforcementActionReason }
+
+      # @!attribute type
+      #
+      #   @return [Symbol, :restriction]
+      required :type, const: :restriction
+
+      # @!method initialize(id:, action:, expires_at:, opened_at:, reason:, type: :restriction)
+      #   Anthropic has limited how it serves the end user until the action is resolved.
+      #   The end user may still be served in part.
+      #
+      #   Some parameter documentations has been truncated, see
+      #   {Anthropic::Models::UserProfileEnforcementActionRestriction} for more details.
+      #
+      #   @param id [String] The action's ID (`enac_...`), stable while the action is open.
+      #
+      #   @param action [Symbol, Anthropic::Models::UserProfileEnforcementActionNextStep, nil] The next step on the action: `verify` or `null`. `verify`: the end user can clea
+      #
+      #   @param expires_at [Time, nil] When the action ends on its own, in RFC 3339 format; it stops showing once this
+      #
+      #   @param opened_at [Time] When Anthropic opened the action, in RFC 3339 format.
+      #
+      #   @param reason [Symbol, Anthropic::Models::UserProfileEnforcementActionReason] Why Anthropic placed the limit: `unsupported_region`, `fraud_or_abuse`, `high_ha
+      #
+      #   @param type [Symbol, :restriction]
+    end
+  end
+end

data/lib/anthropic/models/user_profile_enforcement_status.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    # Anthropic's enforcement status of this profile: `unrestricted`, `pending`,
+    # `restricted` or `banned`. More values may be added; read a value you do not
+    # recognize as `restricted`.
+    module UserProfileEnforcementStatus
+      extend Anthropic::Internal::Type::Enum
+
+      UNRESTRICTED = :unrestricted
+      PENDING = :pending
+      RESTRICTED = :restricted
+      BANNED = :banned
+
+      # @!method self.values
+      #   @return [Array<Symbol>]
+    end
+  end
+end

data/lib/anthropic/models/user_profile_list_params.rb

@@ -7,6 +7,20 @@ module Anthropic
       extend Anthropic::Internal::Type::RequestParameters::Converter
       include Anthropic::Internal::Type::RequestParameters
 
+      # @!attribute enforcement_status
+      #   Return only the user profiles whose `enforcement_status` is one of these values:
+      #   `unrestricted`, `pending`, `restricted` or `banned`. Repeat the parameter to
+      #   match any of several. With it set, a page may hold fewer than `limit` profiles,
+      #   or none, and still carry a `next_page`: the service examines a bounded number of
+      #   profiles per request, and only a null `next_page` means the listing is complete.
+      #   Rejected with `invalid_request_error` under the `user-profiles-2026-09-04` and
+      #   earlier beta headers. Fails with `overloaded_error` when a profile's enforcement
+      #   actions cannot be read for the moment.
+      #
+      #   @return [Array<Symbol, Anthropic::Models::UserProfileEnforcementStatus>, nil]
+      optional :enforcement_status,
+               -> { Anthropic::Internal::Type::ArrayOf[enum: Anthropic::UserProfileEnforcementStatus] }
+
       # @!attribute limit
       #   The maximum number of user profiles to return, from 1 to 100. Defaults to 20.
       #
@@ -47,10 +61,12 @@ module Anthropic
       #   @return [String, nil]
       optional :workspace_id, String
 
-      # @!method initialize(limit: nil, order: nil, order_by: nil, page: nil, workspace_id: nil, request_options: {})
+      # @!method initialize(enforcement_status: nil, limit: nil, order: nil, order_by: nil, page: nil, workspace_id: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Anthropic::Models::UserProfileListParams} for more details.
       #
+      #   @param enforcement_status [Array<Symbol, Anthropic::Models::UserProfileEnforcementStatus>] Return only the user profiles whose `enforcement_status` is one of these values:
+      #
       #   @param limit [Integer] The maximum number of user profiles to return, from 1 to 100. Defaults to 20.
       #
       #   @param order [Symbol, Anthropic::Models::UserProfileListOrder] The sort direction, applied to the field that `order_by` selects. Defaults to `d

data/lib/anthropic/models.rb

@@ -836,6 +836,18 @@ module Anthropic
 
   UserProfileEfsProgram = Anthropic::Models::UserProfileEfsProgram
 
+  UserProfileEnforcementAction = Anthropic::Models::UserProfileEnforcementAction
+
+  UserProfileEnforcementActionBan = Anthropic::Models::UserProfileEnforcementActionBan
+
+  UserProfileEnforcementActionNextStep = Anthropic::Models::UserProfileEnforcementActionNextStep
+
+  UserProfileEnforcementActionReason = Anthropic::Models::UserProfileEnforcementActionReason
+
+  UserProfileEnforcementActionRestriction = Anthropic::Models::UserProfileEnforcementActionRestriction
+
+  UserProfileEnforcementStatus = Anthropic::Models::UserProfileEnforcementStatus
+
   UserProfileExternalUserAccountStatus = Anthropic::Models::UserProfileExternalUserAccountStatus
 
   UserProfileExternalUserDetails = Anthropic::Models::UserProfileExternalUserDetails

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.
@@ -148,7 +195,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 +237,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.
@@ -318,7 +367,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 +409,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 +432,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/organization/analytics/cost.rb

@@ -0,0 +1,175 @@
+# 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(
+                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?beta=true",
+                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.
-            #
-            # 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.
+            # [Legacy] Get cost in USD over time across a date range.
+            #
+            # 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