anthropic 1.74.0 → 1.76.0

data/lib/anthropic/models/beta/organization/analytics/plugin_list_params.rb

@@ -0,0 +1,166 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      module Organization
+        module Analytics
+          # @see Anthropic::Resources::Beta::Organization::Analytics::Plugins#list
+          class PluginListParams < Anthropic::Internal::Type::BaseModel
+            extend Anthropic::Internal::Type::RequestParameters::Converter
+            include Anthropic::Internal::Type::RequestParameters
+
+            # @!attribute date
+            #   UTC date in YYYY-MM-DD format. The day to get plugin usage for. Data is
+            #   typically available with a 1-day lag (varies by query; the error for a
+            #   too-recent date names the latest available day) and may be revised by a few
+            #   percent over the following days. No earlier than 2026-01-01.
+            #
+            #   @return [Date, nil]
+            optional :date, Date, nil?: true
+
+            # @!attribute ending_date
+            #   UTC date in YYYY-MM-DD format. End of the date range (exclusive); only valid
+            #   with `starting_date`. Data is typically available with a 1-day lag (varies by
+            #   query; the error for a too-recent date names the latest available day), so this
+            #   can be at most today — which is also the default when omitted, resolved once
+            #   when the first page is served and reused for the rest of the pagination
+            #   sequence. At most 366 days after `starting_date`.
+            #
+            #   @return [Date, nil]
+            optional :ending_date, Date, nil?: true
+
+            # @!attribute filter
+            #   Filters as `dimension:value`, e.g. `filter[]=rbac_group_id:{id}`. Repeat the
+            #   param for OR within a dimension and across dimensions for AND. Supported
+            #   dimensions on this endpoint: `plugin_name`, `product`, `rbac_group_id`,
+            #   `user_id`. Value forms: `plugin_name` matches case-insensitively; `product` is
+            #   `claude_code` or `cowork` (the only surfaces with plugin attribution);
+            #   `rbac_group_id` takes the tagged id (`rbac_group_...`, as emitted in responses
+            #   and by the spend-limits API) or a bare group UUID, and matches users who held
+            #   the group at any point during each covered UTC day (time-of-usage attribution);
+            #   `user_id` takes a tagged user id (`user_...`), as emitted in responses. An
+            #   unsupported dimension returns 400. At most 100 entries.
+            #
+            #   @return [Array<String>, nil]
+            optional :filter, Anthropic::Internal::Type::ArrayOf[String], nil?: true
+
+            # @!attribute group_by
+            #   Dimensions to break results out by (e.g. `group_by[]=user_id`). Supported on
+            #   this endpoint: `product`, `rbac_group_id`, `user_id`. On this endpoint `product`
+            #   takes the values `claude_code` or `cowork` only (the surfaces with plugin
+            #   attribution). Grouped rows carry the requested dimension values as additional
+            #   fields and paginate like ungrouped responses via `next_page`; an unsupported
+            #   dimension returns 400. `rbac_group_id` attributes a user to every group they
+            #   held at any point during each covered UTC day, so grouped rows are not an
+            #   exclusive partition and can sum above org-level totals. At most 100 entries.
+            #
+            #   @return [Array<Symbol, Anthropic::Models::Beta::Organization::Analytics::PluginListParams::GroupBy>, nil]
+            optional :group_by,
+                     -> {
+                       Anthropic::Internal::Type::ArrayOf[enum: Anthropic::Beta::Organization::Analytics::PluginListParams::GroupBy]
+                     },
+                     nil?: true
+
+            # @!attribute limit
+            #   Number of results per page (1-1000, default 100).
+            #
+            #   @return [Integer, nil]
+            optional :limit, Integer, nil?: true
+
+            # @!attribute order
+            #   Sort direction: `asc` or `desc`. Defaults to `asc` for the endpoint's sort
+            #   column and to `desc` when `order_by` names a metric (a top-N ranking). Applies
+            #   to `order_by`, or to the endpoint's default sort field when `order_by` is
+            #   omitted.
+            #
+            #   @return [Symbol, Anthropic::Models::Beta::Organization::Analytics::PluginListParams::Order, nil]
+            optional :order,
+                     enum: -> { Anthropic::Beta::Organization::Analytics::PluginListParams::Order },
+                     nil?: true
+
+            # @!attribute order_by
+            #   Sort field. Restricted to the endpoint's sort column plus its rankable metrics
+            #   (metrics default to descending; a few metrics rank in date-range mode only, per
+            #   the endpoint's documented orderable set).
+            #
+            #   @return [String, nil]
+            optional :order_by, String, nil?: true
+
+            # @!attribute page
+            #   Opaque cursor from a previous response's `next_page` field.
+            #
+            #   @return [String, nil]
+            optional :page, String, nil?: true
+
+            # @!attribute starting_date
+            #   UTC date in YYYY-MM-DD format. Start of a date range (inclusive). Enables rollup
+            #   mode: one row per entity aggregated over the whole range — addable counters are
+            #   summed across days, and a distinct count is never summed where summing could
+            #   double-count (a field's range value is recomputed exactly over the window,
+            #   approximate via HLL with typical error under 2%, null, or — for the
+            #   creation-event counts, whose per-day values cannot overlap — a per-day sum that
+            #   is itself exact; each field's own description says which). Use either `date` or
+            #   `starting_date`, not both. Data is typically available with a 1-day lag (varies
+            #   by query; the error for a too-recent date names the latest available day) and
+            #   may be revised by a few percent over the following days. No earlier than
+            #   2026-01-01.
+            #
+            #   @return [Date, nil]
+            optional :starting_date, Date, nil?: true
+
+            # @!method initialize(date: nil, ending_date: nil, filter: nil, group_by: nil, limit: nil, order: nil, order_by: nil, page: nil, starting_date: nil, request_options: {})
+            #   Some parameter documentations has been truncated, see
+            #   {Anthropic::Models::Beta::Organization::Analytics::PluginListParams} for more
+            #   details.
+            #
+            #   @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}]
+
+            module GroupBy
+              extend Anthropic::Internal::Type::Enum
+
+              PRODUCT = :product
+              RBAC_GROUP_ID = :rbac_group_id
+              USER_ID = :user_id
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+
+            # Sort direction: `asc` or `desc`. Defaults to `asc` for the endpoint's sort
+            # column and to `desc` when `order_by` names a metric (a top-N ranking). Applies
+            # to `order_by`, or to the endpoint's default sort field when `order_by` is
+            # omitted.
+            module Order
+              extend Anthropic::Internal::Type::Enum
+
+              ASC = :asc
+              DESC = :desc
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/anthropic/models/beta/organization/analytics/skill_list_params.rb

