anthropic 1.74.0 → 1.75.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b42acaa5fbcc24fe2574af40d17c100634efb986cf30ee24a5a327f295f6b922
-  data.tar.gz: b456d0a9bf98c97af0788edd55b6fac69c5607f8df31ed178fedca5d7e76eeff
+  metadata.gz: 1f0c8378ce11741b0f54cc6e30a7938642b1342a45cda2a711e61757fbf60348
+  data.tar.gz: 1b1cf5ddfbe56445e6341836e87e0d234b677f21b2192e2d5a2696bf77c205f2
 SHA512:
-  metadata.gz: d998d3c2656dbe442adfb80bbb6c86d2b70e87112a9b06eb2dfa6588bdff72ac5f5a95fc7157f762ba06a5cb9bf13272f88c08a6ca435f1de9e71845626e0d60
-  data.tar.gz: fea464ecbbe55f09643d33a9d4ac92f2d8355dc7364c5fac63d30707ec99b6da7f48e8c9413e4bda296154205de9b674b84db8c993a88c62b0c4f76a6781be00
+  metadata.gz: 88dd297f1f15fb01c7aa6bf19afc886d220f37314de35ff45f045ca00ec476c704d90e7bdbdedfdbe5ca792c3654530be473dc022acf93385b0abfaef0f0ccee
+  data.tar.gz: 66ea4c3da5ad8ab2c03a117fca7f095ca86833610a68d381514f461046d5dc3911ec4994958dac29f6c7f32d419416166e6cb52cf7eb51968463dce8d06bfaf5

data/CHANGELOG.md

@@ -1,5 +1,39 @@
 # Changelog
 
