stigg 0.1.0.pre.beta.44 → 0.1.0.pre.beta.45

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6db024a60e1adbdbe122e0450c04c41609a556179669277b4812c9d816490c39
-  data.tar.gz: 07655e06beeebad975ed6c4d6634d913924d26b08ccbaf8d4226f39ec587b4cc
+  metadata.gz: 0da22a110fde969a0e632ce47b783952417266a438024c1dd38d5cf37e38a7e0
+  data.tar.gz: 6c0de78da1b5977126515d1b80cff5e2e81aa597e2003ee1be6935b8ac38b119
 SHA512:
-  metadata.gz: 97ea9bb87dca0bcb1e991316027c0edd46c54d152c5c9b20c6cc6671b93414702599b227a9d987141bfff206c6e025feaa5db60f5604047cf1aa2472d214c1d3
-  data.tar.gz: 7df8ede3bf17a5a0c662e48efdf4f2ae1dca7b682397db11721b9eaa09b69f6cb367e1f8ec5799cd77c58361f185f59a449134b630a0f3c0bd5d529860f5d823
+  metadata.gz: cbd490b1fdd8bc95eaf5064f8c6b36f7215c23e72d4988b8b644f73ec8e850e370a008eec865a0ef49430f4b062c72b4855221f959fa30a3ba98e7cdbdc91c81
+  data.tar.gz: 14b9fc61a2c4f90ffd2017cd14947942fd46a0a547815c77f854879d47dcd6fd093a9a3d6c37ca1df85935b841b3a75602532ed47686d9828df5ad11bfe72468