@@ -0,0 +1,168 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      module Organization
+        module Analytics
+          # @see Anthropic::Resources::Beta::Organization::Analytics::Skills#list
+          class SkillListParams < Anthropic::Internal::Type::BaseModel
+            extend Anthropic::Internal::Type::RequestParameters::Converter
+            include Anthropic::Internal::Type::RequestParameters
+
+            # @!attribute date
+            #   UTC date in YYYY-MM-DD format. The day to get skill usage for. Data is typically
+            #   available with a 1-day lag (varies by query; the error for a too-recent date
+            #   names the latest available day) and may be revised by a few percent over the
+            #   following days. No earlier than 2026-01-01.
+            #
+            #   @return [Date, nil]
+            optional :date, Date, nil?: true
+
+            # @!attribute ending_date
+            #   UTC date in YYYY-MM-DD format. End of the date range (exclusive); only valid
+            #   with `starting_date`. Data is typically available with a 1-day lag (varies by
+            #   query; the error for a too-recent date names the latest available day), so this
+            #   can be at most today — which is also the default when omitted, resolved once
+            #   when the first page is served and reused for the rest of the pagination
+            #   sequence. At most 366 days after `starting_date`.
+            #
+            #   @return [Date, nil]
+            optional :ending_date, Date, nil?: true
+
+            # @!attribute filter
+            #   Filters as `dimension:value`, e.g. `filter[]=rbac_group_id:{id}`. Repeat the
+            #   param for OR within a dimension and across dimensions for AND. Supported
+            #   dimensions on this endpoint: `product`, `rbac_group_id`, `share_status`,
+            #   `skill_name`, `user_id`. Value forms: `product` is one of `chat`, `claude_code`,
+            #   `cowork`, or `office_agent`; `rbac_group_id` takes the tagged id
+            #   (`rbac_group_...`, as emitted in responses and by the spend-limits API) or a
+            #   bare group UUID, and matches users who held the group at any point during each
+            #   covered UTC day (time-of-usage attribution); `share_status` is one of
+            #   `organization`, `private`, or `public`; `skill_name` matches case-insensitively;
+            #   `user_id` takes a tagged user id (`user_...`), as emitted in responses. An
+            #   unsupported dimension returns 400. At most 100 entries.
+            #
+            #   @return [Array<String>, nil]
+            optional :filter, Anthropic::Internal::Type::ArrayOf[String], nil?: true
+
+            # @!attribute group_by
+            #   Dimensions to break results out by (e.g. `group_by[]=user_id`). Supported on
+            #   this endpoint: `product`, `rbac_group_id`, `user_id`. Grouped rows carry the
+            #   requested dimension values as additional fields and paginate like ungrouped
+            #   responses via `next_page`; an unsupported dimension returns 400. `rbac_group_id`
+            #   attributes a user to every group they held at any point during each covered UTC
+            #   day, so grouped rows are not an exclusive partition and can sum above org-level
+            #   totals. At most 100 entries.
+            #
+            #   @return [Array<Symbol, Anthropic::Models::Beta::Organization::Analytics::SkillListParams::GroupBy>, nil]
+            optional :group_by,
+                     -> {
+                       Anthropic::Internal::Type::ArrayOf[enum: Anthropic::Beta::Organization::Analytics::SkillListParams::GroupBy]
+                     },
+                     nil?: true
+
+            # @!attribute limit
+            #   Number of results per page (1-1000, default 100).
+            #
+            #   @return [Integer, nil]
+            optional :limit, Integer, nil?: true
+
+            # @!attribute order
+            #   Sort direction: `asc` or `desc`. Defaults to `asc` for the endpoint's sort
+            #   column and to `desc` when `order_by` names a metric (a top-N ranking). Applies
+            #   to `order_by`, or to the endpoint's default sort field when `order_by` is
+            #   omitted.
+            #
+            #   @return [Symbol, Anthropic::Models::Beta::Organization::Analytics::SkillListParams::Order, nil]
+            optional :order,
+                     enum: -> {
+                       Anthropic::Beta::Organization::Analytics::SkillListParams::Order
+                     },
+                     nil?: true
+
+            # @!attribute order_by
+            #   Sort field. Restricted to the endpoint's sort column plus its rankable metrics
+            #   (metrics default to descending; a few metrics rank in date-range mode only, per
+            #   the endpoint's documented orderable set).
+            #
+            #   @return [String, nil]
+            optional :order_by, String, nil?: true
+
+            # @!attribute page
+            #   Opaque cursor from a previous response's `next_page` field.
+            #
+            #   @return [String, nil]
+            optional :page, String, nil?: true
+
+            # @!attribute starting_date
+            #   UTC date in YYYY-MM-DD format. Start of a date range (inclusive). Enables rollup
+            #   mode: one row per entity aggregated over the whole range — addable counters are
+            #   summed across days, and a distinct count is never summed where summing could
+            #   double-count (a field's range value is recomputed exactly over the window,
+            #   approximate via HLL with typical error under 2%, null, or — for the
+            #   creation-event counts, whose per-day values cannot overlap — a per-day sum that
+            #   is itself exact; each field's own description says which). Use either `date` or
+            #   `starting_date`, not both. Data is typically available with a 1-day lag (varies
+            #   by query; the error for a too-recent date names the latest available day) and
+            #   may be revised by a few percent over the following days. No earlier than
+            #   2026-01-01.
+            #
+            #   @return [Date, nil]
+            optional :starting_date, Date, nil?: true
+
+            # @!method initialize(date: nil, ending_date: nil, filter: nil, group_by: nil, limit: nil, order: nil, order_by: nil, page: nil, starting_date: nil, request_options: {})
+            #   Some parameter documentations has been truncated, see
+            #   {Anthropic::Models::Beta::Organization::Analytics::SkillListParams} for more
+            #   details.
+            #
+            #   @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}]
+
+            module GroupBy
+              extend Anthropic::Internal::Type::Enum
+
+              PRODUCT = :product
+              RBAC_GROUP_ID = :rbac_group_id
+              USER_ID = :user_id
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+
+            # Sort direction: `asc` or `desc`. Defaults to `asc` for the endpoint's sort
+            # column and to `desc` when `order_by` names a metric (a top-N ranking). Applies
+            # to `order_by`, or to the endpoint's default sort field when `order_by` is
+            # omitted.
+            module Order
+              extend Anthropic::Internal::Type::Enum
+
+              ASC = :asc
+              DESC = :desc
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/anthropic/models/beta/organization/analytics/summary_list_params.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      module Organization
+        module Analytics
+          # @see Anthropic::Resources::Beta::Organization::Analytics::Summaries#list
+          class SummaryListParams < Anthropic::Internal::Type::BaseModel
+            extend Anthropic::Internal::Type::RequestParameters::Converter
+            include Anthropic::Internal::Type::RequestParameters
+
+            # @!attribute starting_date
+            #   UTC date in YYYY-MM-DD format. Start of the date range (inclusive). Data is
+            #   typically available with a 1-day lag (varies by query; the error for a
+            #   too-recent date names the latest available day) and may be revised by a few
+            #   percent over the following days. No earlier than 2026-01-01.
+            #
+            #   @return [Date]
+            required :starting_date, Date
+
+            # @!attribute ending_date
+            #   UTC date in YYYY-MM-DD format. End of the date range (exclusive). Data is
+            #   typically available with a 1-day lag, so this can be at most today — which is
+            #   also the default when omitted, making the last entry cover the most recent
+            #   available day. Data may be revised by a few percent over the following days. The
+            #   range may span at most 366 days.
+            #
+            #   @return [Date, nil]
+            optional :ending_date, Date, nil?: true
+
+            # @!attribute filter
+            #   Filters as `dimension:value`. Only `rbac_group_id` is supported (e.g.
+            #   `filter[]=rbac_group_id:{id}`); repeat the param to OR across groups. Scopes the
+            #   whole day series to members of the matching group(s), re-aggregated from
+            #   member-level activity — org-wide seat/invite fields and the adoption rates
+            #   derived from them are null on scoped rows. `rbac_group_id` accepts the tagged id
+            #   (`rbac_group_...`, as emitted in responses and by the spend-limits API) or a
+            #   bare group UUID, and matches users who held the group at any point during each
+            #   UTC day (time-of-usage attribution). At most 100 entries.
+            #
+            #   @return [Array<String>, nil]
+            optional :filter, Anthropic::Internal::Type::ArrayOf[String], nil?: true
+
+            # @!attribute limit
+            #   Number of results per page (1-1000, default 100). The day series (at most 366
+            #   entries) is currently returned in full in a single page, so `limit` does not yet
+            #   shorten it.
+            #
+            #   @return [Integer, nil]
+            optional :limit, Integer, nil?: true
+
+            # @!attribute page
+            #   Opaque cursor from a previous response's `next_page` field. `next_page` is
+            #   currently always null, so there is never a cursor to send.
+            #
+            #   @return [String, nil]
+            optional :page, String, nil?: true
+
+            # @!method initialize(starting_date:, ending_date: nil, filter: nil, limit: nil, page: nil, request_options: {})
+            #   Some parameter documentations has been truncated, see
+            #   {Anthropic::Models::Beta::Organization::Analytics::SummaryListParams} for more
+            #   details.
+            #
+            #   @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}]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/anthropic/models/beta/organization/analytics/usage_report_list_params.rb

