stigg 0.1.0.pre.beta.61 → 0.1.0.pre.beta.63

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e88869166c7266edc8b8de7dcf709fc44fd4f8db9398797a75a6b14d716ca126
-  data.tar.gz: 4aa36a54bba7f279e895f55ea8c7a4607b3754db0a383d65233c7494ac0eae09
+  metadata.gz: 6c114a3a61416839ea99a2c4c5f98fa95969c19f1c5e622a393ac2e1bba8f3a4
+  data.tar.gz: 54492f3692b1f942b0a98ad32f74c341975da228177ca6d89758ff4df243a432
 SHA512:
-  metadata.gz: 16520b05658892720891a04b84274142619239bc0e8ff0a5ca760d9a918cfca1b4017b301fafff9c50e677a9024379a8b44e16c9ffd5d13ba4ce8e8e5d4b9f62
-  data.tar.gz: 9ce0a688f703ebb995e2d520aaa278347dee1ec7440a6af3d067a86f4fd86c8cc3a2c23bbdc8abc10d207d0ed1450694c2e39ec8663fb2c44474f70645e093f4
+  metadata.gz: 40bb0400981005162f616816e6d5d8ae1827343de4fc2023a8b26301c4b2114d91bf18da1e5f2ec7b837b5b34f8d02183c10bbbee78deda837575df8acb470d2
+  data.tar.gz: 66072f1f337fbf2b6d72dfc1b9c238560b107675750600f62d01cd2bd69703ab2dd8d467cf5654ef52e123c9b07d79e827c5a00b00ef5e4a6cbebd81b24a4d65

data/CHANGELOG.md

@@ -1,5 +1,38 @@
 # Changelog
 
