anthropic 1.74.0 → 1.76.0

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

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Resources
+    class Beta
+      class Organization
+        class Analytics
+          class Plugins
+            # Get per-plugin install + invocation usage for a given day, with pagination.
+            #
+            # Returns plugin usage metrics for the organization across Cowork and Claude Code,
+            # sorted by plugin name. The `plugin_name` value `third-party` is an aggregate
+            # bucket, not a plugin: it collects plugin activity, from either surface, for
+            # which the reporting client did not provide a plugin name — so an organization's
+            # own plugins can contribute both to their own named rows and to this bucket. Use
+            # `group_by[]` to break usage out per member, per RBAC group, or per product
+            # surface (Cowork / Claude Code), and `filter[]` to scope results; the parameter
+            # descriptions list the supported dimensions. Requires an API key with the
+            # `read:analytics` scope. `starting_date` / `ending_date` select range-rollup mode
+            # like `/skills`.
+            #
+            # Some parameter documentations has been truncated, see
+            # {Anthropic::Models::Beta::Organization::Analytics::PluginListParams} for more
+            # details.
+            #
+            # @overload list(date: nil, ending_date: nil, filter: nil, group_by: nil, limit: nil, order: nil, order_by: nil, page: nil, starting_date: nil, request_options: {})
+            #
+            # @param date [Date, nil] UTC date in YYYY-MM-DD format. The day to get plugin usage for. Data is typicall
+            #
+            # @param ending_date [Date, nil] UTC date in YYYY-MM-DD format. End of the date range (exclusive); only valid wit
+            #
+            # @param filter [Array<String>, nil] Filters as `dimension:value`, e.g. `filter[]=rbac_group_id:{id}`. Repeat the par
+            #
+            # @param group_by [Array<Symbol, Anthropic::Models::Beta::Organization::Analytics::PluginListParams::GroupBy>, nil] Dimensions to break results out by (e.g. `group_by[]=user_id`). Supported on thi
+            #
+            # @param limit [Integer, nil] Number of results per page (1-1000, default 100).
+            #
+            # @param order [Symbol, Anthropic::Models::Beta::Organization::Analytics::PluginListParams::Order, nil] Sort direction: `asc` or `desc`. Defaults to `asc` for the endpoint's sort colum
+            #
+            # @param order_by [String, nil] Sort field. Restricted to the endpoint's sort column plus its rankable metrics (
+            #
+            # @param page [String, nil] Opaque cursor from a previous response's `next_page` field.
+            #
+            # @param starting_date [Date, nil] UTC date in YYYY-MM-DD format. Start of a date range (inclusive). Enables rollup
+            #
+            # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
+            #
+            # @return [Anthropic::Internal::PageCursor<Anthropic::Models::Beta::Organization::BetaAnalyticsPluginActivity>]
+            #
+            # @see Anthropic::Models::Beta::Organization::Analytics::PluginListParams
+            def list(params = {})
+              parsed, options = Anthropic::Beta::Organization::Analytics::PluginListParams.dump_request(params)
+              query = Anthropic::Internal::Util.encode_query_params(parsed)
+              @client.request(
+                method: :get,
+                path: "v1/organizations/analytics/plugins?beta=true",
+                query: query,
+                page: Anthropic::Internal::PageCursor,
+                model: Anthropic::Beta::Organization::BetaAnalyticsPluginActivity,
+                options: 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/skills.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Resources
+    class Beta
+      class Organization
+        class Analytics
+          class Skills
+            # Get per-skill usage for a given day, with cursor-based pagination.
+            #
+            # Returns skill usage metrics for the organization, sorted by skill name. Use
+            # `group_by[]` to break usage out per member, per RBAC group, or per product
+            # surface, and `filter[]` to scope results; the parameter descriptions list the
+            # supported dimensions. Available to organizations on a Claude Enterprise plan.
+            # Requires an API key with the `read:analytics` scope.
+            #
+            # Some parameter documentations has been truncated, see
+            # {Anthropic::Models::Beta::Organization::Analytics::SkillListParams} for more
+            # details.
+            #
+            # @overload list(date: nil, ending_date: nil, filter: nil, group_by: nil, limit: nil, order: nil, order_by: nil, page: nil, starting_date: nil, request_options: {})
+            #
+            # @param date [Date, nil] UTC date in YYYY-MM-DD format. The day to get skill usage for. Data is typically
+            #
+            # @param ending_date [Date, nil] UTC date in YYYY-MM-DD format. End of the date range (exclusive); only valid wit
+            #
+            # @param filter [Array<String>, nil] Filters as `dimension:value`, e.g. `filter[]=rbac_group_id:{id}`. Repeat the par
+            #
+            # @param group_by [Array<Symbol, Anthropic::Models::Beta::Organization::Analytics::SkillListParams::GroupBy>, nil] Dimensions to break results out by (e.g. `group_by[]=user_id`). Supported on thi
+            #
+            # @param limit [Integer, nil] Number of results per page (1-1000, default 100).
+            #
+            # @param order [Symbol, Anthropic::Models::Beta::Organization::Analytics::SkillListParams::Order, nil] Sort direction: `asc` or `desc`. Defaults to `asc` for the endpoint's sort colum
+            #
+            # @param order_by [String, nil] Sort field. Restricted to the endpoint's sort column plus its rankable metrics (
+            #
+            # @param page [String, nil] Opaque cursor from a previous response's `next_page` field.
+            #
+            # @param starting_date [Date, nil] UTC date in YYYY-MM-DD format. Start of a date range (inclusive). Enables rollup
+            #
+            # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
+            #
+            # @return [Anthropic::Internal::PageCursor<Anthropic::Models::Beta::Organization::BetaAnalyticsSkillActivity>]
+            #
+            # @see Anthropic::Models::Beta::Organization::Analytics::SkillListParams
+            def list(params = {})
+              parsed, options = Anthropic::Beta::Organization::Analytics::SkillListParams.dump_request(params)
+              query = Anthropic::Internal::Util.encode_query_params(parsed)
+              @client.request(
+                method: :get,
+                path: "v1/organizations/analytics/skills?beta=true",
+                query: query,
+                page: Anthropic::Internal::PageCursor,
+                model: Anthropic::Beta::Organization::BetaAnalyticsSkillActivity,
+                options: 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/summaries.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Resources
+    class Beta
+      class Organization
+        class Analytics
+          class Summaries
+            # Get organization-wide activity summaries for a date range.
+            #
+            # Returns one entry per day from `starting_date` (inclusive) to `ending_date`
+            # (exclusive) in `data`, the same `data` / `next_page` envelope as the other
+            # analytics list endpoints; the series is currently returned in full, so
+            # `next_page` is always null (`summaries` is a deprecated alias of `data`). Data
+            # is typically available with a 1-day lag and may be revised by a few percent over
+            # the following days: when `ending_date` is omitted it defaults to the most recent
+            # available day + 1, so the last entry covers the most recent available day. The
+            # series can be scoped to an RBAC group via `filter[]=rbac_group_id:{id}`.
+            # Available to organizations on a Claude Enterprise plan. Requires an API key with
+            # the `read:analytics` scope.
+            #
+            # Some parameter documentations has been truncated, see
+            # {Anthropic::Models::Beta::Organization::Analytics::SummaryListParams} for more
+            # details.
+            #
+            # @overload list(starting_date:, ending_date: nil, filter: nil, limit: nil, page: nil, request_options: {})
+            #
+            # @param starting_date [Date] UTC date in YYYY-MM-DD format. Start of the date range (inclusive). Data is typi
+            #
+            # @param ending_date [Date, nil] UTC date in YYYY-MM-DD format. End of the date range (exclusive). Data is typica
+            #
+            # @param filter [Array<String>, nil] Filters as `dimension:value`. Only `rbac_group_id` is supported (e.g. `filter[]=
+            #
+            # @param limit [Integer, nil] Number of results per page (1-1000, default 100). The day series (at most 366 en
+            #
+            # @param page [String, nil] Opaque cursor from a previous response's `next_page` field. `next_page` is curre
+            #
+            # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
+            #
+            # @return [Anthropic::Internal::PageCursor<Anthropic::Models::Beta::Organization::BetaAnalyticsSingleDayActivitySummary>]
+            #
+            # @see Anthropic::Models::Beta::Organization::Analytics::SummaryListParams
+            def list(params)
+              parsed, options = Anthropic::Beta::Organization::Analytics::SummaryListParams.dump_request(params)
+              query = Anthropic::Internal::Util.encode_query_params(parsed)
+              @client.request(
+                method: :get,
+                path: "v1/organizations/analytics/summaries?beta=true",
+                query: query,
+                page: Anthropic::Internal::PageCursor,
+                model: Anthropic::Beta::Organization::BetaAnalyticsSingleDayActivitySummary,
+                options: 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

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Resources
+    class Beta
+      class Organization
+        class Analytics
+          class UsageReport
+            # 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
+            # organizations on a Claude Enterprise plan. Requires an API key with the
+            # `read:analytics` scope.
+            #
+            # Some parameter documentations has been truncated, see
+            # {Anthropic::Models::Beta::Organization::Analytics::UsageReportListParams} for
+            # more details.
+            #
+            # @overload list(starting_at:, bucket_width: nil, claude_tag_categories: nil, claude_tag_user_ids: nil, context_windows: nil, ending_at: nil, group_by: nil, inference_geos: nil, limit: nil, models: nil, page: nil, products: nil, rbac_group_ids: nil, slack_channel_ids: nil, speeds: nil, user_ids: nil, request_options: {})
+            #
+            # @param starting_at [Time] Start of range, inclusive. RFC 3339 tz-aware. Must be within the last 365 days a
+            #
+            # @param bucket_width [Symbol, Anthropic::Models::Beta::Organization::Analytics::UsageReportListParams::BucketWidth] Time bucket granularity.
+            #
+            # @param claude_tag_categories [Array<Symbol, Anthropic::Models::Beta::Organization::BetaAnalyticsClaudeTagCategory>, nil] Filter to Claude Tag (Claude in Slack) usage in specific spend categories. Usage
+            #
+            # @param claude_tag_user_ids [Array<String>, nil] Filter to Claude Tag (Claude in Slack) usage attributed to specific Slack users,
+            #
+            # @param context_windows [Array<Symbol, Anthropic::Models::Beta::Organization::BetaAnalyticsContextWindow>, nil] Filter to specific context-window pricing tiers. Use `group_by[]=context_window`
+            #
+            # @param ending_at [Time, nil] End of range, exclusive. When omitted, defaults to the earlier of now and `start
+            #
+            # @param group_by [Array<Symbol, Anthropic::Models::Beta::Organization::Analytics::UsageReportListParams::GroupBy>, nil] Dimensions to break each time bucket out by. Defaults to no grouping (one total
+            #
+            # @param inference_geos [Array<Symbol, Anthropic::Models::Beta::Organization::BetaAnalyticsInferenceGeoFilter>, nil] Filter to specific inference regions. `not_available` matches rows where the reg
+            #
+            # @param limit [Integer, nil] Maximum number of time buckets per page. Defaults and caps vary by `bucket_width
+            #
+            # @param models [Array<String>, nil] Models to include. Defaults to all models. Use `group_by[]=model` to break out p
+            #
+            # @param page [String, nil] Opaque cursor from a previous response's `next_page` field.
+            #
+            # @param products [Array<Symbol, Anthropic::Models::Beta::Organization::BetaAnalyticsProductFilter>, nil] Product surfaces to include. Defaults to all products. Use `group_by[]=product`
+            #
+            # @param rbac_group_ids [Array<String>, nil] Filter to usage attributed to specific RBAC groups. Accepts tagged RBAC group ID
+            #
+            # @param slack_channel_ids [Array<String>, nil] Filter to usage originating from specific Slack channels. Use `group*by[]=slack*
+            #
+            # @param speeds [Array<Symbol, Anthropic::Models::Beta::Organization::Analytics::UsageReportListParams::Speed>, nil] Filter to fast or standard inference mode. Use `group_by[]=speed` to break out p
+            #
+            # @param user_ids [Array<String>, nil] Filter to specific users by tagged user ID.
+            #
+            # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
+            #
+            # @return [Anthropic::Internal::PageCursor<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(
+                method: :get,
+                path: "v1/organizations/analytics/usage_report?beta=true",
+                query: query,
+                page: Anthropic::Internal::PageCursor,
+                model: Anthropic::Beta::Organization::BetaAnalyticsUsageReportTimeBucket,
+                options: 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/user_cost_report.rb

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Resources
+    class Beta
+      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.
+            #
+            # Some parameter documentations has been truncated, see
+            # {Anthropic::Models::Beta::Organization::Analytics::UserCostReportListParams} for
+            # more details.
+            #
+            # @overload list(starting_at:, bucket_width: nil, claude_tag_categories: nil, claude_tag_user_ids: nil, context_windows: nil, ending_at: 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, slack_channel_ids: nil, speeds: nil, user_ids: nil, request_options: {})
+            #
+            # @param starting_at [Time] Start of range, inclusive. RFC 3339 tz-aware. Must be within the last 365 days a
+            #
+            # @param bucket_width [Symbol, Anthropic::Models::Beta::Organization::Analytics::UserCostReportListParams::BucketWidth, nil] Time-bucket granularity. When set, each row's `starting_at` and `ending_at` are
+            #
+            # @param claude_tag_categories [Array<Symbol, Anthropic::Models::Beta::Organization::BetaAnalyticsClaudeTagCategory>, nil] Filter to Claude Tag (Claude in Slack) usage in specific spend categories. Usage
+            #
+            # @param claude_tag_user_ids [Array<String>, nil] Filter to Claude Tag (Claude in Slack) usage attributed to specific Slack users,
+            #
+            # @param context_windows [Array<Symbol, Anthropic::Models::Beta::Organization::BetaAnalyticsContextWindow>, nil] Filter to specific context-window pricing tiers. Use `group_by[]=context_window`
+            #
+            # @param ending_at [Time, nil] End of range, exclusive. When omitted, defaults to the earlier of now and `start
+            #
+            # @param exclude_deleted_users [Boolean] If true, omit rows for users who are deleted (`deleted: true`). A page may conta
+            #
+            # @param group_by [Array<Symbol, Anthropic::Models::Beta::Organization::Analytics::UserCostReportListParams::GroupBy>, nil] Break each actor's row out by the given dimensions. Accepts the same values as t
+            #
+            # @param inference_geos [Array<Symbol, Anthropic::Models::Beta::Organization::BetaAnalyticsInferenceGeoFilter>, nil] Filter to specific inference regions. `not_available` matches rows where the reg
+            #
+            # @param limit [Integer] Number of rows per page (1-1000, default 20). One row per actor unless `group_by
+            #
+            # @param models [Array<String>, nil] Models to include. Defaults to all models. Use `group_by[]=model` to break out p
+            #
+            # @param order [Symbol, Anthropic::Models::Beta::Organization::Analytics::UserCostReportListParams::Order] Sort direction. Defaults to `desc`.
+            #
+            # @param order_by [Symbol, Anthropic::Models::Beta::Organization::Analytics::UserCostReportListParams::OrderBy] Metric to rank actors by. Defaults to `amount`.
+            #
+            # @param page [String, nil] Opaque cursor from a previous response's `next_page` field.
+            #
+            # @param products [Array<Symbol, Anthropic::Models::Beta::Organization::BetaAnalyticsProductFilter>, nil] Product surfaces to include. Defaults to all products.
+            #
+            # @param rbac_group_ids [Array<String>, nil] Filter to usage attributed to specific RBAC groups. Accepts tagged RBAC group ID
+            #
+            # @param slack_channel_ids [Array<String>, nil] Filter to usage originating from specific Slack channels. Use `group*by[]=slack*
+            #
+            # @param speeds [Array<Symbol, Anthropic::Models::Beta::Organization::Analytics::UserCostReportListParams::Speed>, nil] Filter to fast or standard inference mode. Use `group_by[]=speed` to break out p
+            #
+            # @param user_ids [Array<String>, nil] Filter to specific users by tagged user ID.
+            #
+            # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
+            #
+            # @return [Anthropic::Internal::PageCursor<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(
+                method: :get,
+                path: "v1/organizations/analytics/user_cost_report?beta=true",
+                query: query,
+                page: Anthropic::Internal::PageCursor,
+                model: Anthropic::Beta::Organization::BetaAnalyticsCostUsersItem,
+                options: 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/user_usage_report.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Resources
+    class Beta
+      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.
+            #
+            # Some parameter documentations has been truncated, see
+            # {Anthropic::Models::Beta::Organization::Analytics::UserUsageReportListParams}
+            # for more details.
+            #
+            # @overload list(starting_at:, bucket_width: nil, claude_tag_categories: nil, claude_tag_user_ids: nil, context_windows: nil, ending_at: 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, slack_channel_ids: nil, speeds: nil, user_ids: nil, request_options: {})
+            #
+            # @param starting_at [Time] Start of range, inclusive. RFC 3339 tz-aware. Must be within the last 365 days a
+            #
+            # @param bucket_width [Symbol, Anthropic::Models::Beta::Organization::Analytics::UserUsageReportListParams::BucketWidth, nil] Time-bucket granularity. When set, each row's `starting_at` and `ending_at` are
+            #
+            # @param claude_tag_categories [Array<Symbol, Anthropic::Models::Beta::Organization::BetaAnalyticsClaudeTagCategory>, nil] Filter to Claude Tag (Claude in Slack) usage in specific spend categories. Usage
+            #
+            # @param claude_tag_user_ids [Array<String>, nil] Filter to Claude Tag (Claude in Slack) usage attributed to specific Slack users,
+            #
+            # @param context_windows [Array<Symbol, Anthropic::Models::Beta::Organization::BetaAnalyticsContextWindow>, nil] Filter to specific context-window pricing tiers. Use `group_by[]=context_window`
+            #
+            # @param ending_at [Time, nil] End of range, exclusive. When omitted, defaults to the earlier of now and `start
+            #
+            # @param exclude_deleted_users [Boolean] If true, omit rows for users who are deleted (`deleted: true`). A page may conta
+            #
+            # @param group_by [Array<Symbol, Anthropic::Models::Beta::Organization::Analytics::UserUsageReportListParams::GroupBy>, nil] Break each actor's row out by the given dimensions. Accepts the same values as t
+            #
+            # @param inference_geos [Array<Symbol, Anthropic::Models::Beta::Organization::BetaAnalyticsInferenceGeoFilter>, nil] Filter to specific inference regions. `not_available` matches rows where the reg
+            #
+            # @param limit [Integer] Number of rows per page (1-1000, default 20). One row per actor unless `group_by
+            #
+            # @param models [Array<String>, nil] Models to include. Defaults to all models. Use `group_by[]=model` to break out p
+            #
+            # @param order [Symbol, Anthropic::Models::Beta::Organization::Analytics::UserUsageReportListParams::Order] Sort direction. Defaults to `desc`.
+            #
+            # @param order_by [Symbol, Anthropic::Models::Beta::Organization::Analytics::UserUsageReportListParams::OrderBy] Metric to rank actors by. Defaults to `total_tokens`.
+            #
+            # @param page [String, nil] Opaque cursor from a previous response's `next_page` field.
+            #
+            # @param products [Array<Symbol, Anthropic::Models::Beta::Organization::BetaAnalyticsProductFilter>, nil] Product surfaces to include. Defaults to all products.
+            #
+            # @param rbac_group_ids [Array<String>, nil] Filter to usage attributed to specific RBAC groups. Accepts tagged RBAC group ID
+            #
+            # @param slack_channel_ids [Array<String>, nil] Filter to usage originating from specific Slack channels. Use `group*by[]=slack*
+            #
+            # @param speeds [Array<Symbol, Anthropic::Models::Beta::Organization::Analytics::UserUsageReportListParams::Speed>, nil] Filter to fast or standard inference mode. Use `group_by[]=speed` to break out p
+            #
+            # @param user_ids [Array<String>, nil] Filter to specific users by tagged user ID.
+            #
+            # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
+            #
+            # @return [Anthropic::Internal::PageCursor<Anthropic::Models::Beta::Organization::BetaAnalyticsUsageUsersItem>]
+            #
+            # @see Anthropic::Models::Beta::Organization::Analytics::UserUsageReportListParams
+            def list(params)
+              parsed, options =
+                Anthropic::Beta::Organization::Analytics::UserUsageReportListParams.dump_request(params)
+              query = Anthropic::Internal::Util.encode_query_params(parsed)
+              @client.request(
+                method: :get,
+                path: "v1/organizations/analytics/user_usage_report?beta=true",
+                query: query,
+                page: Anthropic::Internal::PageCursor,
+                model: Anthropic::Beta::Organization::BetaAnalyticsUsageUsersItem,
+                options: 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/users.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Resources
+    class Beta
+      class Organization
+        class Analytics
+          class Users
+            # Get per-user activity for a given day, with cursor-based pagination.
+            #
+            # Returns activity metrics for each user in the organization, sorted by email
+            # address. Use `group_by[]` for per-RBAC-group aggregates, or `filter[]` to scope
+            # results to specific members, groups, or a chat project. Available to
+            # organizations on a Claude Enterprise plan. Requires an API key with the
+            # `read:analytics` scope.
+            #
+            # Some parameter documentations has been truncated, see
+            # {Anthropic::Models::Beta::Organization::Analytics::UserListParams} for more
+            # details.
+            #
+            # @overload list(date: nil, ending_date: nil, filter: nil, group_by: nil, limit: nil, order: nil, order_by: nil, page: nil, starting_date: nil, request_options: {})
+            #
+            # @param date [Date, nil] UTC date in YYYY-MM-DD format. The day to get user activity for. Data is typical
+            #
+            # @param ending_date [Date, nil] UTC date in YYYY-MM-DD format. End of the date range (exclusive); only valid wit
+            #
+            # @param filter [Array<String>, nil] Filters as `dimension:value`, e.g. `filter[]=rbac_group_id:{id}`. Repeat the par
+            #
+            # @param group_by [Array<Symbol, Anthropic::Models::Beta::Organization::Analytics::UserListParams::GroupBy>, nil] Dimensions to break results out by (e.g. `group_by[]=rbac_group_id`). Supported
+            #
+            # @param limit [Integer, nil] Number of results per page (1-1000, default 100).
+            #
+            # @param order [Symbol, Anthropic::Models::Beta::Organization::Analytics::UserListParams::Order, nil] Sort direction: `asc` or `desc`. Defaults to `asc` for the endpoint's sort colum
+            #
+            # @param order_by [String, nil] Sort field. Restricted to the endpoint's sort column plus its rankable metrics (
+            #
+            # @param page [String, nil] Opaque cursor from a previous response's `next_page` field.
+            #
+            # @param starting_date [Date, nil] UTC date in YYYY-MM-DD format. Start of a date range (inclusive). Enables rollup
+            #
+            # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
+            #
+            # @return [Anthropic::Internal::PageCursor<Anthropic::Models::Beta::Organization::BetaAnalyticsUserActivity>]
+            #
+            # @see Anthropic::Models::Beta::Organization::Analytics::UserListParams
+            def list(params = {})
+              parsed, options = Anthropic::Beta::Organization::Analytics::UserListParams.dump_request(params)
+              query = Anthropic::Internal::Util.encode_query_params(parsed)
+              @client.request(
+                method: :get,
+                path: "v1/organizations/analytics/users?beta=true",
+                query: query,
+                page: Anthropic::Internal::PageCursor,
+                model: Anthropic::Beta::Organization::BetaAnalyticsUserActivity,
+                options: 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.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Resources
+    class Beta
+      class Organization
+        class Analytics
+          # @return [Anthropic::Resources::Beta::Organization::Analytics::Summaries]
+          attr_reader :summaries
+
+          # @return [Anthropic::Resources::Beta::Organization::Analytics::Users]
+          attr_reader :users
+
+          # @return [Anthropic::Resources::Beta::Organization::Analytics::Apps]
+          attr_reader :apps
+
+          # @return [Anthropic::Resources::Beta::Organization::Analytics::Connectors]
+          attr_reader :connectors
+
+          # @return [Anthropic::Resources::Beta::Organization::Analytics::Plugins]
+          attr_reader :plugins
+
+          # @return [Anthropic::Resources::Beta::Organization::Analytics::Skills]
+          attr_reader :skills
+
+          # @return [Anthropic::Resources::Beta::Organization::Analytics::Artifacts]
+          attr_reader :artifacts
+
+          # @return [Anthropic::Resources::Beta::Organization::Analytics::UsageReport]
+          attr_reader :usage_report
+
+          # @return [Anthropic::Resources::Beta::Organization::Analytics::UserUsageReport]
+          attr_reader :user_usage_report
+
+          # @return [Anthropic::Resources::Beta::Organization::Analytics::CostReport]
+          attr_reader :cost_report
+
+          # @return [Anthropic::Resources::Beta::Organization::Analytics::UserCostReport]
+          attr_reader :user_cost_report
+
+          # @api private
+          #
+          # @param client [Anthropic::Client]
+          def initialize(client:)
+            @client = client
+            @summaries = Anthropic::Resources::Beta::Organization::Analytics::Summaries.new(client: client)
+            @users = Anthropic::Resources::Beta::Organization::Analytics::Users.new(client: client)
+            @apps = Anthropic::Resources::Beta::Organization::Analytics::Apps.new(client: client)
+            @connectors = Anthropic::Resources::Beta::Organization::Analytics::Connectors.new(client: client)
+            @plugins = Anthropic::Resources::Beta::Organization::Analytics::Plugins.new(client: client)
+            @skills = Anthropic::Resources::Beta::Organization::Analytics::Skills.new(client: client)
+            @artifacts = Anthropic::Resources::Beta::Organization::Analytics::Artifacts.new(client: client)
+            @usage_report = Anthropic::Resources::Beta::Organization::Analytics::UsageReport.new(client: client)
+            @user_usage_report =
+              Anthropic::Resources::Beta::Organization::Analytics::UserUsageReport.new(client: client)
+            @cost_report = Anthropic::Resources::Beta::Organization::Analytics::CostReport.new(client: client)
+            @user_cost_report =
+              Anthropic::Resources::Beta::Organization::Analytics::UserCostReport.new(client: client)
+          end
+        end
+      end
+    end
+  end
+end