+## 1.75.0 (2026-09-30)
+
+Full Changelog: [v1.74.0...v1.75.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.74.0...v1.75.0)
+
+### Features
+
+* **api:** add a refusal stop reason and stop_details to Managed Agents session idle events ([a5587ce](https://github.com/anthropics/anthropic-sdk-ruby/commit/a5587ceb0b14fb7935066765062ac5c952c8c5a4))
+* **api:** add Claude Enterprise analytics, spend limits, and RBAC groups and roles to the Admin API ([a9d2688](https://github.com/anthropics/anthropic-sdk-ruby/commit/a9d2688be21ec6e92d05a1a789fd14db82e802e4))
+* **api:** add per-user usage and cost reports to the Admin API analytics ([eee8b24](https://github.com/anthropics/anthropic-sdk-ruby/commit/eee8b2456ce492f6defe0c3167842892db58b2d6))
+* **api:** add Plugins and Plugin Marketplaces to the Admin API ([0f337ed](https://github.com/anthropics/anthropic-sdk-ruby/commit/0f337edfc7c1c2eb6458edf3d71957099d9df1e5))
+* **api:** add repository error types to Managed Agents session errors ([a20b377](https://github.com/anthropics/anthropic-sdk-ruby/commit/a20b3775dfb3d54c2ba06237cb252cb8d3bf10e2))
+* **api:** allow removing a plugin's org-wide installation setting ([3abdc63](https://github.com/anthropics/anthropic-sdk-ruby/commit/3abdc639c68a517ce3d2562edf369c288c4b4d3d))
+* **api:** MCP tunnels beta: add read-only `transport` object to Tunnel and return the one-time relay `token` in the create response ([96baeba](https://github.com/anthropics/anthropic-sdk-ruby/commit/96baebad52edd7025cc280247c285574a1390cf3))
+* **api:** Organization API endpoints are now GA ([82192cb](https://github.com/anthropics/anthropic-sdk-ruby/commit/82192cbd9bc41a89e73873d0bfa59452035540ff))
+
+
+### Bug Fixes
+
+* **api:** make memory store description, metadata, archived_at required ([7cc1024](https://github.com/anthropics/anthropic-sdk-ruby/commit/7cc1024dc7994dd747b8b6d42f4e3beca41952a4))
+* **api:** type admin plugin preference and marketplace fields as enums ([735f79c](https://github.com/anthropics/anthropic-sdk-ruby/commit/735f79c3be5f9a38530aeaaa289518eab42e91ca))
+* **client:** respect a client-level timeout instead of the per-method default ([20c7d65](https://github.com/anthropics/anthropic-sdk-ruby/commit/20c7d659ff96a752985df2f800c1449c1a90f5e5))
+* **pagination:** auto-paging continues past an empty page while next_page is set ([e2817b4](https://github.com/anthropics/anthropic-sdk-ruby/commit/e2817b4ea1165ed808359e4007f7d16a4e53f75d))
+
+
+### Chores
+
+* **api:** update MCP Tunnels types and descriptions ([9091ecf](https://github.com/anthropics/anthropic-sdk-ruby/commit/9091ecf0aab16ba3dac3c7418e350a9f087adcd2))
+* **docs:** remove placeholder enum descriptions ([489541b](https://github.com/anthropics/anthropic-sdk-ruby/commit/489541b6efa8d9a422cdee2a1a24922691c0a6fe))
+
+
+### Documentation
+
+* **examples:** stop reading session events on any idle that needs no action ([#278](https://github.com/anthropics/anthropic-sdk-ruby/issues/278)) ([5143cfd](https://github.com/anthropics/anthropic-sdk-ruby/commit/5143cfdd19a0905e69bf3c9de2c97f39dd5b32bf))
+
 ## 1.74.0 (2026-09-28)
 
 Full Changelog: [v1.73.0...v1.74.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.73.0...v1.74.0)

data/README.md

@@ -15,7 +15,7 @@ Add to your application's Gemfile:
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "anthropic", "~> 1.74.0"
+gem "anthropic", "~> 1.75.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/anthropic/client.rb

@@ -82,6 +82,9 @@ module Anthropic
     # @return [Anthropic::Resources::Skills]
     attr_reader :skills
 
+    # @return [Anthropic::Resources::Organization]
+    attr_reader :organization
+
     # @return [Anthropic::Resources::Beta]
     attr_reader :beta
 
@@ -125,6 +128,11 @@ module Anthropic
       DEFAULT_TIMEOUT_IN_SECONDS
     end
 
+    # @api private
+    #
+    # @return [Boolean]
+    def timeout_overridden? = @timeout_overridden
+
     # Creates and returns a new client for interacting with the API.
     #
     # Credential precedence, matching the credential-resolution spec and
@@ -179,7 +187,8 @@ module Anthropic
     #
     # @param max_retries [Integer] Max number of retries to attempt after a failed retryable request.
     #
-    # @param timeout [Float]
+    # @param timeout [Float, nil] Request timeout in seconds. Defaults to
+    # `Anthropic::Client::DEFAULT_TIMEOUT_IN_SECONDS` when `nil`.
     #
     # @param initial_retry_delay [Float]
     #
@@ -197,11 +206,14 @@ module Anthropic
       base_url: nil,
       proxy: nil,
       max_retries: self.class::DEFAULT_MAX_RETRIES,
-      timeout: self.class::DEFAULT_TIMEOUT_IN_SECONDS,
+      timeout: nil,
       initial_retry_delay: self.class::DEFAULT_INITIAL_RETRY_DELAY,
       max_retry_delay: self.class::DEFAULT_MAX_RETRY_DELAY,
       middleware: nil
     )
+      @timeout_overridden = !timeout.nil?
+      timeout ||= self.class::DEFAULT_TIMEOUT_IN_SECONDS
+
       if config && credentials
         raise ArgumentError, "Pass at most one of `credentials:` or `config:`."
       end
@@ -298,6 +310,7 @@ module Anthropic
       @models = Anthropic::Resources::Models.new(client: self)
       @files = Anthropic::Resources::Files.new(client: self)
       @skills = Anthropic::Resources::Skills.new(client: self)
+      @organization = Anthropic::Resources::Organization.new(client: self)
       @beta = Anthropic::Resources::Beta.new(client: self)
     end
 

data/lib/anthropic/internal/bidirectional_page_cursor.rb

@@ -27,7 +27,7 @@ module Anthropic
 
       # @return [Boolean]
       def next_page?
-        !data.to_a.empty? && !next_page_.to_s.empty?
+        !next_page_.to_s.empty?
       end
 
       # @raise [Anthropic::HTTP::Error]

data/lib/anthropic/internal/page_cursor.rb

@@ -24,7 +24,7 @@ module Anthropic
 
       # @return [Boolean]
       def next_page?
-        !data.to_a.empty? && !next_page_.to_s.empty?
+        !next_page_.to_s.empty?
       end
 
       # @raise [Anthropic::HTTP::Error]

data/lib/anthropic/models/anthropic_beta.rb

@@ -101,6 +101,8 @@ module Anthropic
 
       variant const: -> { Anthropic::Models::AnthropicBeta::MCP_CLIENT_2026_09_15 }
 
+      variant const: -> { Anthropic::Models::AnthropicBeta::CE_PLUGINS_2026_09_01 }
+
       variant String
 
       # @!method self.variants
@@ -160,6 +162,7 @@ module Anthropic
       COMPACT_2026_09_04 = :"compact-2026-09-04"
       INLINE_TOOLS_2026_09_15 = :"inline-tools-2026-09-15"
       MCP_CLIENT_2026_09_15 = :"mcp-client-2026-09-15"
+      CE_PLUGINS_2026_09_01 = :"ce-plugins-2026-09-01"
 
       # @!endgroup
     end

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

@@ -3,7 +3,6 @@
 module Anthropic
   module Models
     module Beta
-      # EventDeltaType enum
       module BetaManagedAgentsDeltaType
         extend Anthropic::Internal::Type::Enum
 

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

@@ -13,12 +13,36 @@ module Anthropic
         #   @return [String]
         required :id, String
 
+        # @!attribute archived_at
+        #   Timestamp when the store was archived, or `null` if active. Set once and never
+        #   cleared; archiving is one-way. Archived stores are read-only and cannot be
+        #   attached to new sessions.
+        #
+        #   @return [Time, nil]
+        required :archived_at, Time, nil?: true
+
         # @!attribute created_at
         #   Timestamp when the store was created.
         #
         #   @return [Time]
         required :created_at, Time
 
+        # @!attribute description
+        #   Free-text description of what the store contains, up to 1024 characters.
+        #   Included in the agent's system prompt when the store is attached, so word it to
+        #   be useful to the agent. Empty string when unset.
+        #
+        #   @return [String]
+        required :description, String
+
+        # @!attribute metadata
+        #   Arbitrary key-value tags for your own bookkeeping (such as the end user a store
+        #   belongs to). Up to 16 pairs; keys 1–64 characters; values up to 512 characters.
+        #   Returned on retrieve/list but not filterable.
+        #
+        #   @return [Hash{Symbol=>String}]
+        required :metadata, Anthropic::Internal::Type::HashOf[String]
+
         # @!attribute name
         #   Human-readable name for the store. 1–255 characters. The store's mount-path slug
         #   under `/mnt/memory/` is derived from this name.
@@ -38,31 +62,7 @@ module Anthropic
         #   @return [Time]
         required :updated_at, Time
 
-        # @!attribute archived_at
-        #   Timestamp when the store was archived, or `null` if active. Set once and never
-        #   cleared; archiving is one-way. Archived stores are read-only and cannot be
-        #   attached to new sessions.
-        #
-        #   @return [Time, nil]
-        optional :archived_at, Time, nil?: true
-
-        # @!attribute description
-        #   Free-text description of what the store contains, up to 1024 characters.
-        #   Included in the agent's system prompt when the store is attached, so word it to
-        #   be useful to the agent. Empty string when unset.
-        #
-        #   @return [String, nil]
-        optional :description, String
-
-        # @!attribute metadata
-        #   Arbitrary key-value tags for your own bookkeeping (such as the end user a store
-        #   belongs to). Up to 16 pairs; keys 1–64 characters; values up to 512 characters.
-        #   Returned on retrieve/list but not filterable.
-        #
-        #   @return [Hash{Symbol=>String}, nil]
-        optional :metadata, Anthropic::Internal::Type::HashOf[String]
-
-        # @!method initialize(id:, created_at:, name:, type:, updated_at:, archived_at: nil, description: nil, metadata: nil)
+        # @!method initialize(id:, archived_at:, created_at:, description:, metadata:, name:, type:, updated_at:)
         #   A `memory_store`: a named container for agent memories, scoped to a workspace.
         #   Attach a store to a session via `resources[]` to mount it as a directory the
         #   agent can read and write.
@@ -72,19 +72,19 @@ module Anthropic
         #
         #   @param id [String] Unique identifier for the memory store (a `memstore_...` tagged ID). Use this wh
         #
+        #   @param archived_at [Time, nil] Timestamp when the store was archived, or `null` if active. Set once and never c
+        #
         #   @param created_at [Time] Timestamp when the store was created.
         #
+        #   @param description [String] Free-text description of what the store contains, up to 1024 characters. Include
+        #
+        #   @param metadata [Hash{Symbol=>String}] Arbitrary key-value tags for your own bookkeeping (such as the end user a store
+        #
         #   @param name [String] Human-readable name for the store. 1–255 characters. The store's mount-path slug
         #
         #   @param type [Symbol, Anthropic::Models::Beta::BetaManagedAgentsMemoryStore::Type]
         #
         #   @param updated_at [Time] Timestamp when the store's `name`, `description`, or `metadata` was last modifie
-        #
-        #   @param archived_at [Time, nil] Timestamp when the store was archived, or `null` if active. Set once and never c
-        #
-        #   @param description [String] Free-text description of what the store contains, up to 1024 characters. Include
-        #
-        #   @param metadata [Hash{Symbol=>String}] Arbitrary key-value tags for your own bookkeeping (such as the end user a store
 
         # @see Anthropic::Models::Beta::BetaManagedAgentsMemoryStore#type
         module Type

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

@@ -66,7 +66,6 @@ module Anthropic
         required :stats, -> { Anthropic::Beta::BetaManagedAgentsSessionStats }
 
         # @!attribute status
-        #   SessionStatus enum
         #
         #   @return [Symbol, Anthropic::Models::Beta::BetaManagedAgentsSession::Status]
         required :status, enum: -> { Anthropic::Beta::BetaManagedAgentsSession::Status }
@@ -133,7 +132,7 @@ module Anthropic
         #
         #   @param stats [Anthropic::Models::Beta::BetaManagedAgentsSessionStats] Timing statistics for the session.
         #
-        #   @param status [Symbol, Anthropic::Models::Beta::BetaManagedAgentsSession::Status] SessionStatus enum
+        #   @param status [Symbol, Anthropic::Models::Beta::BetaManagedAgentsSession::Status]
         #
         #   @param title [String, nil]
         #
@@ -147,8 +146,6 @@ module Anthropic
         #
         #   @param deployment_id [String, nil] Deployment ID when the session was created from a deployment reference. Null oth
 
-        # SessionStatus enum
-        #
         # @see Anthropic::Models::Beta::BetaManagedAgentsSession#status
         module Status
           extend Anthropic::Internal::Type::Enum

data/lib/anthropic/models/beta/organization/analytics/apps/chat/project_list_params.rb

@@ -0,0 +1,169 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      module Organization
+        module Analytics
+          module Apps
+            module Chat
+              # @see Anthropic::Resources::Beta::Organization::Analytics::Apps::Chat::Projects#list
+              class ProjectListParams < 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 project activity 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: `project_id`, `rbac_group_id`, `user_id`. Value
+                #   forms: `project_id` takes a tagged project id (`claude_proj_...`);
+                #   `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: `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::Apps::Chat::ProjectListParams::GroupBy>, nil]
+                optional :group_by,
+                         -> {
+                           Anthropic::Internal::Type::ArrayOf[enum: Anthropic::Beta::Organization::Analytics::Apps::Chat::ProjectListParams::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::Apps::Chat::ProjectListParams::Order, nil]
+                optional :order,
+                         enum: -> {
+                           Anthropic::Beta::Organization::Analytics::Apps::Chat::ProjectListParams::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::Apps::Chat::ProjectListParams}
+                #   for more details.
+                #
+                #   @param date [Date, nil] UTC date in YYYY-MM-DD format. The day to get project activity for. Data is typi
+                #
+                #   @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::Apps::Chat::ProjectListParams::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::Apps::Chat::ProjectListParams::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
+
+                  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
+  end
+end

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

@@ -0,0 +1,101 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      module Organization
+        module Analytics
+          # @see Anthropic::Resources::Beta::Organization::Analytics::Artifacts#list
+          class ArtifactListParams < 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 artifact activity 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]
+            required :date, Date
+
+            # @!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: `artifact_type`, `is_shared`, `product`,
+            #   `rbac_group_id`, `user_id`. Value forms: `artifact_type` is a canonical artifact
+            #   MIME type (e.g. `text/markdown`) or `other`; `is_shared` is `true` or `false`;
+            #   `product` is `chat`, `claude_code`, or `cowork` (the surfaces that create
+            #   artifacts); `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: `product`, `user_id` and/or `rbac_group_id`.
+            #   The ungrouped artifact-type cube is finite and returned in full; grouped queries
+            #   multiply the cube and paginate via `next_page`. `product` takes the values
+            #   `chat`, `claude_code`, or `cowork` (the surfaces that create artifacts).
+            #   `rbac_group_id` attributes a user to every group they held at any point during
+            #   the requested UTC day, so grouped rows are not an exclusive partition. At most
+            #   100 entries.
+            #
+            #   @return [Array<Symbol, Anthropic::Models::Beta::Organization::Analytics::ArtifactListParams::GroupBy>, nil]
+            optional :group_by,
+                     -> {
+                       Anthropic::Internal::Type::ArrayOf[enum: Anthropic::Beta::Organization::Analytics::ArtifactListParams::GroupBy]
+                     },
+                     nil?: true
+
+            # @!attribute limit
+            #   Maximum rows to return (1-1000, default 100). The ungrouped artifact-type cube
+            #   is finite and returned in full; `limit` is the page size only when `group_by[]`
+            #   multiplies the cube.
+            #
+            #   @return [Integer, nil]
+            optional :limit, Integer, nil?: true
+
+            # @!attribute page
+            #   Opaque cursor from a previous response's `next_page` field. Only valid with
+            #   `group_by[]` — the ungrouped cube is never paginated.
+            #
+            #   @return [String, nil]
+            optional :page, String, nil?: true
+
+            # @!method initialize(date:, filter: nil, group_by: nil, limit: nil, page: nil, request_options: {})
+            #   Some parameter documentations has been truncated, see
+            #   {Anthropic::Models::Beta::Organization::Analytics::ArtifactListParams} for more
+            #   details.
+            #
+            #   @param date [Date] UTC date in YYYY-MM-DD format. The day to get artifact activity for. Data is typ
+            #
+            #   @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::ArtifactListParams::GroupBy>, nil] Dimensions to break results out by: `product`, `user_id` and/or `rbac_group_id`.
+            #
+            #   @param limit [Integer, nil] Maximum rows to return (1-1000, default 100). The ungrouped artifact-type cube i
+            #
+            #   @param page [String, nil] Opaque cursor from a previous response's `next_page` field. Only valid with `gro
+            #
+            #   @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
+          end
+        end
+      end
+    end
+  end
+end