+## [0.1.0-beta.63](https://github.com/stiggio/stigg-ruby/compare/v0.1.0-beta.62...v0.1.0-beta.63) (2026-10-30)
+
+
+### Features
+
+* **STIGG-9594:** add the v1 governance resources and v1-beta deprecation messages ([dca8ab0](https://github.com/stiggio/stigg-ruby/commit/dca8ab05c289863df048895cd9c3848f679b83cd))
+
+
+### Bug Fixes
+
+* sync OpenAPI spec from stigg-api ([7407bad](https://github.com/stiggio/stigg-ruby/commit/7407bade916d8ef0ff00f38e2424d5d72137b492))
+* sync OpenAPI spec from stigg-api ([dfa506f](https://github.com/stiggio/stigg-ruby/commit/dfa506f71d8be6cd7b8a0733f79a2356a2683ef7))
+* sync OpenAPI spec from stigg-api ([a43c0a9](https://github.com/stiggio/stigg-ruby/commit/a43c0a93ba3c3077db2f54a0faa9786eecddcec8))
+* sync OpenAPI spec from stigg-api ([316bf50](https://github.com/stiggio/stigg-ruby/commit/316bf50276593b429ccc7333e5cb08288b057fda))
+
+
+### Chores
+
+* normalize version.rb to gem prerelease format for stlc codegen ([dc4e82a](https://github.com/stiggio/stigg-ruby/commit/dc4e82a110db751da07d0da17048fa1e29800233))
+
+## [0.1.0-beta.62](https://github.com/stiggio/stigg-ruby/compare/v0.1.0-beta.61...v0.1.0-beta.62) (2026-10-29)
+
+
+### Bug Fixes
+
+* sync OpenAPI spec from stigg-api ([e878bee](https://github.com/stiggio/stigg-ruby/commit/e878beec1f2c5495d17e56b44725cf61d97938e6))
+* sync OpenAPI spec from stigg-api ([fec3f5a](https://github.com/stiggio/stigg-ruby/commit/fec3f5a1f1316311fe2d653493f335f21bedd7b4))
+
+
+### Chores
+
+* normalize version.rb to gem prerelease format for stlc codegen ([c610c8a](https://github.com/stiggio/stigg-ruby/commit/c610c8a60136a8fb7dc36e3ca47ed172f90f77fe))
+
 ## [0.1.0-beta.61](https://github.com/stiggio/stigg-ruby/compare/v0.1.0-beta.60...v0.1.0-beta.61) (2026-10-28)
 
 

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.60"
+gem "stigg", "~> 0.1.0.pre.beta.62"
 ```
 
 <!-- x-release-please-end -->

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

@@ -20,6 +20,14 @@ module Stigg
         #   @return [String, nil]
         optional :currency_id, String
 
+        # @!attribute dimensions
+        #   Attribution map of the entities the usage is attributed to (e.g.
+        #   `dimensions[userId]=u1`). When provided, their governance budgets are checked
+        #   too and the response includes `chains`.
+        #
+        #   @return [Hash{Symbol=>String}, nil]
+        optional :dimensions, Stigg::Internal::Type::HashOf[String]
+
         # @!attribute feature_id
         #   Feature ID (refId) to check. Mutually exclusive with `currencyId`.
         #
@@ -68,7 +76,8 @@ module Stigg
 
         # @!attribute reserve_amount
         #   Credits to reserve (credit entitlements only). The check is decided and the
-        #   credits held atomically; `requestedUsage` is ignored.
+        #   credits held atomically; `requestedUsage` is ignored. Not supported with
+        #   `dimensions`.
         #
         #   @return [Float, nil]
         optional :reserve_amount, Float
@@ -89,7 +98,7 @@ module Stigg
         #   @return [String, nil]
         optional :x_environment_id, String
 
-        # @!method initialize(id:, currency_id: nil, feature_id: nil, requested_usage: nil, requested_values: nil, reservation_expires_at: nil, reservation_id: nil, reservation_metadata: nil, reservation_ttl_seconds: nil, reserve_amount: nil, resource_id: nil, x_account_id: nil, x_environment_id: nil, request_options: {})
+        # @!method initialize(id:, currency_id: nil, dimensions: nil, feature_id: nil, requested_usage: nil, requested_values: nil, reservation_expires_at: nil, reservation_id: nil, reservation_metadata: nil, reservation_ttl_seconds: nil, reserve_amount: nil, resource_id: nil, x_account_id: nil, x_environment_id: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {Stigg::Models::V1::CustomerCheckEntitlementParams} for more details.
         #
@@ -97,6 +106,8 @@ module Stigg
         #
         #   @param currency_id [String] Currency ID (refId) to check for credit entitlements. Mutually exclusive with `f
         #
+        #   @param dimensions [Hash{Symbol=>String}] Attribution map of the entities the usage is attributed to (e.g. `dimensions[use
+        #
         #   @param feature_id [String] Feature ID (refId) to check. Mutually exclusive with `currencyId`.
         #
         #   @param requested_usage [Integer] Requested usage amount to evaluate against the entitlement limit (numeric featur

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

@@ -44,6 +44,14 @@ module Stigg
             #   @return [Symbol, :FEATURE]
             required :type, const: :FEATURE
 
+            # @!attribute chains
+            #   Per-entity rollups, one chain per resolved dimension. Omitted when dimensions
+            #   was not provided.
+            #
+            #   @return [Array<Array<Stigg::Models::V1::CustomerCheckEntitlementResponse::Data::Feature::Chain>>, nil]
+            optional :chains,
+                     -> { Stigg::Internal::Type::ArrayOf[Stigg::Internal::Type::ArrayOf[Stigg::Models::V1::CustomerCheckEntitlementResponse::Data::Feature::Chain]] }
+
             # @!attribute current_usage
             #
             #   @return [Float, nil]
@@ -105,7 +113,7 @@ module Stigg
             #   @return [Time, nil]
             optional :valid_until, Time, api_name: :validUntil
 
-            # @!method initialize(access_denied_reason:, is_granted:, current_usage: nil, entitlement_updated_at: nil, feature: nil, has_unlimited_usage: nil, reset_period: nil, usage_limit: nil, usage_period_anchor: nil, usage_period_end: nil, usage_period_start: nil, valid_until: nil, type: :FEATURE)
+            # @!method initialize(access_denied_reason:, is_granted:, chains: nil, current_usage: nil, entitlement_updated_at: nil, feature: nil, has_unlimited_usage: nil, reset_period: nil, usage_limit: nil, usage_period_anchor: nil, usage_period_end: nil, usage_period_start: nil, valid_until: nil, type: :FEATURE)
             #   Some parameter documentations has been truncated, see
             #   {Stigg::Models::V1::CustomerCheckEntitlementResponse::Data::Feature} for more
             #   details.
@@ -114,6 +122,8 @@ module Stigg
             #
             #   @param is_granted [Boolean]
             #
+            #   @param chains [Array<Array<Stigg::Models::V1::CustomerCheckEntitlementResponse::Data::Feature::Chain>>] Per-entity rollups, one chain per resolved dimension. Omitted when dimensions wa
+            #
             #   @param current_usage [Float]
             #
             #   @param entitlement_updated_at [Time] Timestamp of the last update to the entitlement grant or configuration.
@@ -159,6 +169,58 @@ module Stigg
               #   @return [Array<Symbol>]
             end
 
+            class Chain < Stigg::Internal::Type::BaseModel
+              # @!attribute current_usage
+              #   Amount consumed by this entity in the current cadence period.
+              #
+              #   @return [Float]
+              required :current_usage, Float, api_name: :currentUsage
+
+              # @!attribute entity_id
+              #   External id of the entity within the customer.
+              #
+              #   @return [String]
+              required :entity_id, String, api_name: :entityId
+
+              # @!attribute is_granted
+              #   Whether this node alone permits the requested usage.
+              #
+              #   @return [Boolean]
+              required :is_granted, Stigg::Internal::Type::Boolean, api_name: :isGranted
+
+              # @!attribute scope_entity_ids
+              #   External ids of the entities this budget is scoped to. Empty (`[]`) is the
+              #   node-wide budget; a non-empty set is the dimension-scoped budget that matched
+              #   this request — use it to tell apart multiple budgets on the same entity.
+              #
+              #   @return [Array<String>]
+              required :scope_entity_ids, Stigg::Internal::Type::ArrayOf[String], api_name: :scopeEntityIds
+
+              # @!attribute usage_limit
+              #   Hard usage limit for this node; null when the entity has no entity entitlement.
+              #
+              #   @return [Float, nil]
+              required :usage_limit, Float, api_name: :usageLimit, nil?: true
+
+              # @!method initialize(current_usage:, entity_id:, is_granted:, scope_entity_ids:, usage_limit:)
+              #   Some parameter documentations has been truncated, see
+              #   {Stigg::Models::V1::CustomerCheckEntitlementResponse::Data::Feature::Chain} for
+              #   more details.
+              #
+              #   Per-entity governance node — limit and current usage for a single resolved
+              #   entity.
+              #
+              #   @param current_usage [Float] Amount consumed by this entity in the current cadence period.
+              #
+              #   @param entity_id [String] External id of the entity within the customer.
+              #
+              #   @param is_granted [Boolean] Whether this node alone permits the requested usage.
+              #
+              #   @param scope_entity_ids [Array<String>] External ids of the entities this budget is scoped to. Empty (`[]`) is the node-
+              #
+              #   @param usage_limit [Float, nil] Hard usage limit for this node; null when the entity has no entity entitlement.
+            end
+
             # @see Stigg::Models::V1::CustomerCheckEntitlementResponse::Data::Feature#feature
             class Feature < Stigg::Internal::Type::BaseModel
               # @!attribute id
@@ -283,6 +345,14 @@ module Stigg
             #   @return [Time]
             required :usage_updated_at, Time, api_name: :usageUpdatedAt
 
+            # @!attribute chains
+            #   Per-entity rollups, one chain per resolved dimension. Omitted when dimensions
+            #   was not provided.
+            #
+            #   @return [Array<Array<Stigg::Models::V1::CustomerCheckEntitlementResponse::Data::Credit::Chain>>, nil]
+            optional :chains,
+                     -> { Stigg::Internal::Type::ArrayOf[Stigg::Internal::Type::ArrayOf[Stigg::Models::V1::CustomerCheckEntitlementResponse::Data::Credit::Chain]] }
+
             # @!attribute entitlement_updated_at
             #   Timestamp of the last update to the entitlement grant or configuration.
             #
@@ -325,7 +395,7 @@ module Stigg
             #   @return [Time, nil]
             optional :valid_until, Time, api_name: :validUntil
 
-            # @!method initialize(access_denied_reason:, currency:, current_usage:, is_granted:, usage_limit:, usage_updated_at:, entitlement_updated_at: nil, reservation: nil, reserved: nil, reserved_on_expired_grants: nil, usage_period_end: nil, valid_until: nil, type: :CREDIT)
+            # @!method initialize(access_denied_reason:, currency:, current_usage:, is_granted:, usage_limit:, usage_updated_at:, chains: nil, entitlement_updated_at: nil, reservation: nil, reserved: nil, reserved_on_expired_grants: nil, usage_period_end: nil, valid_until: nil, type: :CREDIT)
             #   Some parameter documentations has been truncated, see
             #   {Stigg::Models::V1::CustomerCheckEntitlementResponse::Data::Credit} for more
             #   details.
@@ -342,6 +412,8 @@ module Stigg
             #
             #   @param usage_updated_at [Time] Timestamp of the last update to the credit usage.
             #
+            #   @param chains [Array<Array<Stigg::Models::V1::CustomerCheckEntitlementResponse::Data::Credit::Chain>>] Per-entity rollups, one chain per resolved dimension. Omitted when dimensions wa
+            #
             #   @param entitlement_updated_at [Time] Timestamp of the last update to the entitlement grant or configuration.
             #
             #   @param reservation [Stigg::Models::V1::CustomerCheckEntitlementResponse::Data::Credit::Reservation, nil] The reservation created by this request, when it asked to reserve credits and wa
@@ -433,6 +505,58 @@ module Stigg
               #   @param unit_singular [String, nil] The singular form of the currency unit.
             end
 
+            class Chain < Stigg::Internal::Type::BaseModel
+              # @!attribute current_usage
+              #   Amount consumed by this entity in the current cadence period.
+              #
+              #   @return [Float]
+              required :current_usage, Float, api_name: :currentUsage
+
+              # @!attribute entity_id
+              #   External id of the entity within the customer.
+              #
+              #   @return [String]
+              required :entity_id, String, api_name: :entityId
+
+              # @!attribute is_granted
+              #   Whether this node alone permits the requested usage.
+              #
+              #   @return [Boolean]
+              required :is_granted, Stigg::Internal::Type::Boolean, api_name: :isGranted
+
+              # @!attribute scope_entity_ids
+              #   External ids of the entities this budget is scoped to. Empty (`[]`) is the
+              #   node-wide budget; a non-empty set is the dimension-scoped budget that matched
+              #   this request — use it to tell apart multiple budgets on the same entity.
+              #
+              #   @return [Array<String>]
+              required :scope_entity_ids, Stigg::Internal::Type::ArrayOf[String], api_name: :scopeEntityIds
+
+              # @!attribute usage_limit
+              #   Hard usage limit for this node; null when the entity has no entity entitlement.
+              #
+              #   @return [Float, nil]
+              required :usage_limit, Float, api_name: :usageLimit, nil?: true
+
+              # @!method initialize(current_usage:, entity_id:, is_granted:, scope_entity_ids:, usage_limit:)
+              #   Some parameter documentations has been truncated, see
+              #   {Stigg::Models::V1::CustomerCheckEntitlementResponse::Data::Credit::Chain} for
+              #   more details.
+              #
+              #   Per-entity governance node — limit and current usage for a single resolved
+              #   entity.
+              #
+              #   @param current_usage [Float] Amount consumed by this entity in the current cadence period.
+              #
+              #   @param entity_id [String] External id of the entity within the customer.
+              #
+              #   @param is_granted [Boolean] Whether this node alone permits the requested usage.
+              #
+              #   @param scope_entity_ids [Array<String>] External ids of the entities this budget is scoped to. Empty (`[]`) is the node-
+              #
+              #   @param usage_limit [Float, nil] Hard usage limit for this node; null when the entity has no entity entitlement.
+            end
+
             # @see Stigg::Models::V1::CustomerCheckEntitlementResponse::Data::Credit#reservation
             class Reservation < Stigg::Internal::Type::BaseModel
               # @!attribute id

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

@@ -103,13 +103,19 @@ module Stigg
         #   @return [Stigg::Models::V1::CustomerListResponse::Passthrough, nil]
         optional :passthrough, -> { Stigg::Models::V1::CustomerListResponse::Passthrough }
 
+        # @!attribute salesforce_id
+        #   The unique identifier for the customer in Salesforce integration
+        #
+        #   @return [String, nil]
+        optional :salesforce_id, String, api_name: :salesforceId, nil?: true
+
         # @!attribute timezone
         #   Timezone to use for this customer
         #
         #   @return [String, nil]
         optional :timezone, String, nil?: true
 
-        # @!method initialize(id:, archived_at:, created_at:, updated_at:, billing_currency: nil, billing_id: nil, coupon_id: nil, default_payment_method: nil, email: nil, integrations: nil, language: nil, metadata: nil, name: nil, passthrough: nil, timezone: nil)
+        # @!method initialize(id:, archived_at:, created_at:, updated_at:, billing_currency: nil, billing_id: nil, coupon_id: nil, default_payment_method: nil, email: nil, integrations: nil, language: nil, metadata: nil, name: nil, passthrough: nil, salesforce_id: nil, timezone: nil)
         #   Some parameter documentations has been truncated, see
         #   {Stigg::Models::V1::CustomerListResponse} for more details.
         #
@@ -143,6 +149,8 @@ module Stigg
         #
         #   @param passthrough [Stigg::Models::V1::CustomerListResponse::Passthrough] Vendor-specific billing passthrough fields.
         #
+        #   @param salesforce_id [String, nil] The unique identifier for the customer in Salesforce integration
+        #
         #   @param timezone [String, nil] Timezone to use for this customer
 
         # The billing currency of the customer

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

@@ -88,6 +88,12 @@ module Stigg
         #   @return [Stigg::Models::V1::CustomerProvisionParams::Passthrough, nil]
         optional :passthrough, -> { Stigg::V1::CustomerProvisionParams::Passthrough }
 
+        # @!attribute salesforce_id
+        #   The unique identifier for the customer in Salesforce integration
+        #
+        #   @return [String, nil]
+        optional :salesforce_id, String, api_name: :salesforceId, nil?: true
+
         # @!attribute timezone
         #   Timezone to use for this customer
         #
@@ -104,7 +110,7 @@ module Stigg
         #   @return [String, nil]
         optional :x_environment_id, String
 
-        # @!method initialize(id:, billing_currency: nil, billing_id: nil, coupon_id: nil, default_payment_method: nil, email: nil, integrations: nil, language: nil, metadata: nil, name: nil, passthrough: nil, timezone: nil, x_account_id: nil, x_environment_id: nil, request_options: {})
+        # @!method initialize(id:, billing_currency: nil, billing_id: nil, coupon_id: nil, default_payment_method: nil, email: nil, integrations: nil, language: nil, metadata: nil, name: nil, passthrough: nil, salesforce_id: nil, timezone: nil, x_account_id: nil, x_environment_id: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {Stigg::Models::V1::CustomerProvisionParams} for more details.
         #
@@ -130,6 +136,8 @@ module Stigg
         #
         #   @param passthrough [Stigg::Models::V1::CustomerProvisionParams::Passthrough] Vendor-specific billing passthrough fields.
         #
+        #   @param salesforce_id [String, nil] The unique identifier for the customer in Salesforce integration
+        #
         #   @param timezone [String, nil] Timezone to use for this customer
         #
         #   @param x_account_id [String]

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

@@ -116,13 +116,19 @@ module Stigg
           #   @return [Stigg::Models::V1::CustomerResponse::Data::Passthrough, nil]
           optional :passthrough, -> { Stigg::V1::CustomerResponse::Data::Passthrough }
 
+          # @!attribute salesforce_id
+          #   The unique identifier for the customer in Salesforce integration
+          #
+          #   @return [String, nil]
+          optional :salesforce_id, String, api_name: :salesforceId, nil?: true
+
           # @!attribute timezone
           #   Timezone to use for this customer
           #
           #   @return [String, nil]
           optional :timezone, String, nil?: true
 
-          # @!method initialize(id:, archived_at:, created_at:, updated_at:, billing_currency: nil, billing_id: nil, coupon_id: nil, default_payment_method: nil, email: nil, integrations: nil, language: nil, metadata: nil, name: nil, passthrough: nil, timezone: nil)
+          # @!method initialize(id:, archived_at:, created_at:, updated_at:, billing_currency: nil, billing_id: nil, coupon_id: nil, default_payment_method: nil, email: nil, integrations: nil, language: nil, metadata: nil, name: nil, passthrough: nil, salesforce_id: nil, timezone: nil)
           #   Some parameter documentations has been truncated, see
           #   {Stigg::Models::V1::CustomerResponse::Data} for more details.
           #
@@ -156,6 +162,8 @@ module Stigg
           #
           #   @param passthrough [Stigg::Models::V1::CustomerResponse::Data::Passthrough] Vendor-specific billing passthrough fields.
           #
+          #   @param salesforce_id [String, nil] The unique identifier for the customer in Salesforce integration
+          #
           #   @param timezone [String, nil] Timezone to use for this customer
 
           # The billing currency of the customer

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

@@ -78,6 +78,12 @@ module Stigg
         #   @return [Stigg::Models::V1::CustomerUpdateParams::Passthrough, nil]
         optional :passthrough, -> { Stigg::V1::CustomerUpdateParams::Passthrough }
 
+        # @!attribute salesforce_id
+        #   The unique identifier for the customer in Salesforce integration
+        #
+        #   @return [String, nil]
+        optional :salesforce_id, String, api_name: :salesforceId, nil?: true
+
         # @!attribute timezone
         #   Timezone to use for this customer
         #
@@ -94,7 +100,7 @@ module Stigg
         #   @return [String, nil]
         optional :x_environment_id, String
 
-        # @!method initialize(id:, billing_currency: nil, billing_id: nil, coupon_id: nil, email: nil, integrations: nil, language: nil, metadata: nil, name: nil, passthrough: nil, timezone: nil, x_account_id: nil, x_environment_id: nil, request_options: {})
+        # @!method initialize(id:, billing_currency: nil, billing_id: nil, coupon_id: nil, email: nil, integrations: nil, language: nil, metadata: nil, name: nil, passthrough: nil, salesforce_id: nil, timezone: nil, x_account_id: nil, x_environment_id: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {Stigg::Models::V1::CustomerUpdateParams} for more details.
         #
@@ -118,6 +124,8 @@ module Stigg
         #
         #   @param passthrough [Stigg::Models::V1::CustomerUpdateParams::Passthrough] Vendor-specific billing passthrough fields.
         #
+        #   @param salesforce_id [String, nil] The unique identifier for the customer in Salesforce integration
+        #
         #   @param timezone [String, nil] Timezone to use for this customer
         #
         #   @param x_account_id [String]

data/lib/stigg/models/v1/customers/entities/entitlement_list_params.rb

@@ -0,0 +1,95 @@
+# frozen_string_literal: true
+
+module Stigg
+  module Models
+    module V1
+      module Customers
+        module Entities
+          # @see Stigg::Resources::V1::Customers::Entities::Entitlements#list
+          class EntitlementListParams < 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 before
+            #   Return items that come before this cursor
+            #
+            #   @return [String, nil]
+            optional :before, String
+
+            # @!attribute currency_id
+            #   Filter entity entitlements to a specific currency, by its ID. Mutually exclusive
+            #   with `featureId`.
+            #
+            #   @return [String, nil]
+            optional :currency_id, String
+
+            # @!attribute entity_id
+            #   Filter entity entitlements to a specific entity ID
+            #
+            #   @return [String, nil]
+            optional :entity_id, String
+
+            # @!attribute feature_id
+            #   Filter entity entitlements to a specific feature, by its ID. Mutually exclusive
+            #   with `currencyId`.
+            #
+            #   @return [String, nil]
+            optional :feature_id, String
+
+            # @!attribute limit
+            #   Maximum number of items to return
+            #
+            #   @return [Integer, nil]
+            optional :limit, Integer
+
+            # @!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, before: nil, currency_id: nil, entity_id: nil, feature_id: nil, limit: nil, x_account_id: nil, x_environment_id: nil, request_options: {})
+            #   Some parameter documentations has been truncated, see
+            #   {Stigg::Models::V1::Customers::Entities::EntitlementListParams} for more
+            #   details.
+            #
+            #   @param id [String]
+            #
+            #   @param after [String] Return items that come after this cursor
+            #
+            #   @param before [String] Return items that come before this cursor
+            #
+            #   @param currency_id [String] Filter entity entitlements to a specific currency, by its ID. Mutually exclusive
+            #
+            #   @param entity_id [String] Filter entity entitlements to a specific entity ID
+            #
+            #   @param feature_id [String] Filter entity entitlements to a specific feature, by its ID. Mutually exclusive
+            #
+            #   @param limit [Integer] Maximum number of items to return
+            #
+            #   @param x_account_id [String]
+            #
+            #   @param x_environment_id [String]
+            #
+            #   @param request_options [Stigg::RequestOptions, Hash{Symbol=>Object}]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/stigg/models/v1/customers/entities/entitlement_list_response.rb

@@ -0,0 +1,107 @@
+# frozen_string_literal: true
+
+module Stigg
+  module Models
+    module V1
+      module Customers
+        module Entities
+          # @see Stigg::Resources::V1::Customers::Entities::Entitlements#list
+          class EntitlementListResponse < Stigg::Internal::Type::BaseModel
+            # @!attribute id
+            #   Synthetic UUID identifier — also the cursor anchor for paginated lists
+            #
+            #   @return [String]
+            required :id, String
+
+            # @!attribute cadence
+            #   Usage-reset cadence as an ISO-8601 single-unit duration, e.g. `P1M`, `P30D`,
+            #   `PT1M`.
+            #
+            #   @return [String]
+            required :cadence, String
+
+            # @!attribute created_at
+            #   Timestamp of when the record was created
+            #
+            #   @return [Time]
+            required :created_at, Time, api_name: :createdAt
+
+            # @!attribute entity_id
+            #   The entity ID this entity entitlement is attached to
+            #
+            #   @return [String]
+            required :entity_id, String, api_name: :entityId
+
+            # @!attribute parent_id
+            #   Parent entity ID in the hierarchy, or `null` for a root.
+            #
+            #   @return [String, nil]
+            required :parent_id, String, api_name: :parentId, nil?: true
+
+            # @!attribute scope_entity_ids
+            #   Dimension-scoped sub-limit key: the set of entity IDs this limit applies to.
+            #   Empty is the node-wide limit that always matches; a non-empty set only applies
+            #   when every listed entity is present in the resolved set (order-insensitive).
+            #
+            #   @return [Array<String>]
+            required :scope_entity_ids, Stigg::Internal::Type::ArrayOf[String], api_name: :scopeEntityIds
+
+            # @!attribute updated_at
+            #   Timestamp of when the record was last updated
+            #
+            #   @return [Time]
+            required :updated_at, Time, api_name: :updatedAt
+
+            # @!attribute usage_limit
+            #   Maximum usage allowed within one cadence window
+            #
+            #   @return [Float, nil]
+            required :usage_limit, Float, api_name: :usageLimit, nil?: true
+
+            # @!attribute currency_id
+            #   Currency ID this entity entitlement grants (present when it grants a credit
+            #   currency).
+            #
+            #   @return [String, nil]
+            optional :currency_id, String, api_name: :currencyId
+
+            # @!attribute feature_id
+            #   Feature ID this entity entitlement grants (present when it grants a feature).
+            #
+            #   @return [String, nil]
+            optional :feature_id, String, api_name: :featureId
+
+            # @!method initialize(id:, cadence:, created_at:, entity_id:, parent_id:, scope_entity_ids:, updated_at:, usage_limit:, currency_id: nil, feature_id: nil)
+            #   Some parameter documentations has been truncated, see
+            #   {Stigg::Models::V1::Customers::Entities::EntitlementListResponse} for more
+            #   details.
+            #
+            #   An entity entitlement for an entity belonging to a customer. Defines how much of
+            #   the feature or currency the entity may consume (`usageLimit`) and how often the
+            #   counter resets (`cadence`).
+            #
+            #   @param id [String] Synthetic UUID identifier — also the cursor anchor for paginated lists
+            #
+            #   @param cadence [String] Usage-reset cadence as an ISO-8601 single-unit duration, e.g. `P1M`, `P30D`, `PT
+            #
+            #   @param created_at [Time] Timestamp of when the record was created
+            #
+            #   @param entity_id [String] The entity ID this entity entitlement is attached to
+            #
+            #   @param parent_id [String, nil] Parent entity ID in the hierarchy, or `null` for a root.
+            #
+            #   @param scope_entity_ids [Array<String>] Dimension-scoped sub-limit key: the set of entity IDs this limit applies to. Emp
+            #
+            #   @param updated_at [Time] Timestamp of when the record was last updated
+            #
+            #   @param usage_limit [Float, nil] Maximum usage allowed within one cadence window
+            #
+            #   @param currency_id [String] Currency ID this entity entitlement grants (present when it grants a credit curr
+            #
+            #   @param feature_id [String] Feature ID this entity entitlement grants (present when it grants a feature).
+          end
+        end
+      end
+    end
+  end
+end