stigg 0.1.0.pre.beta.57 → 0.1.0.pre.beta.59

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 708a857f78b38d4be04cdf9404746325027c0e77ed8f8bb1b2cd33345d2c7e68
-  data.tar.gz: 8a6916176a4d58c67b6e8f23367799f0f1fb6df268da57d9985364148342f561
+  metadata.gz: b110182dabf0144099cb775786f7cbd2c23130d8f7cbf652dc23bdeb7b91aa8e
+  data.tar.gz: baab0f7102a3d40e12a398e22bf0b745c295d359455857541fff9a0457c0bb97
 SHA512:
-  metadata.gz: '0019d4cf46f41394aa8edd73d1ce79d9a5f8e04a8917d47897f752c1888969c2f1943a7c53cba3bba1ced27b5aff3537a2f1c1ee123f6bc5fddaa7604df102d2'
-  data.tar.gz: e2e66982a8445532733a13a3ed7ee52c3859b54de54e73bfddc9821ff9b3158fc5e1ed39d2830c2480f8c1998809e43223bb583cebcdee17b1b3a2a3e8183f15
+  metadata.gz: 9a274dfef112b685dad6a6fcd69a966a446defcdfe554d5ce12d3f5b4e831a92a33ce6165307bd1920a640a446bf991dad0abad6f3c57266ed29342ce2016ead
+  data.tar.gz: 67f5d938b25e4aa07a3ce4ada5e8bfde9789c3a639dbf116ebf1e860281693d60a4ef8794327b20dc846c6a23f31acc083568da11be5d9c6610791531379470c

data/CHANGELOG.md

@@ -1,5 +1,39 @@
 # Changelog
 
