anthropic 1.80.0 → 2.3.0

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
@@ -53,13 +60,14 @@ module Anthropic
             #
             # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
             #
-            # @return [Anthropic::Internal::PageCursor<Anthropic::Models::Beta::Organization::BetaAnalyticsCostReportTimeBucket>]
+            # @return [Anthropic::Internal::ReportPageCursor<Anthropic::Models::Beta::Organization::BetaAnalyticsCostReportTimeBucket>]
             #
             # @see Anthropic::Models::Beta::Organization::Analytics::CostReportListParams
             def list(params)
               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,9 +89,9 @@ 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::PageCursor,
+                page: Anthropic::Internal::ReportPageCursor,
                 model: Anthropic::Beta::Organization::BetaAnalyticsCostReportTimeBucket,
                 options: options
               )

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,

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

@@ -0,0 +1,177 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Resources
+    class Beta
+      class Organization
+        class Analytics
+          class Usage
+            # Get token usage 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 usage in the range,
+            # ranked by the `order_by` metric 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 usage, 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::UsageListParams} 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::BetaAnalyticsUsageGroupBy>, nil] Query param: Dimensions to break usage out by (at most 5): one row per combinati
+            #
+            # @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::BetaAnalyticsUsageOrderBy] 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::BetaAnalyticsUsageItem>]
+            #
+            # @see Anthropic::Models::Beta::Organization::Analytics::UsageListParams
+            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::UsageListParams.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_USAGE_LIST,
+                span_route: "/v1/organizations/analytics/usage",
+                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/usage",
+                query: query,
+                headers: parsed.except(*query_params).transform_keys(betas: "anthropic-beta"),
+                page: Anthropic::Internal::ReportPageCursor,
+                model: Anthropic::Beta::Organization::Analytics::BetaAnalyticsUsageItem,
+                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/usage_report.rb

@@ -6,13 +6,20 @@ module Anthropic
       class Organization
         class Analytics
           class UsageReport
-            # Get token usage over time across a date range.
+            # [Legacy] Get token usage over time across a date range.
             #
             # Returns token usage bucketed by minute, hour, or day, optionally broken down by
-            # product, model, context window, inference region, or speed. Available to
+            # one or more `group_by[]` dimensions, such as product or model. 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/usage`](/docs/en/api/beta/organization/analytics/usage/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::UsageReportListParams} for
             # more details.
@@ -53,13 +60,14 @@ module Anthropic
             #
             # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
             #
-            # @return [Anthropic::Internal::PageCursor<Anthropic::Models::Beta::Organization::BetaAnalyticsUsageReportTimeBucket>]
+            # @return [Anthropic::Internal::ReportPageCursor<Anthropic::Models::Beta::Organization::BetaAnalyticsUsageReportTimeBucket>]
             #
             # @see Anthropic::Models::Beta::Organization::Analytics::UsageReportListParams
             def list(params)
               parsed, options = Anthropic::Beta::Organization::Analytics::UsageReportListParams.dump_request(params)
               query = Anthropic::Internal::Util.encode_query_params(parsed)
               @client.request(
+                qualifiers: {beta: "true"},
                 span_name: Anthropic::Internal::Tracing::SpanName::ORGANIZATION_ANALYTICS_USAGE_REPORT_LIST,
                 span_route: "/v1/organizations/analytics/usage_report",
                 span_query: %w[
@@ -81,9 +89,9 @@ module Anthropic
                   user_ids
                 ],
                 method: :get,
-                path: "v1/organizations/analytics/usage_report?beta=true",
+                path: "v1/organizations/analytics/usage_report",
                 query: query,
-                page: Anthropic::Internal::PageCursor,
+                page: Anthropic::Internal::ReportPageCursor,
                 model: Anthropic::Beta::Organization::BetaAnalyticsUsageReportTimeBucket,
                 options: options
               )

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

@@ -6,14 +6,21 @@ module Anthropic
       class Organization
         class Analytics
           class UserCostReport
-            # Get per-user cost in USD across a date range.
-            #
-            # Returns one row per user, ranked by spend. Use this to see which users account
-            # for the most cost. Only cost attributable to a seat user is included; for
-            # organization-wide totals including direct API-key and automation traffic, use
-            # the bucketed `/v1/organizations/analytics/cost_report` endpoint. Available to
-            # organizations on a Claude Enterprise plan. Requires an API key with the
-            # `read:analytics` scope.
+            # [Legacy] Get per-user cost in USD across a date range.
+            #
+            # Returns cost per user, ranked by spend; `group_by[]` or `bucket_width` splits a
+            # user across several rows. Use this to see which users account for the most cost.
+            # Only cost attributed to a user account is included; cost with no user attributed
+            # to it, such as Code Review usage and Claude Tag usage in Slack channels, is left
+            # out. 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::UserCostReportListParams} for
@@ -61,13 +68,14 @@ module Anthropic
             #
             # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
             #