@@ -0,0 +1,239 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      module Organization
+        module Analytics
+          # @see Anthropic::Resources::Beta::Organization::Analytics::UsageReport#list
+          class UsageReportListParams < Anthropic::Internal::Type::BaseModel
+            extend Anthropic::Internal::Type::RequestParameters::Converter
+            include Anthropic::Internal::Type::RequestParameters
+
+            # @!attribute starting_at
+            #   Start of range, inclusive. RFC 3339 tz-aware. Must be within the last 365 days
+            #   and no earlier than 2026-01-01T00:00:00Z.
+            #
+            #   @return [Time]
+            required :starting_at, Time
+
+            # @!attribute bucket_width
+            #   Time bucket granularity.
+            #
+            #   @return [Symbol, Anthropic::Models::Beta::Organization::Analytics::UsageReportListParams::BucketWidth, nil]
+            optional :bucket_width,
+                     enum: -> { Anthropic::Beta::Organization::Analytics::UsageReportListParams::BucketWidth }
+
+            # @!attribute claude_tag_categories
+            #   Filter to Claude Tag (Claude in Slack) usage in specific spend categories. Usage
+            #   with no category never matches. `dm` usage is reported under the user's product
+            #   rather than `claude-tag`, so combining this filter with `products[]=claude-tag`
+            #   excludes it. Use `group_by[]=claude_tag_category` to break out per-category
+            #   values.
+            #
+            #   @return [Array<Symbol, Anthropic::Models::Beta::Organization::BetaAnalyticsClaudeTagCategory>, nil]
+            optional :claude_tag_categories,
+                     -> {
+                       Anthropic::Internal::Type::ArrayOf[enum: Anthropic::Beta::Organization::BetaAnalyticsClaudeTagCategory]
+                     },
+                     nil?: true
+
+            # @!attribute claude_tag_user_ids
+            #   Filter to Claude Tag (Claude in Slack) usage attributed to specific Slack users,
+            #   by Slack user ID (for example `U0123ABCDEF`), not claude.ai user ID. Usage that
+            #   is not Claude Tag, and Claude Tag usage not attributed to a single user, never
+            #   matches. Use `group_by[]=claude_tag_user_id` to break out per-user values.
+            #
+            #   @return [Array<String>, nil]
+            optional :claude_tag_user_ids, Anthropic::Internal::Type::ArrayOf[String], nil?: true
+
+            # @!attribute context_windows
+            #   Filter to specific context-window pricing tiers. Use `group_by[]=context_window`
+            #   to break out per-tier values.
+            #
+            #   @return [Array<Symbol, Anthropic::Models::Beta::Organization::BetaAnalyticsContextWindow>, nil]
+            optional :context_windows,
+                     -> {
+                       Anthropic::Internal::Type::ArrayOf[enum: Anthropic::Beta::Organization::BetaAnalyticsContextWindow]
+                     },
+                     nil?: true
+
+            # @!attribute ending_at
+            #   End of range, exclusive. When omitted, defaults to the earlier of now and
+            #   `starting_at` + 31 days. The range may span at most 31 days.
+            #
+            #   @return [Time, nil]
+            optional :ending_at, Time, nil?: true
+
+            # @!attribute group_by
+            #   Dimensions to break each time bucket out by. Defaults to no grouping (one total
+            #   per bucket). Each bucket reports at most its top 100 groups; a group beyond that
+            #   cap has no row in that bucket (there is no remainder row), so grouped buckets
+            #   are not exhaustive when a dimension has more than 100 distinct values.
+            #
+            #   @return [Array<Symbol, Anthropic::Models::Beta::Organization::Analytics::UsageReportListParams::GroupBy>, nil]
+            optional :group_by,
+                     -> {
+                       Anthropic::Internal::Type::ArrayOf[enum: Anthropic::Beta::Organization::Analytics::UsageReportListParams::GroupBy]
+                     },
+                     nil?: true
+
+            # @!attribute inference_geos
+            #   Filter to specific inference regions. `not_available` matches rows where the
+            #   region is unset. Use `group_by[]=inference_geo` to break out per-region values.
+            #
+            #   @return [Array<Symbol, Anthropic::Models::Beta::Organization::BetaAnalyticsInferenceGeoFilter>, nil]
+            optional :inference_geos,
+                     -> {
+                       Anthropic::Internal::Type::ArrayOf[enum: Anthropic::Beta::Organization::BetaAnalyticsInferenceGeoFilter]
+                     },
+                     nil?: true
+
+            # @!attribute limit
+            #   Maximum number of time buckets per page. Defaults and caps vary by
+            #   `bucket_width` (`1d`: default 7, max 31; `1h`: default 24, max 168; `1m`:
+            #   default 60, max 256).
+            #
+            #   @return [Integer, nil]
+            optional :limit, Integer, nil?: true
+
+            # @!attribute models
+            #   Models to include. Defaults to all models. Use `group_by[]=model` to break out
+            #   per-model values.
+            #
+            #   @return [Array<String>, nil]
+            optional :models, Anthropic::Internal::Type::ArrayOf[String], nil?: true
+
+            # @!attribute page
+            #   Opaque cursor from a previous response's `next_page` field.
+            #
+            #   @return [String, nil]
+            optional :page, String, nil?: true
+
+            # @!attribute products
+            #   Product surfaces to include. Defaults to all products. Use `group_by[]=product`
+            #   to break out per-product values.
+            #
+            #   @return [Array<Symbol, Anthropic::Models::Beta::Organization::BetaAnalyticsProductFilter>, nil]
+            optional :products,
+                     -> {
+                       Anthropic::Internal::Type::ArrayOf[enum: Anthropic::Beta::Organization::BetaAnalyticsProductFilter]
+                     },
+                     nil?: true
+
+            # @!attribute rbac_group_ids
+            #   Filter to usage attributed to specific RBAC groups. Accepts tagged RBAC group
+            #   IDs (`rbac_group_...`) or bare group UUIDs. A row matches when the user belonged
+            #   to any of the listed groups on the (UTC) day the usage occurred; usage with no
+            #   group attribution never matches.
+            #
+            #   @return [Array<String>, nil]
+            optional :rbac_group_ids, Anthropic::Internal::Type::ArrayOf[String], nil?: true
+
+            # @!attribute slack_channel_ids
+            #   Filter to usage originating from specific Slack channels. Use
+            #   `group_by[]=slack_channel_id` to break out per-channel values.
+            #
+            #   @return [Array<String>, nil]
+            optional :slack_channel_ids, Anthropic::Internal::Type::ArrayOf[String], nil?: true
+
+            # @!attribute speeds
+            #   Filter to fast or standard inference mode. Use `group_by[]=speed` to break out
+            #   per-mode values.
+            #
+            #   @return [Array<Symbol, Anthropic::Models::Beta::Organization::Analytics::UsageReportListParams::Speed>, nil]
+            optional :speeds,
+                     -> {
+                       Anthropic::Internal::Type::ArrayOf[enum: Anthropic::Beta::Organization::Analytics::UsageReportListParams::Speed]
+                     },
+                     nil?: true
+
+            # @!attribute user_ids
+            #   Filter to specific users by tagged user ID.
+            #
+            #   @return [Array<String>, nil]
+            optional :user_ids, Anthropic::Internal::Type::ArrayOf[String], nil?: true
+
+            # @!method initialize(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: {})
+            #   Some parameter documentations has been truncated, see
+            #   {Anthropic::Models::Beta::Organization::Analytics::UsageReportListParams} for
+            #   more details.
+            #
+            #   @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}]
+
+            # Time bucket granularity.
+            module BucketWidth
+              extend Anthropic::Internal::Type::Enum
+
+              DAY = :"1d"
+              HOUR = :"1h"
+              MINUTE = :"1m"
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+
+            module GroupBy
+              extend Anthropic::Internal::Type::Enum
+
+              CLAUDE_TAG_CATEGORY = :claude_tag_category
+              CLAUDE_TAG_USER_ID = :claude_tag_user_id
+              CONTEXT_WINDOW = :context_window
+              INFERENCE_GEO = :inference_geo
+              MODEL = :model
+              PRODUCT = :product
+              RBAC_GROUP_ID = :rbac_group_id
+              SLACK_CHANNEL_ID = :slack_channel_id
+              SPEED = :speed
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+
+            module Speed
+              extend Anthropic::Internal::Type::Enum
+
+              FAST = :fast
+              STANDARD = :standard
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+          end
+        end
+      end
+    end
+  end
+end