+## [0.1.0-beta.59](https://github.com/stiggio/stigg-ruby/compare/v0.1.0-beta.58...v0.1.0-beta.59) (2026-10-22)
+
+
+### Features
+
+* **STIGG-10078:** credit reservation release in the sdks ([1304cf9](https://github.com/stiggio/stigg-ruby/commit/1304cf9c429ff4a0e4b3e8ef189e514e826d4f19))
+
+
+### Bug Fixes
+
+* sync OpenAPI spec from stigg-api ([5802632](https://github.com/stiggio/stigg-ruby/commit/5802632aea5bea5172def86c993df4a5939178d2))
+* sync OpenAPI spec from stigg-api ([7bca63d](https://github.com/stiggio/stigg-ruby/commit/7bca63d0923f273c08252b867fe5735aae7a6d94))
+* sync OpenAPI spec from stigg-api ([1308798](https://github.com/stiggio/stigg-ruby/commit/13087983769464b32eceea095e9b360db2529d2b))
+* sync OpenAPI spec from stigg-api ([5ee5986](https://github.com/stiggio/stigg-ruby/commit/5ee5986d11a9122559e8ec364c8059bb26b0f5a6))
+* sync OpenAPI spec from stigg-api ([61ee37f](https://github.com/stiggio/stigg-ruby/commit/61ee37f0461ae7ead5876618a5bae322ab21910c))
+
+
+### Chores
+
+* normalize version.rb to gem prerelease format for stlc codegen ([732312c](https://github.com/stiggio/stigg-ruby/commit/732312c75f6f23c560fd49244f76af8a10643f2c))
+
+## [0.1.0-beta.58](https://github.com/stiggio/stigg-ruby/compare/v0.1.0-beta.57...v0.1.0-beta.58) (2026-10-20)
+
+
+### Bug Fixes
+
+* sync OpenAPI spec from stigg-api ([d5d10f1](https://github.com/stiggio/stigg-ruby/commit/d5d10f164c3e066f9f77fb0e2fbac391e671eaeb))
+* sync OpenAPI spec from stigg-api ([84889fd](https://github.com/stiggio/stigg-ruby/commit/84889fd36858b92f1e5ee94530af6f788e03c9c2))
+
+
+### Chores
+
+* normalize version.rb to gem prerelease format for stlc codegen ([f535762](https://github.com/stiggio/stigg-ruby/commit/f53576294a3e52bbdae9035bdf3ffdd16907a7a5))
+
 ## [0.1.0-beta.57](https://github.com/stiggio/stigg-ruby/compare/v0.1.0-beta.56...v0.1.0-beta.57) (2026-10-15)
 
 

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

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

@@ -1343,7 +1343,7 @@ module Stigg
             optional :feature_id, String, api_name: :featureId
 
             # @!attribute max_unit_quantity
-            #   Maximum number of units (max 999999)
+            #   Maximum number of units
             #
             #   @return [Integer, nil]
             optional :max_unit_quantity, Integer, api_name: :maxUnitQuantity
@@ -1417,7 +1417,7 @@ module Stigg
             #
             #   @param feature_id [String] The feature ID this pricing model is associated with
             #
-            #   @param max_unit_quantity [Integer] Maximum number of units (max 999999)
+            #   @param max_unit_quantity [Integer] Maximum number of units
             #
             #   @param min_unit_quantity [Integer] Minimum number of units
             #

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

@@ -44,6 +44,12 @@ module Stigg
         #   @return [Integer, nil]
         optional :limit, Integer
 
+        # @!attribute reservation_id
+        #   Filter by credit reservation ID
+        #
+        #   @return [String, nil]
+        optional :reservation_id, String
+
         # @!attribute resource_id
         #   Filter by resource ID
         #
@@ -60,7 +66,7 @@ module Stigg
         #   @return [String, nil]
         optional :x_environment_id, String
 
-        # @!method initialize(customer_id:, after: nil, before: nil, currency_id: nil, event_type: nil, limit: nil, resource_id: nil, x_account_id: nil, x_environment_id: nil, request_options: {})
+        # @!method initialize(customer_id:, after: nil, before: nil, currency_id: nil, event_type: nil, limit: nil, reservation_id: nil, resource_id: nil, x_account_id: nil, x_environment_id: nil, request_options: {})
         #   @param customer_id [String] Filter by customer ID (required)
         #
         #   @param after [String] Return items that come after this cursor
@@ -73,6 +79,8 @@ module Stigg
         #
         #   @param limit [Integer] Maximum number of items to return
         #
+        #   @param reservation_id [String] Filter by credit reservation ID
+        #
         #   @param resource_id [String] Filter by resource ID
         #
         #   @param x_account_id [String]

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

@@ -6,11 +6,21 @@ module Stigg
       # @see Stigg::Resources::V1::Credits#list_ledger
       class CreditListLedgerResponse < Stigg::Internal::Type::BaseModel
         # @!attribute amount
-        #   The credit amount for this event
+        #   The amount of the ledger event. Reservation events carry their net effect on the
+        #   balance: a reserve is negative, and so is a release that consumed more than was
+        #   held
         #
         #   @return [Float]
         required :amount, Float
 
+        # @!attribute breakdown
+        #   On a released reservation, the credits consumed from each grant
+        #
+        #   @return [Array<Stigg::Models::V1::CreditListLedgerResponse::Breakdown>, nil]
+        required :breakdown,
+                 -> { Stigg::Internal::Type::ArrayOf[Stigg::Models::V1::CreditListLedgerResponse::Breakdown] },
+                 nil?: true
+
         # @!attribute credit_currency_id
         #   The credit currency ID
         #
@@ -49,6 +59,25 @@ module Stigg
         #   @return [String, nil]
         required :feature_id, String, api_name: :featureId, nil?: true
 
+        # @!attribute hold_returned_amount
+        #   On a released reservation, the held amount returned to the balance before
+        #   consumed credits are deducted
+        #
+        #   @return [Float, nil]
+        required :hold_returned_amount, Float, api_name: :holdReturnedAmount, nil?: true
+
+        # @!attribute metadata
+        #   The metadata sent with the credit reservation
+        #
+        #   @return [Hash{Symbol=>String}, nil]
+        required :metadata, Stigg::Internal::Type::HashOf[String], nil?: true
+
+        # @!attribute reservation_id
+        #   The credit reservation this event belongs to
+        #
+        #   @return [String, nil]
+        required :reservation_id, String, api_name: :reservationId, nil?: true
+
         # @!attribute resource_id
         #   The resource ID this event is scoped to
         #
@@ -61,10 +90,15 @@ module Stigg
         #   @return [Time]
         required :timestamp, Time
 
-        # @!method initialize(amount:, credit_currency_id:, credit_grant_id:, customer_id:, event_id:, event_type:, feature_id:, resource_id:, timestamp:)
+        # @!method initialize(amount:, breakdown:, credit_currency_id:, credit_grant_id:, customer_id:, event_id:, event_type:, feature_id:, hold_returned_amount:, metadata:, reservation_id:, resource_id:, timestamp:)
+        #   Some parameter documentations has been truncated, see
+        #   {Stigg::Models::V1::CreditListLedgerResponse} for more details.
+        #
         #   A credit ledger event representing a change to credit balance
         #
-        #   @param amount [Float] The credit amount for this event
+        #   @param amount [Float] The amount of the ledger event. Reservation events carry their net effect on the
+        #
+        #   @param breakdown [Array<Stigg::Models::V1::CreditListLedgerResponse::Breakdown>, nil] On a released reservation, the credits consumed from each grant
         #
         #   @param credit_currency_id [String] The credit currency ID
         #
@@ -78,10 +112,127 @@ module Stigg
         #
         #   @param feature_id [String, nil] The feature ID associated with this event
         #
+        #   @param hold_returned_amount [Float, nil] On a released reservation, the held amount returned to the balance before consum
+        #
+        #   @param metadata [Hash{Symbol=>String}, nil] The metadata sent with the credit reservation
+        #
+        #   @param reservation_id [String, nil] The credit reservation this event belongs to
+        #
         #   @param resource_id [String, nil] The resource ID this event is scoped to
         #
         #   @param timestamp [Time] The timestamp when the event occurred
 
+        class Breakdown < Stigg::Internal::Type::BaseModel
+          # @!attribute amount
+          #   The amount of the ledger event. Reservation events carry their net effect on the
+          #   balance: a reserve is negative, and so is a release that consumed more than was
+          #   held
+          #
+          #   @return [Float]
+          required :amount, Float
+
+          # @!attribute credit_currency_id
+          #   The credit currency ID
+          #
+          #   @return [String]
+          required :credit_currency_id, String, api_name: :creditCurrencyId
+
+          # @!attribute credit_grant_id
+          #   The credit grant ID associated with this event
+          #
+          #   @return [String]
+          required :credit_grant_id, String, api_name: :creditGrantId
+
+          # @!attribute customer_id
+          #   The customer ID this event belongs to
+          #
+          #   @return [String]
+          required :customer_id, String, api_name: :customerId
+
+          # @!attribute event_id
+          #   The unique event identifier
+          #
+          #   @return [String, nil]
+          required :event_id, String, api_name: :eventId, nil?: true
+
+          # @!attribute event_type
+          #   The type of credit event
+          #
+          #   @return [Symbol, Stigg::Models::V1::CreditListLedgerResponse::Breakdown::EventType]
+          required :event_type,
+                   enum: -> { Stigg::Models::V1::CreditListLedgerResponse::Breakdown::EventType },
+                   api_name: :eventType
+
+          # @!attribute feature_id
+          #   The feature ID associated with this event
+          #
+          #   @return [String, nil]
+          required :feature_id, String, api_name: :featureId, nil?: true
+
+          # @!attribute reservation_id
+          #   The credit reservation this event belongs to
+          #
+          #   @return [String, nil]
+          required :reservation_id, String, api_name: :reservationId, nil?: true
+
+          # @!attribute resource_id
+          #   The resource ID this event is scoped to
+          #
+          #   @return [String, nil]
+          required :resource_id, String, api_name: :resourceId, nil?: true
+
+          # @!attribute timestamp
+          #   The timestamp when the event occurred
+          #
+          #   @return [Time]
+          required :timestamp, Time
+
+          # @!method initialize(amount:, credit_currency_id:, credit_grant_id:, customer_id:, event_id:, event_type:, feature_id:, reservation_id:, resource_id:, timestamp:)
+          #   Some parameter documentations has been truncated, see
+          #   {Stigg::Models::V1::CreditListLedgerResponse::Breakdown} for more details.
+          #
+          #   @param amount [Float] The amount of the ledger event. Reservation events carry their net effect on the
+          #
+          #   @param credit_currency_id [String] The credit currency ID
+          #
+          #   @param credit_grant_id [String] The credit grant ID associated with this event
+          #
+          #   @param customer_id [String] The customer ID this event belongs to
+          #
+          #   @param event_id [String, nil] The unique event identifier
+          #
+          #   @param event_type [Symbol, Stigg::Models::V1::CreditListLedgerResponse::Breakdown::EventType] The type of credit event
+          #
+          #   @param feature_id [String, nil] The feature ID associated with this event
+          #
+          #   @param reservation_id [String, nil] The credit reservation this event belongs to
+          #
+          #   @param resource_id [String, nil] The resource ID this event is scoped to
+          #
+          #   @param timestamp [Time] The timestamp when the event occurred
+
+          # The type of credit event
+          #
+          # @see Stigg::Models::V1::CreditListLedgerResponse::Breakdown#event_type
+          module EventType
+            extend Stigg::Internal::Type::Enum
+
+            CREDITS_GRANTED = :CREDITS_GRANTED
+            CREDITS_EXPIRED = :CREDITS_EXPIRED
+            CREDITS_CONSUMED = :CREDITS_CONSUMED
+            CREDITS_VOIDED = :CREDITS_VOIDED
+            CREDITS_UPDATED = :CREDITS_UPDATED
+            CREDITS_CONSUMPTION_TRANSFER_SOURCE = :CREDITS_CONSUMPTION_TRANSFER_SOURCE
+            CREDITS_CONSUMPTION_TRANSFER_TARGET = :CREDITS_CONSUMPTION_TRANSFER_TARGET
+            CREDITS_RESERVED = :CREDITS_RESERVED
+            CREDITS_RESERVATION_RELEASED = :CREDITS_RESERVATION_RELEASED
+            CREDITS_RESERVATION_EXPIRED = :CREDITS_RESERVATION_EXPIRED
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+
         # The type of credit event
         #
         # @see Stigg::Models::V1::CreditListLedgerResponse#event_type
@@ -95,6 +246,9 @@ module Stigg
           CREDITS_UPDATED = :CREDITS_UPDATED
           CREDITS_CONSUMPTION_TRANSFER_SOURCE = :CREDITS_CONSUMPTION_TRANSFER_SOURCE
           CREDITS_CONSUMPTION_TRANSFER_TARGET = :CREDITS_CONSUMPTION_TRANSFER_TARGET
+          CREDITS_RESERVED = :CREDITS_RESERVED
+          CREDITS_RESERVATION_RELEASED = :CREDITS_RESERVATION_RELEASED
+          CREDITS_RESERVATION_EXPIRED = :CREDITS_RESERVATION_EXPIRED
 
           # @!method self.values
           #   @return [Array<Symbol>]

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

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+module Stigg
+  module Models
+    module V1
+      module Credits
+        # @see Stigg::Resources::V1::Credits::Reservations#release
+        class ReservationReleaseParams < Stigg::Internal::Type::BaseModel
+          extend Stigg::Internal::Type::RequestParameters::Converter
+          include Stigg::Internal::Type::RequestParameters
+
+          # @!attribute reservation_id
+          #
+          #   @return [String]
+          required :reservation_id, String
+
+          # @!attribute consumed_amount
+          #   The amount of credits to consume at release. Up to the reserved amount is
+          #   charged to the credits that backed the reservation; the rest returns to the
+          #   balance, and any amount above the reservation is consumed normally.
+          #
+          #   @return [Float]
+          required :consumed_amount, Float, api_name: :consumedAmount
+
+          # @!attribute currency_id
+          #   The credit currency of the reservation
+          #
+          #   @return [String]
+          required :currency_id, String, api_name: :currencyId
+
+          # @!attribute customer_id
+          #   The customer the reservation was made for
+          #
+          #   @return [String]
+          required :customer_id, String, api_name: :customerId
+
+          # @!attribute resource_id
+          #   The resource the reservation was made for, if any
+          #
+          #   @return [String, nil]
+          optional :resource_id, String, api_name: :resourceId
+
+          # @!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(reservation_id:, consumed_amount:, currency_id:, customer_id:, resource_id: nil, x_account_id: nil, x_environment_id: nil, request_options: {})
+          #   Some parameter documentations has been truncated, see
+          #   {Stigg::Models::V1::Credits::ReservationReleaseParams} for more details.
+          #
+          #   @param reservation_id [String]
+          #
+          #   @param consumed_amount [Float] The amount of credits to consume at release. Up to the reserved amount is charge
+          #
+          #   @param currency_id [String] The credit currency of the reservation
+          #
+          #   @param customer_id [String] The customer the reservation was made for
+          #
+          #   @param resource_id [String] The resource the reservation was made for, if any
+          #
+          #   @param x_account_id [String]
+          #
+          #   @param x_environment_id [String]
+          #
+          #   @param request_options [Stigg::RequestOptions, Hash{Symbol=>Object}]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,165 @@
+# frozen_string_literal: true
+
+module Stigg
+  module Models
+    module V1
+      module Credits
+        # @see Stigg::Resources::V1::Credits::Reservations#release
+        class ReservationReleaseResponse < Stigg::Internal::Type::BaseModel
+          # @!attribute data
+          #   Result of releasing a credit reservation
+          #
+          #   @return [Stigg::Models::V1::Credits::ReservationReleaseResponse::Data]
+          required :data, -> { Stigg::Models::V1::Credits::ReservationReleaseResponse::Data }
+
+          # @!method initialize(data:)
+          #   Response object
+          #
+          #   @param data [Stigg::Models::V1::Credits::ReservationReleaseResponse::Data] Result of releasing a credit reservation
+
+          # @see Stigg::Models::V1::Credits::ReservationReleaseResponse#data
+          class Data < Stigg::Internal::Type::BaseModel
+            # @!attribute credit
+            #   The optimistic credit balance after the release
+            #
+            #   @return [Stigg::Models::V1::Credits::ReservationReleaseResponse::Data::Credit, nil]
+            required :credit, -> { Stigg::Models::V1::Credits::ReservationReleaseResponse::Data::Credit }, nil?: true
+
+            # @!attribute reservation
+            #   The released reservation
+            #
+            #   @return [Stigg::Models::V1::Credits::ReservationReleaseResponse::Data::Reservation]
+            required :reservation, -> { Stigg::Models::V1::Credits::ReservationReleaseResponse::Data::Reservation }
+
+            # @!method initialize(credit:, reservation:)
+            #   Result of releasing a credit reservation
+            #
+            #   @param credit [Stigg::Models::V1::Credits::ReservationReleaseResponse::Data::Credit, nil] The optimistic credit balance after the release
+            #
+            #   @param reservation [Stigg::Models::V1::Credits::ReservationReleaseResponse::Data::Reservation] The released reservation
+
+            # @see Stigg::Models::V1::Credits::ReservationReleaseResponse::Data#credit
+            class Credit < Stigg::Internal::Type::BaseModel
+              # @!attribute currency_id
+              #   The credit currency identifier
+              #
+              #   @return [String]
+              required :currency_id, String, api_name: :currencyId
+
+              # @!attribute current_usage
+              #   The wallet's total consumed credits for this currency (optimistic — includes
+              #   not-yet-reconciled usage), shared across every feature that draws on the
+              #   currency. This is the running balance, not this call's deduction — see
+              #   `consumed` for that.
+              #
+              #   @return [Float]
+              required :current_usage, Float, api_name: :currentUsage
+
+              # @!attribute timestamp
+              #   The grant-version timestamp of this balance, used by the SDK for last-write-wins
+              #   reconciliation
+              #
+              #   @return [Time]
+              required :timestamp, Time
+
+              # @!attribute usage_limit
+              #   The total credits granted
+              #
+              #   @return [Float]
+              required :usage_limit, Float, api_name: :usageLimit
+
+              # @!attribute usage_period_end
+              #   End of the current credit grant period (when recurring credits reset), if
+              #   applicable
+              #
+              #   @return [Time, nil]
+              optional :usage_period_end, Time, api_name: :usagePeriodEnd, nil?: true
+
+              # @!method initialize(currency_id:, current_usage:, timestamp:, usage_limit:, usage_period_end: nil)
+              #   Some parameter documentations has been truncated, see
+              #   {Stigg::Models::V1::Credits::ReservationReleaseResponse::Data::Credit} for more
+              #   details.
+              #
+              #   The optimistic credit balance after the release
+              #
+              #   @param currency_id [String] The credit currency identifier
+              #
+              #   @param current_usage [Float] The wallet's total consumed credits for this currency (optimistic — includes not
+              #
+              #   @param timestamp [Time] The grant-version timestamp of this balance, used by the SDK for last-write-wins
+              #
+              #   @param usage_limit [Float] The total credits granted
+              #
+              #   @param usage_period_end [Time, nil] End of the current credit grant period (when recurring credits reset), if applic
+            end
+
+            # @see Stigg::Models::V1::Credits::ReservationReleaseResponse::Data#reservation
+            class Reservation < Stigg::Internal::Type::BaseModel
+              # @!attribute id
+              #   The client-provided reservation ID.
+              #
+              #   @return [String]
+              required :id, String
+
+              # @!attribute amount
+              #   The amount of credits held.
+              #
+              #   @return [Float]
+              required :amount, Float
+
+              # @!attribute consumed_amount
+              #   The amount consumed at release
+              #
+              #   @return [Float, nil]
+              required :consumed_amount, Float, api_name: :consumedAmount, nil?: true
+
+              # @!attribute expires_at
+              #   When the reservation expires. Unreleased credits return to the balance at this
+              #   time.
+              #
+              #   @return [Time]
+              required :expires_at, Time, api_name: :expiresAt
+
+              # @!attribute status
+              #   The status of the reservation.
+              #
+              #   @return [Symbol, Stigg::Models::V1::Credits::ReservationReleaseResponse::Data::Reservation::Status]
+              required :status,
+                       enum: -> { Stigg::Models::V1::Credits::ReservationReleaseResponse::Data::Reservation::Status }
+
+              # @!method initialize(id:, amount:, consumed_amount:, expires_at:, status:)
+              #   Some parameter documentations has been truncated, see
+              #   {Stigg::Models::V1::Credits::ReservationReleaseResponse::Data::Reservation} for
+              #   more details.
+              #
+              #   The released reservation
+              #
+              #   @param id [String] The client-provided reservation ID.
+              #
+              #   @param amount [Float] The amount of credits held.
+              #
+              #   @param consumed_amount [Float, nil] The amount consumed at release
+              #
+              #   @param expires_at [Time] When the reservation expires. Unreleased credits return to the balance at this t
+              #
+              #   @param status [Symbol, Stigg::Models::V1::Credits::ReservationReleaseResponse::Data::Reservation::Status] The status of the reservation.
+
+              # The status of the reservation.
+              #
+              # @see Stigg::Models::V1::Credits::ReservationReleaseResponse::Data::Reservation#status
+              module Status
+                extend Stigg::Internal::Type::Enum
+
+                ACTIVE = :ACTIVE
+                RELEASED = :RELEASED
+
+                # @!method self.values
+                #   @return [Array<Symbol>]
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -39,6 +39,40 @@ module Stigg
         #   @return [Array<String>, nil]
         optional :requested_values, Stigg::Internal::Type::ArrayOf[String]
 
+        # @!attribute reservation_expires_at
+        #   When the reservation expires (ISO 8601, at most 24 hours ahead). Mutually
+        #   exclusive with `reservationTtlSeconds`.
+        #
+        #   @return [Time, nil]
+        optional :reservation_expires_at, Time
+
+        # @!attribute reservation_id
+        #   Client-provided reservation ID, required with `reserveAmount`. Retry with the
+        #   same ID to get the same result; reuse with different parameters is a conflict.
+        #
+        #   @return [String, nil]
+        optional :reservation_id, String
+
+        # @!attribute reservation_metadata
+        #   JSON-encoded object of string values to attach to the reservation.
+        #
+        #   @return [String, nil]
+        optional :reservation_metadata, String
+
+        # @!attribute reservation_ttl_seconds
+        #   How long the reservation holds the credits, in seconds (1–86400, default 3600).
+        #   Mutually exclusive with `reservationExpiresAt`.
+        #
+        #   @return [Integer, nil]
+        optional :reservation_ttl_seconds, Integer
+
+        # @!attribute reserve_amount
+        #   Credits to reserve (credit entitlements only). The check is decided and the
+        #   credits held atomically; `requestedUsage` is ignored.
+        #
+        #   @return [Float, nil]
+        optional :reserve_amount, Float
+
         # @!attribute resource_id
         #   Resource ID to scope the entitlement check to a specific resource
         #
@@ -55,7 +89,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, resource_id: nil, x_account_id: nil, x_environment_id: nil, request_options: {})
+        # @!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: {})
         #   Some parameter documentations has been truncated, see
         #   {Stigg::Models::V1::CustomerCheckEntitlementParams} for more details.
         #
@@ -69,6 +103,16 @@ module Stigg
         #
         #   @param requested_values [Array<String>] Requested values to evaluate against allowed values (enum features only)
         #
+        #   @param reservation_expires_at [Time] When the reservation expires (ISO 8601, at most 24 hours ahead). Mutually exclus
+        #
+        #   @param reservation_id [String] Client-provided reservation ID, required with `reserveAmount`. Retry with the sa
+        #
+        #   @param reservation_metadata [String] JSON-encoded object of string values to attach to the reservation.
+        #
+        #   @param reservation_ttl_seconds [Integer] How long the reservation holds the credits, in seconds (1–86400, default 3600).
+        #
+        #   @param reserve_amount [Float] Credits to reserve (credit entitlements only). The check is decided and the cred
+        #
         #   @param resource_id [String] Resource ID to scope the entitlement check to a specific resource
         #
         #   @param x_account_id [String]