-            # @return [Anthropic::Internal::PageCursor<Anthropic::Models::Beta::Organization::BetaAnalyticsCostUsersItem>]
+            # @return [Anthropic::Internal::ReportPageCursor<Anthropic::Models::Beta::Organization::BetaAnalyticsCostUsersItem>]
             #
             # @see Anthropic::Models::Beta::Organization::Analytics::UserCostReportListParams
             def list(params)
               parsed, options = Anthropic::Beta::Organization::Analytics::UserCostReportListParams.dump_request(params)
               query = Anthropic::Internal::Util.encode_query_params(parsed)
               @client.request(
+                qualifiers: {beta: "true"},
                 span_name: Anthropic::Internal::Tracing::SpanName::ORGANIZATION_ANALYTICS_USER_COST_REPORT_LIST,
                 span_route: "/v1/organizations/analytics/user_cost_report",
                 span_query: %w[
@@ -92,9 +100,9 @@ module Anthropic
                   user_ids
                 ],
                 method: :get,
-                path: "v1/organizations/analytics/user_cost_report?beta=true",
+                path: "v1/organizations/analytics/user_cost_report",
                 query: query,
-                page: Anthropic::Internal::PageCursor,
+                page: Anthropic::Internal::ReportPageCursor,
                 model: Anthropic::Beta::Organization::BetaAnalyticsCostUsersItem,
                 options: options
               )

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

@@ -6,14 +6,21 @@ module Anthropic
       class Organization
         class Analytics
           class UserUsageReport
-            # Get per-user token usage across a date range.
-            #
-            # Returns one row per user, ranked by the chosen token metric. Use this to see
-            # which users consume the most tokens. Only usage attributable to a seat user is
-            # included; for organization-wide totals including direct API-key and automation
-            # traffic, use the bucketed `/v1/organizations/analytics/usage_report` endpoint.
-            # Available to organizations on a Claude Enterprise plan. Requires an API key with
-            # the `read:analytics` scope.
+            # [Legacy] Get per-user token usage across a date range.
+            #
+            # Returns usage per user, ranked by the chosen token metric; `group_by[]` or
+            # `bucket_width` splits a user across several rows. Use this to see which users
+            # consume the most tokens. Only usage attributed to a user account is included;
+            # usage with no user attributed to it, such as Code Review usage and Claude Tag
+            # usage in Slack channels, is left out. 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/usage`](/docs/en/api/beta/organization/analytics/usage/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::UserUsageReportListParams}
@@ -61,7 +68,7 @@ module Anthropic
             #
             # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
             #
-            # @return [Anthropic::Internal::PageCursor<Anthropic::Models::Beta::Organization::BetaAnalyticsUsageUsersItem>]
+            # @return [Anthropic::Internal::ReportPageCursor<Anthropic::Models::Beta::Organization::BetaAnalyticsUsageUsersItem>]
             #
             # @see Anthropic::Models::Beta::Organization::Analytics::UserUsageReportListParams
             def list(params)
@@ -69,6 +76,7 @@ module Anthropic
                 Anthropic::Beta::Organization::Analytics::UserUsageReportListParams.dump_request(params)
               query = Anthropic::Internal::Util.encode_query_params(parsed)
               @client.request(
+                qualifiers: {beta: "true"},
                 span_name: Anthropic::Internal::Tracing::SpanName::ORGANIZATION_ANALYTICS_USER_USAGE_REPORT_LIST,
                 span_route: "/v1/organizations/analytics/user_usage_report",
                 span_query: %w[
@@ -93,9 +101,9 @@ module Anthropic
                   user_ids
                 ],
                 method: :get,
-                path: "v1/organizations/analytics/user_usage_report?beta=true",
+                path: "v1/organizations/analytics/user_usage_report",
                 query: query,
-                page: Anthropic::Internal::PageCursor,
+                page: Anthropic::Internal::ReportPageCursor,
                 model: Anthropic::Beta::Organization::BetaAnalyticsUsageUsersItem,
                 options: options
               )

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

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