data/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 0.1.0-beta.45 (2026-07-26)
+
+Full Changelog: [v0.1.0-beta.44...v0.1.0-beta.45](https://github.com/stiggio/stigg-ruby/compare/v0.1.0-beta.44...v0.1.0-beta.45)
+
+### Features
+
+* **api:** add credit_entitlement parameter to addon/plan update params ([2ae6de4](https://github.com/stiggio/stigg-ruby/commit/2ae6de4c869d839537de19fcef36469979cccea2))
+
+
+### Chores
+
+* **internal:** regenerate SDK with no functional changes ([0ec3e2e](https://github.com/stiggio/stigg-ruby/commit/0ec3e2e23ee5088f27abeb230a7b695daa362886))
+
 ## 0.1.0-beta.44 (2026-07-21)
 
 Full Changelog: [v0.1.0-beta.43...v0.1.0-beta.44](https://github.com/stiggio/stigg-ruby/compare/v0.1.0-beta.43...v0.1.0-beta.44)

data/README.md

@@ -24,7 +24,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "stigg", "~> 0.1.0.pre.beta.44"
+gem "stigg", "~> 0.1.0.pre.beta.45"
 ```
 
 <!-- x-release-please-end -->

data/lib/stigg/client.rb

@@ -53,7 +53,7 @@ module Stigg
       initial_retry_delay: self.class::DEFAULT_INITIAL_RETRY_DELAY,
       max_retry_delay: self.class::DEFAULT_MAX_RETRY_DELAY
     )
-      base_url ||= "https://edge.api.stigg.io"
+      base_url ||= "https://api.stigg.io"
 
       if api_key.nil?
         raise ArgumentError.new("api_key is required, and can be set via environ: \"STIGG_API_KEY\"")

data/lib/stigg/models/v1/addon_update_params.rb

@@ -400,6 +400,21 @@ module Stigg
                      enum: -> { Stigg::V1::AddonUpdateParams::Charges::OveragePricingModel::BillingCadence },
                      api_name: :billingCadence
 
+            # @!attribute credit_entitlement
+            #   Credit entitlement to grant when a credit overage targets a currency not yet
+            #   granted on the plan
+            #
+            #   @return [Stigg::Models::V1::AddonUpdateParams::Charges::OveragePricingModel::CreditEntitlement, nil]
+            optional :credit_entitlement,
+                     -> { Stigg::V1::AddonUpdateParams::Charges::OveragePricingModel::CreditEntitlement },
+                     api_name: :creditEntitlement
+
+            # @!attribute currency_id
+            #   The refId of the custom currency this credit overage applies to
+            #
+            #   @return [String, nil]
+            optional :currency_id, String, api_name: :currencyId
+
             # @!attribute entitlement
             #   Entitlement configuration for the overage feature
             #
@@ -412,13 +427,11 @@ module Stigg
             #   @return [String, nil]
             optional :feature_id, String, api_name: :featureId
 
-            # @!attribute top_up_custom_currency_id
-            #   Custom currency ID for overage top-up
+            # @!method initialize(billing_model:, price_periods:, billing_cadence: nil, credit_entitlement: nil, currency_id: nil, entitlement: nil, feature_id: nil)
+            #   Some parameter documentations has been truncated, see
+            #   {Stigg::Models::V1::AddonUpdateParams::Charges::OveragePricingModel} for more
+            #   details.
             #
-            #   @return [String, nil]
-            optional :top_up_custom_currency_id, String, api_name: :topUpCustomCurrencyId
-
-            # @!method initialize(billing_model:, price_periods:, billing_cadence: nil, entitlement: nil, feature_id: nil, top_up_custom_currency_id: nil)
             #   Overage pricing model configuration.
             #
             #   @param billing_model [Symbol, Stigg::Models::V1::AddonUpdateParams::Charges::OveragePricingModel::BillingModel] The billing model for overages
@@ -427,11 +440,13 @@ module Stigg
             #
             #   @param billing_cadence [Symbol, Stigg::Models::V1::AddonUpdateParams::Charges::OveragePricingModel::BillingCadence] The billing cadence for overages
             #
+            #   @param credit_entitlement [Stigg::Models::V1::AddonUpdateParams::Charges::OveragePricingModel::CreditEntitlement] Credit entitlement to grant when a credit overage targets a currency not yet gra
+            #
+            #   @param currency_id [String] The refId of the custom currency this credit overage applies to
+            #
             #   @param entitlement [Stigg::Models::V1::AddonUpdateParams::Charges::OveragePricingModel::Entitlement] Entitlement configuration for the overage feature
             #
             #   @param feature_id [String] The feature ID for overage pricing
-            #
-            #   @param top_up_custom_currency_id [String] Custom currency ID for overage top-up
 
             # The billing model for overages
             #
@@ -1079,6 +1094,51 @@ module Stigg
               #   @return [Array<Symbol>]
             end
 
+            # @see Stigg::Models::V1::AddonUpdateParams::Charges::OveragePricingModel#credit_entitlement
+            class CreditEntitlement < Stigg::Internal::Type::BaseModel
+              # @!attribute amount
+              #   The base credit balance granted per cadence
+              #
+              #   @return [Float]
+              required :amount, Float
+
+              # @!attribute cadence
+              #   The credit grant cadence (MONTH or YEAR)
+              #
+              #   @return [Symbol, Stigg::Models::V1::AddonUpdateParams::Charges::OveragePricingModel::CreditEntitlement::Cadence]
+              required :cadence,
+                       enum: -> { Stigg::V1::AddonUpdateParams::Charges::OveragePricingModel::CreditEntitlement::Cadence }
+
+              # @!attribute custom_currency_id
+              #   The refId of the custom currency to grant
+              #
+              #   @return [String]
+              required :custom_currency_id, String, api_name: :customCurrencyId
+
+              # @!method initialize(amount:, cadence:, custom_currency_id:)
+              #   Credit entitlement to grant when a credit overage targets a currency not yet
+              #   granted on the plan
+              #
+              #   @param amount [Float] The base credit balance granted per cadence
+              #
+              #   @param cadence [Symbol, Stigg::Models::V1::AddonUpdateParams::Charges::OveragePricingModel::CreditEntitlement::Cadence] The credit grant cadence (MONTH or YEAR)
+              #
+              #   @param custom_currency_id [String] The refId of the custom currency to grant
+
+              # The credit grant cadence (MONTH or YEAR)
+              #
+              # @see Stigg::Models::V1::AddonUpdateParams::Charges::OveragePricingModel::CreditEntitlement#cadence
+              module Cadence
+                extend Stigg::Internal::Type::Enum
+
+                MONTH = :MONTH
+                YEAR = :YEAR
+
+                # @!method self.values
+                #   @return [Array<Symbol>]
+              end
+            end
+
             # @see Stigg::Models::V1::AddonUpdateParams::Charges::OveragePricingModel#entitlement
             class Entitlement < Stigg::Internal::Type::BaseModel
               # @!attribute feature_id

data/lib/stigg/models/v1/credits/credit_grant_response.rb

@@ -86,7 +86,7 @@ module Stigg
             required :expire_at, Time, api_name: :expireAt, nil?: true
 
             # @!attribute grant_type
-            #   The type of credit grant (PAID, PROMOTIONAL, RECURRING)
+            #   The type of credit grant (PAID, PROMOTIONAL, RECURRING, OVERDRAFT)
             #
             #   @return [Symbol, Stigg::Models::V1::Credits::CreditGrantResponse::Data::GrantType]
             required :grant_type,
@@ -197,7 +197,7 @@ module Stigg
             #
             #   @param expire_at [Time, nil] The date when the credit grant expires
             #
-            #   @param grant_type [Symbol, Stigg::Models::V1::Credits::CreditGrantResponse::Data::GrantType] The type of credit grant (PAID, PROMOTIONAL, RECURRING)
+            #   @param grant_type [Symbol, Stigg::Models::V1::Credits::CreditGrantResponse::Data::GrantType] The type of credit grant (PAID, PROMOTIONAL, RECURRING, OVERDRAFT)
             #
             #   @param invoice_id [String, nil] The billing invoice ID associated with this grant
             #
@@ -243,7 +243,7 @@ module Stigg
               #   @param currency [String] The currency code
             end
 
-            # The type of credit grant (PAID, PROMOTIONAL, RECURRING)
+            # The type of credit grant (PAID, PROMOTIONAL, RECURRING, OVERDRAFT)
             #
             # @see Stigg::Models::V1::Credits::CreditGrantResponse::Data#grant_type
             module GrantType

data/lib/stigg/models/v1/credits/grant_list_response.rb

@@ -73,7 +73,7 @@ module Stigg
           required :expire_at, Time, api_name: :expireAt, nil?: true
 
           # @!attribute grant_type
-          #   The type of credit grant (PAID, PROMOTIONAL, RECURRING)
+          #   The type of credit grant (PAID, PROMOTIONAL, RECURRING, OVERDRAFT)
           #
           #   @return [Symbol, Stigg::Models::V1::Credits::GrantListResponse::GrantType]
           required :grant_type,
@@ -182,7 +182,7 @@ module Stigg
           #
           #   @param expire_at [Time, nil] The date when the credit grant expires
           #
-          #   @param grant_type [Symbol, Stigg::Models::V1::Credits::GrantListResponse::GrantType] The type of credit grant (PAID, PROMOTIONAL, RECURRING)
+          #   @param grant_type [Symbol, Stigg::Models::V1::Credits::GrantListResponse::GrantType] The type of credit grant (PAID, PROMOTIONAL, RECURRING, OVERDRAFT)
           #
           #   @param invoice_id [String, nil] The billing invoice ID associated with this grant
           #
@@ -228,7 +228,7 @@ module Stigg
             #   @param currency [String] The currency code
           end
 
-          # The type of credit grant (PAID, PROMOTIONAL, RECURRING)
+          # The type of credit grant (PAID, PROMOTIONAL, RECURRING, OVERDRAFT)
           #
           # @see Stigg::Models::V1::Credits::GrantListResponse#grant_type
           module GrantType

data/lib/stigg/models/v1/{event_estimate_cost_params.rb → event_estimate_params.rb}

@@ -3,8 +3,8 @@
 module Stigg
   module Models
     module V1
-      # @see Stigg::Resources::V1::Events#estimate_cost
-      class EventEstimateCostParams < Stigg::Internal::Type::BaseModel
+      # @see Stigg::Resources::V1::Events#estimate
+      class EventEstimateParams < Stigg::Internal::Type::BaseModel
         extend Stigg::Internal::Type::RequestParameters::Converter
         include Stigg::Internal::Type::RequestParameters
 
@@ -25,7 +25,7 @@ module Stigg
         #
         #   @return [Hash{Symbol=>String, Float, Boolean}, nil]
         optional :dimensions,
-                 -> { Stigg::Internal::Type::HashOf[union: Stigg::V1::EventEstimateCostParams::Dimension] }
+                 -> { Stigg::Internal::Type::HashOf[union: Stigg::V1::EventEstimateParams::Dimension] }
 
         # @!attribute resource_id
         #   Resource id

data/lib/stigg/models/v1/{event_estimate_cost_response.rb → event_estimate_response.rb}

@@ -3,41 +3,41 @@
 module Stigg
   module Models
     module V1
-      # @see Stigg::Resources::V1::Events#estimate_cost
-      class EventEstimateCostResponse < Stigg::Internal::Type::BaseModel
+      # @see Stigg::Resources::V1::Events#estimate
+      class EventEstimateResponse < Stigg::Internal::Type::BaseModel
         # @!attribute data
         #   Estimated credit cost, current balance and balance after
         #
-        #   @return [Stigg::Models::V1::EventEstimateCostResponse::Data]
-        required :data, -> { Stigg::Models::V1::EventEstimateCostResponse::Data }
+        #   @return [Stigg::Models::V1::EventEstimateResponse::Data]
+        required :data, -> { Stigg::Models::V1::EventEstimateResponse::Data }
 
         # @!method initialize(data:)
         #   Response object
         #
-        #   @param data [Stigg::Models::V1::EventEstimateCostResponse::Data] Estimated credit cost, current balance and balance after
+        #   @param data [Stigg::Models::V1::EventEstimateResponse::Data] Estimated credit cost, current balance and balance after
 
-        # @see Stigg::Models::V1::EventEstimateCostResponse#data
+        # @see Stigg::Models::V1::EventEstimateResponse#data
         class Data < Stigg::Internal::Type::BaseModel
           # @!attribute estimates
           #   Per-currency cost estimates
           #
-          #   @return [Array<Stigg::Models::V1::EventEstimateCostResponse::Data::Estimate>]
+          #   @return [Array<Stigg::Models::V1::EventEstimateResponse::Data::Estimate>]
           required :estimates,
-                   -> { Stigg::Internal::Type::ArrayOf[Stigg::Models::V1::EventEstimateCostResponse::Data::Estimate] }
+                   -> { Stigg::Internal::Type::ArrayOf[Stigg::Models::V1::EventEstimateResponse::Data::Estimate] }
 
           # @!attribute warnings
           #   Request-level warnings about the estimation context
           #
-          #   @return [Array<Symbol, Stigg::Models::V1::EventEstimateCostResponse::Data::Warning>]
+          #   @return [Array<Symbol, Stigg::Models::V1::EventEstimateResponse::Data::Warning>]
           required :warnings,
-                   -> { Stigg::Internal::Type::ArrayOf[enum: Stigg::Models::V1::EventEstimateCostResponse::Data::Warning] }
+                   -> { Stigg::Internal::Type::ArrayOf[enum: Stigg::Models::V1::EventEstimateResponse::Data::Warning] }
 
           # @!method initialize(estimates:, warnings:)
           #   Estimated credit cost, current balance and balance after
           #
-          #   @param estimates [Array<Stigg::Models::V1::EventEstimateCostResponse::Data::Estimate>] Per-currency cost estimates
+          #   @param estimates [Array<Stigg::Models::V1::EventEstimateResponse::Data::Estimate>] Per-currency cost estimates
           #
-          #   @param warnings [Array<Symbol, Stigg::Models::V1::EventEstimateCostResponse::Data::Warning>] Request-level warnings about the estimation context
+          #   @param warnings [Array<Symbol, Stigg::Models::V1::EventEstimateResponse::Data::Warning>] Request-level warnings about the estimation context
 
           class Estimate < Stigg::Internal::Type::BaseModel
             # @!attribute balance_after_estimate
@@ -49,9 +49,9 @@ module Stigg
             # @!attribute breakdown
             #   Estimated cost contribution per feature
             #
-            #   @return [Array<Stigg::Models::V1::EventEstimateCostResponse::Data::Estimate::Breakdown>]
+            #   @return [Array<Stigg::Models::V1::EventEstimateResponse::Data::Estimate::Breakdown>]
             required :breakdown,
-                     -> { Stigg::Internal::Type::ArrayOf[Stigg::Models::V1::EventEstimateCostResponse::Data::Estimate::Breakdown] }
+                     -> { Stigg::Internal::Type::ArrayOf[Stigg::Models::V1::EventEstimateResponse::Data::Estimate::Breakdown] }
 
             # @!attribute currency_id
             #   The credit currency identifier
@@ -80,7 +80,7 @@ module Stigg
             # @!method initialize(balance_after_estimate:, breakdown:, currency_id:, current_balance:, estimated_cost:, would_overdraft:)
             #   @param balance_after_estimate [Float] The credit balance after subtracting the estimated cost
             #
-            #   @param breakdown [Array<Stigg::Models::V1::EventEstimateCostResponse::Data::Estimate::Breakdown>] Estimated cost contribution per feature
+            #   @param breakdown [Array<Stigg::Models::V1::EventEstimateResponse::Data::Estimate::Breakdown>] Estimated cost contribution per feature
             #
             #   @param currency_id [String] The credit currency identifier
             #
@@ -106,9 +106,9 @@ module Stigg
               # @!attribute warning_code
               #   Warning explaining why this cost may be inaccurate, if any
               #
-              #   @return [Symbol, Stigg::Models::V1::EventEstimateCostResponse::Data::Estimate::Breakdown::WarningCode, nil]
+              #   @return [Symbol, Stigg::Models::V1::EventEstimateResponse::Data::Estimate::Breakdown::WarningCode, nil]
               required :warning_code,
-                       enum: -> { Stigg::Models::V1::EventEstimateCostResponse::Data::Estimate::Breakdown::WarningCode },
+                       enum: -> { Stigg::Models::V1::EventEstimateResponse::Data::Estimate::Breakdown::WarningCode },
                        api_name: :warningCode,
                        nil?: true
 
@@ -117,11 +117,11 @@ module Stigg
               #
               #   @param feature_id [String] The feature whose meter contributed this cost
               #
-              #   @param warning_code [Symbol, Stigg::Models::V1::EventEstimateCostResponse::Data::Estimate::Breakdown::WarningCode, nil] Warning explaining why this cost may be inaccurate, if any
+              #   @param warning_code [Symbol, Stigg::Models::V1::EventEstimateResponse::Data::Estimate::Breakdown::WarningCode, nil] Warning explaining why this cost may be inaccurate, if any
 
               # Warning explaining why this cost may be inaccurate, if any
               #
-              # @see Stigg::Models::V1::EventEstimateCostResponse::Data::Estimate::Breakdown#warning_code
+              # @see Stigg::Models::V1::EventEstimateResponse::Data::Estimate::Breakdown#warning_code
               module WarningCode
                 extend Stigg::Internal::Type::Enum
 

data/lib/stigg/models/v1/events/beta/customer_retrieve_governance_params.rb

@@ -0,0 +1,173 @@
+# frozen_string_literal: true
+
+module Stigg
+  module Models
+    module V1
+      module Events
+        module Beta
+          # @see Stigg::Resources::V1::Events::Beta::Customers#retrieve_governance
+          class CustomerRetrieveGovernanceParams < Stigg::Internal::Type::BaseModel
+            extend Stigg::Internal::Type::RequestParameters::Converter
+            include Stigg::Internal::Type::RequestParameters
+
+            # @!attribute id
+            #
+            #   @return [String]
+            required :id, String
+
+            # @!attribute after
+            #   Return items that come after this cursor
+            #
+            #   @return [String, nil]
+            optional :after, String
+
+            # @!attribute currency_ids
+            #   Currency ids to include, repeated per value (e.g. `?currencyIds=credits`). Omit
+            #   both featureIds and currencyIds for tree mode.
+            #
+            #   @return [Array<String>, nil]
+            optional :currency_ids, Stigg::Internal::Type::ArrayOf[String]
+
+            # @!attribute entity_id_search
+            #   Case-insensitive substring match on the entity id (`%`/`_` matched literally).
+            #
+            #   @return [String, nil]
+            optional :entity_id_search, String
+
+            # @!attribute entity_type_ids
+            #   Filter to one or more entity types, repeated per value (e.g.
+            #   `?entityTypeIds=team&entityTypeIds=user`).
+            #
+            #   @return [Array<String>, nil]
+            optional :entity_type_ids, Stigg::Internal::Type::ArrayOf[String]
+
+            # @!attribute feature_ids
+            #   Feature ids to include, repeated per value (e.g.
+            #   `?featureIds=ai-tokens&featureIds=seats`). Omit both featureIds and currencyIds
+            #   for tree mode — every node in the hierarchy with no usage configuration
+            #   attached.
+            #
+            #   @return [Array<String>, nil]
+            optional :feature_ids, Stigg::Internal::Type::ArrayOf[String]
+
+            # @!attribute limit
+            #   Maximum number of items to return
+            #
+            #   @return [Integer, nil]
+            optional :limit, Integer
+
+            # @!attribute min_utilization
+            #   Only nodes with utilization ≥ this value (e.g. 0.8 for ≥80%, 1 for at/over
+            #   limit).
+            #
+            #   @return [Float, nil]
+            optional :min_utilization, Float
+
+            # @!attribute order
+            #   Sort direction: `asc` or `desc` (default `desc`).
+            #
+            #   @return [Symbol, Stigg::Models::V1::Events::Beta::CustomerRetrieveGovernanceParams::Order, nil]
+            optional :order, enum: -> { Stigg::V1::Events::Beta::CustomerRetrieveGovernanceParams::Order }
+
+            # @!attribute scope
+            #   Filter by configuration scope: `all` (default), `nodeWide` (`[]` only), or
+            #   `scoped` (non-empty only).
+            #
+            #   @return [Symbol, Stigg::Models::V1::Events::Beta::CustomerRetrieveGovernanceParams::Scope, nil]
+            optional :scope, enum: -> { Stigg::V1::Events::Beta::CustomerRetrieveGovernanceParams::Scope }
+
+            # @!attribute sort_by
+            #   Sort key: `utilization` (default, cross-capability-safe), `currentUsage`,
+            #   `usageLimit`, `scopeSize`, `id`, or `createdAt`.
+            #
+            #   @return [Symbol, Stigg::Models::V1::Events::Beta::CustomerRetrieveGovernanceParams::SortBy, nil]
+            optional :sort_by, enum: -> { Stigg::V1::Events::Beta::CustomerRetrieveGovernanceParams::SortBy }
+
+            # @!attribute x_account_id
+            #
+            #   @return [String, nil]
+            optional :x_account_id, String
+
+            # @!attribute x_environment_id
+            #
+            #   @return [String, nil]
+            optional :x_environment_id, String
+
+            # @!method initialize(id:, after: nil, currency_ids: nil, entity_id_search: nil, entity_type_ids: nil, feature_ids: nil, limit: nil, min_utilization: nil, order: nil, scope: nil, sort_by: nil, x_account_id: nil, x_environment_id: nil, request_options: {})
+            #   Some parameter documentations has been truncated, see
+            #   {Stigg::Models::V1::Events::Beta::CustomerRetrieveGovernanceParams} for more
+            #   details.
+            #
+            #   @param id [String]
+            #
+            #   @param after [String] Return items that come after this cursor
+            #
+            #   @param currency_ids [Array<String>] Currency ids to include, repeated per value (e.g. `?currencyIds=credits`). Omit
+            #
+            #   @param entity_id_search [String] Case-insensitive substring match on the entity id (`%`/`_` matched literally).
+            #
+            #   @param entity_type_ids [Array<String>] Filter to one or more entity types, repeated per value (e.g. `?entityTypeIds=tea
+            #
+            #   @param feature_ids [Array<String>] Feature ids to include, repeated per value (e.g. `?featureIds=ai-tokens&featureI
+            #
+            #   @param limit [Integer] Maximum number of items to return
+            #
+            #   @param min_utilization [Float] Only nodes with utilization ≥ this value (e.g. 0.8 for ≥80%, 1 for at/over limit
+            #
+            #   @param order [Symbol, Stigg::Models::V1::Events::Beta::CustomerRetrieveGovernanceParams::Order] Sort direction: `asc` or `desc` (default `desc`).
+            #
+            #   @param scope [Symbol, Stigg::Models::V1::Events::Beta::CustomerRetrieveGovernanceParams::Scope] Filter by configuration scope: `all` (default), `nodeWide` (`[]` only), or `scop
+            #
+            #   @param sort_by [Symbol, Stigg::Models::V1::Events::Beta::CustomerRetrieveGovernanceParams::SortBy] Sort key: `utilization` (default, cross-capability-safe), `currentUsage`, `usage
+            #
+            #   @param x_account_id [String]
+            #
+            #   @param x_environment_id [String]
+            #
+            #   @param request_options [Stigg::RequestOptions, Hash{Symbol=>Object}]
+
+            # Sort direction: `asc` or `desc` (default `desc`).
+            module Order
+              extend Stigg::Internal::Type::Enum
+
+              ASC = :asc
+              DESC = :desc
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+
+            # Filter by configuration scope: `all` (default), `nodeWide` (`[]` only), or
+            # `scoped` (non-empty only).
+            module Scope
+              extend Stigg::Internal::Type::Enum
+
+              ALL = :all
+              NODE_WIDE = :nodeWide
+              SCOPED = :scoped
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+
+            # Sort key: `utilization` (default, cross-capability-safe), `currentUsage`,
+            # `usageLimit`, `scopeSize`, `id`, or `createdAt`.
+            module SortBy
+              extend Stigg::Internal::Type::Enum
+
+              UTILIZATION = :utilization
+              CURRENT_USAGE = :currentUsage
+              USAGE_LIMIT = :usageLimit
+              SCOPE_SIZE = :scopeSize
+              ID = :id
+              CREATED_AT = :createdAt
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+          end
+        end
+      end
+    end
+  end
+end