metronome-sdk 2.1.0 → 2.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f70b65323a25a4de65861565a092a6aa70f43d28e5e910acca44d883efe9cf86
-  data.tar.gz: 4d89458274f95fb69ca5d6bccad455a6ecaf92a3d1a93b8843290166f724e01d
+  metadata.gz: 24c53b426a786c58cd7f8d4ae93526596c3a4fa93b6b662e5de17309317f36e5
+  data.tar.gz: 1409a92e54deccc0ae37945c293b208cf27149114eae2509af99fe87a4584ece
 SHA512:
-  metadata.gz: '010907bdf574da3664f42af09be522e41a87dfc4ae1280ee4307326c8d62751c1fdc11bfec4214ec22176cbaf0002a2f1a7b6ed3668da3fb3347ab2bdb3b5494'
-  data.tar.gz: d9be0ec4d10b760064dc84412f78c074258613af6b2ba7e33432ddade4c39d6356ed9d4fc59fb7a89eadc1ce4cd99f893e7c329bbedc27b4dc8e3ac8f76d1c5d
+  metadata.gz: 7472b69ef8d4e84138a0b0818d3cf770268065044819e86804727fc00dc92c66b4f1e36ffac58131da73983ab124d3872aae8054bbc4731581aab51168eb08b3
+  data.tar.gz: 5cffe8618d7460adf817768b5a91d0d478c1ed1103211571def61d3e76c5fa31adf91847158d62e188fd170edc88d718f1501c5966249314acd45f92dfa1a716

data/CHANGELOG.md

@@ -1,5 +1,44 @@
 # Changelog
 
+## 2.2.0 (2025-12-18)
+
+Full Changelog: [v2.1.0...v2.2.0](https://github.com/Metronome-Industries/metronome-ruby/compare/v2.1.0...v2.2.0)
+
+### Features
+
+* [ORCH-605] uses x-mint groups to enable conditional rendering of gated revenue system config apis ([22ceee8](https://github.com/Metronome-Industries/metronome-ruby/commit/22ceee870bf6b1642ff4283b37485be599658e47))
+* [ORCH-752] Update contract creation endpoints to allow setting revenue system configuration ([c2ca4f7](https://github.com/Metronome-Industries/metronome-ruby/commit/c2ca4f7ef46b0ead89b74a6e75a37a2ba55d9dc8))
+* Add `commit_transactions` to the body of `/upsertAvalaraCredentials` endpoint ([d99cab3](https://github.com/Metronome-Industries/metronome-ruby/commit/d99cab3cda4f2da4f80ec925c76583e31ea1763a))
+* Add `seat_filter` field to creation request and response parameters of the alert object ([165e3f0](https://github.com/Metronome-Industries/metronome-ruby/commit/165e3f0deab903b00fb7b4b235179b52a4f8093f))
+* add quantity to plan pricing adjustment response ([cbf2539](https://github.com/Metronome-Industries/metronome-ruby/commit/cbf2539bbab6fac9f0d4984cd0f88c9f6b0ceea2))
+* adds external_payment_id to ExternalInvoice ([ff5f18f](https://github.com/Metronome-Industries/metronome-ruby/commit/ff5f18f6b14e08b4c499689ca329b357a03177a9))
+* everything ([6188141](https://github.com/Metronome-Industries/metronome-ruby/commit/618814115adbe126a1b0b5a330244034a14c98f7))
+* GET-6845 get openapi specs ready for GA ([dc48f09](https://github.com/Metronome-Industries/metronome-ruby/commit/dc48f094c3283251a7f452aa4cc3db917ee7eba6))
+* include aggregation BM info from searchEvents ([ea0dfc0](https://github.com/Metronome-Industries/metronome-ruby/commit/ea0dfc021a244b0e0d3ebfbcdacfc053f5194b61))
+* ORCH-833/948/946/947 - updated the API to accept aws_customer_account_id all gated behind a feature flag ([4c2e292](https://github.com/Metronome-Industries/metronome-ruby/commit/4c2e2926ed8b6d0844b3670312f9780f14df2beb))
+* remove beta language, FF, stainless skip ([b504def](https://github.com/Metronome-Industries/metronome-ruby/commit/b504defa5b97aa3f622bbc746e76ac12691d1e90))
+* Return values for set customer billing configuration endpoint ([1641a74](https://github.com/Metronome-Industries/metronome-ruby/commit/1641a74439ebf507fb85f0478bbd056f6047c173))
+* update create alert api to allow LowRemainingSeatBalanceReached alert ([54a60e6](https://github.com/Metronome-Industries/metronome-ruby/commit/54a60e6027b889e61554b7a006c780e3a9fc4815))
+
+
+### Bug Fixes
+
+* better thread safety via early initializing SSL store during HTTP client creation ([341992d](https://github.com/Metronome-Industries/metronome-ruby/commit/341992d633b9191d24209713f5f6a734d2229601))
+* calling `break` out of streams should be instantaneous ([0db918b](https://github.com/Metronome-Industries/metronome-ruby/commit/0db918bb075b3420715faf0e73ef96cc01d58697))
+* issue where json.parse errors when receiving HTTP 204 with nobody ([7a27bb6](https://github.com/Metronome-Industries/metronome-ruby/commit/7a27bb648e886deaf33358cde8f5c3c5d80ccf42))
+
+
+### Chores
+
+* **client:** send user-agent header ([379e4e4](https://github.com/Metronome-Industries/metronome-ruby/commit/379e4e46eb858bce94633dd193fbc1526ea1c42c))
+* explicitly require "base64" gem ([5d4a7dc](https://github.com/Metronome-Industries/metronome-ruby/commit/5d4a7dc568346f2fc33ab39cf1517582923d98d5))
+* **internal:** codegen related update ([9878983](https://github.com/Metronome-Industries/metronome-ruby/commit/9878983e4d67b0d04d543d7a49afdd14e9eb4f73))
+
+
+### Documentation
+
+* document missing fields for schemas related to recurring credits and commits ([d848e15](https://github.com/Metronome-Industries/metronome-ruby/commit/d848e159b2046aebccea5d2b3915779adf891791))
+
 ## 2.1.0 (2025-10-31)
 
 Full Changelog: [v2.0.0...v2.1.0](https://github.com/Metronome-Industries/metronome-ruby/compare/v2.0.0...v2.1.0)

data/README.md

@@ -17,7 +17,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "metronome-sdk", "~> 2.1.0"
+gem "metronome-sdk", "~> 2.2.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/metronome_sdk/internal/transport/base_client.rb

@@ -201,7 +201,8 @@ module MetronomeSDK
             self.class::PLATFORM_HEADERS,
             {
               "accept" => "application/json",
-              "content-type" => "application/json"
+              "content-type" => "application/json",
+              "user-agent" => user_agent
             },
             headers
           )
@@ -219,6 +220,11 @@ module MetronomeSDK
         # @return [Hash{String=>String}]
         private def auth_headers = {}
 
+        # @api private
+        #
+        # @return [String]
+        private def user_agent = "#{self.class.name}/Ruby #{MetronomeSDK::VERSION}"
+
         # @api private
         #
         # @return [String]

data/lib/metronome_sdk/internal/transport/pooled_net_requester.rb

@@ -16,10 +16,11 @@ module MetronomeSDK
         class << self
           # @api private
           #
+          # @param cert_store [OpenSSL::X509::Store]
           # @param url [URI::Generic]
           #
           # @return [Net::HTTP]
-          def connect(url)
+          def connect(cert_store:, url:)
             port =
               case [url.port, url.scheme]
               in [Integer, _]
@@ -33,6 +34,8 @@ module MetronomeSDK
             Net::HTTP.new(url.host, port).tap do
               _1.use_ssl = %w[https wss].include?(url.scheme)
               _1.max_retries = 0
+
+              (_1.cert_store = cert_store) if _1.use_ssl?
             end
           end
 
@@ -102,7 +105,7 @@ module MetronomeSDK
           pool =
             @mutex.synchronize do
               @pools[origin] ||= ConnectionPool.new(size: @size) do
-                self.class.connect(url)
+                self.class.connect(cert_store: @cert_store, url: url)
               end
             end
 
@@ -150,17 +153,19 @@ module MetronomeSDK
                   end
 
                   self.class.calibrate_socket_timeout(conn, deadline)
-                  conn.request(req) do |rsp|
-                    y << [req, rsp]
-                    break if finished
-
-                    rsp.read_body do |bytes|
-                      y << bytes.force_encoding(Encoding::BINARY)
-                      break if finished
-
-                      self.class.calibrate_socket_timeout(conn, deadline)
+                  ::Kernel.catch(:jump) do
+                    conn.request(req) do |rsp|
+                      y << [req, rsp]
+                      ::Kernel.throw(:jump) if finished
+
+                      rsp.read_body do |bytes|
+                        y << bytes.force_encoding(Encoding::BINARY)
+                        ::Kernel.throw(:jump) if finished
+
+                        self.class.calibrate_socket_timeout(conn, deadline)
+                      end
+                      eof = true
                     end
-                    eof = true
                   end
                 end
               ensure
@@ -192,6 +197,7 @@ module MetronomeSDK
         def initialize(size: self.class::DEFAULT_MAX_CONNECTIONS)
           @mutex = Mutex.new
           @size = size
+          @cert_store = OpenSSL::X509::Store.new.tap(&:set_default_paths)
           @pools = {}
         end
 

data/lib/metronome_sdk/internal/util.rb

@@ -657,7 +657,8 @@ module MetronomeSDK
         def decode_content(headers, stream:, suppress_error: false)
           case (content_type = headers["content-type"])
           in MetronomeSDK::Internal::Util::JSON_CONTENT
-            json = stream.to_a.join
+            return nil if (json = stream.to_a.join).empty?
+
             begin
               JSON.parse(json, symbolize_names: true)
             rescue JSON::ParserError => e
@@ -667,7 +668,11 @@ module MetronomeSDK
           in MetronomeSDK::Internal::Util::JSONL_CONTENT
             lines = decode_lines(stream)
             chain_fused(lines) do |y|
-              lines.each { y << JSON.parse(_1, symbolize_names: true) }
+              lines.each do
+                next if _1.empty?
+
+                y << JSON.parse(_1, symbolize_names: true)
+              end
             end
           in %r{^text/event-stream}
             lines = decode_lines(stream)

data/lib/metronome_sdk/models/contract_v2.rb

@@ -445,7 +445,13 @@ module MetronomeSDK
         #   @return [Array<MetronomeSDK::Models::CommitSpecifier>, nil]
         optional :specifiers, -> { MetronomeSDK::Internal::Type::ArrayOf[MetronomeSDK::CommitSpecifier] }
 
-        # @!method initialize(id:, created_at:, product:, type:, access_schedule: nil, applicable_contract_ids: nil, applicable_product_ids: nil, applicable_product_tags: nil, archived_at: nil, balance: nil, contract: nil, custom_fields: nil, description: nil, hierarchy_configuration: nil, invoice_contract: nil, invoice_schedule: nil, ledger: nil, name: nil, netsuite_sales_order_id: nil, priority: nil, rate_type: nil, rolled_over_from: nil, rollover_fraction: nil, salesforce_opportunity_id: nil, specifiers: nil)
+        # @!attribute subscription_config
+        #   Attach a subscription to the recurring commit/credit.
+        #
+        #   @return [MetronomeSDK::Models::RecurringCommitSubscriptionConfig, nil]
+        optional :subscription_config, -> { MetronomeSDK::RecurringCommitSubscriptionConfig }
+
+        # @!method initialize(id:, created_at:, product:, type:, access_schedule: nil, applicable_contract_ids: nil, applicable_product_ids: nil, applicable_product_tags: nil, archived_at: nil, balance: nil, contract: nil, custom_fields: nil, description: nil, hierarchy_configuration: nil, invoice_contract: nil, invoice_schedule: nil, ledger: nil, name: nil, netsuite_sales_order_id: nil, priority: nil, rate_type: nil, rolled_over_from: nil, rollover_fraction: nil, salesforce_opportunity_id: nil, specifiers: nil, subscription_config: nil)
         #   Some parameter documentations has been truncated, see
         #   {MetronomeSDK::Models::ContractV2::Commit} for more details.
         #
@@ -498,6 +504,8 @@ module MetronomeSDK
         #   @param salesforce_opportunity_id [String] This field's availability is dependent on your client's configuration.
         #
         #   @param specifiers [Array<MetronomeSDK::Models::CommitSpecifier>] List of filters that determine what kind of customer usage draws down a commit o
+        #
+        #   @param subscription_config [MetronomeSDK::Models::RecurringCommitSubscriptionConfig] Attach a subscription to the recurring commit/credit.
 
         # @see MetronomeSDK::Models::ContractV2::Commit#product
         class Product < MetronomeSDK::Internal::Type::BaseModel
@@ -1646,6 +1654,15 @@ module MetronomeSDK
         #   @return [MetronomeSDK::Models::ContractV2::Credit::Contract, nil]
         optional :contract, -> { MetronomeSDK::ContractV2::Credit::Contract }
 
+        # @!attribute created_at
+        #   Timestamp of when the credit was created.
+        #
+        #   - Recurring credits: latter of credit service period date and parent credit
+        #     start date
+        #
+        #   @return [Time, nil]
+        optional :created_at, Time
+
         # @!attribute custom_fields
         #   Custom fields to be added eg. { "key1": "value1", "key2": "value2" }
         #
@@ -1703,7 +1720,13 @@ module MetronomeSDK
         #   @return [Array<MetronomeSDK::Models::CommitSpecifier>, nil]
         optional :specifiers, -> { MetronomeSDK::Internal::Type::ArrayOf[MetronomeSDK::CommitSpecifier] }
 
-        # @!method initialize(id:, product:, type:, access_schedule: nil, applicable_contract_ids: nil, applicable_product_ids: nil, applicable_product_tags: nil, balance: nil, contract: nil, custom_fields: nil, description: nil, hierarchy_configuration: nil, ledger: nil, name: nil, netsuite_sales_order_id: nil, priority: nil, salesforce_opportunity_id: nil, specifiers: nil)
+        # @!attribute subscription_config
+        #   Attach a subscription to the recurring commit/credit.
+        #
+        #   @return [MetronomeSDK::Models::RecurringCommitSubscriptionConfig, nil]
+        optional :subscription_config, -> { MetronomeSDK::RecurringCommitSubscriptionConfig }
+
+        # @!method initialize(id:, product:, type:, access_schedule: nil, applicable_contract_ids: nil, applicable_product_ids: nil, applicable_product_tags: nil, balance: nil, contract: nil, created_at: nil, custom_fields: nil, description: nil, hierarchy_configuration: nil, ledger: nil, name: nil, netsuite_sales_order_id: nil, priority: nil, salesforce_opportunity_id: nil, specifiers: nil, subscription_config: nil)
         #   Some parameter documentations has been truncated, see
         #   {MetronomeSDK::Models::ContractV2::Credit} for more details.
         #
@@ -1725,6 +1748,8 @@ module MetronomeSDK
         #
         #   @param contract [MetronomeSDK::Models::ContractV2::Credit::Contract]
         #
+        #   @param created_at [Time] Timestamp of when the credit was created.
+        #
         #   @param custom_fields [Hash{Symbol=>String}] Custom fields to be added eg. { "key1": "value1", "key2": "value2" }
         #
         #   @param description [String]
@@ -1742,6 +1767,8 @@ module MetronomeSDK
         #   @param salesforce_opportunity_id [String] This field's availability is dependent on your client's configuration.
         #
         #   @param specifiers [Array<MetronomeSDK::Models::CommitSpecifier>] List of filters that determine what kind of customer usage draws down a commit o
+        #
+        #   @param subscription_config [MetronomeSDK::Models::RecurringCommitSubscriptionConfig] Attach a subscription to the recurring commit/credit.
 
         # @see MetronomeSDK::Models::ContractV2::Credit#product
         class Product < MetronomeSDK::Internal::Type::BaseModel

data/lib/metronome_sdk/models/subscription.rb

@@ -24,8 +24,8 @@ module MetronomeSDK
       #   QUANTITY_ONLY. **QUANTITY_ONLY**: The subscription quantity is specified
       #   directly on the subscription. `initial_quantity` must be provided with this
       #   option. Compatible with recurring commits/credits that use POOLED allocation.
-      #   **SEAT_BASED**: (BETA) Use when you want to pass specific seat identifiers (e.g.
-      #   add user_123) to increment and decrement a subscription quantity, rather than
+      #   **SEAT_BASED**: Use when you want to pass specific seat identifiers (e.g. add
+      #   user_123) to increment and decrement a subscription quantity, rather than
       #   directly providing the quantity. You must use a **SEAT_BASED** subscription to
       #   use a linked recurring credit with an allocation per seat. `seat_config` must be
       #   provided with this option.
@@ -82,7 +82,12 @@ module MetronomeSDK
       #   @return [String, nil]
       optional :name, String
 
-      # @!method initialize(billing_periods:, collection_schedule:, proration:, quantity_management_mode:, quantity_schedule:, starting_at:, subscription_rate:, id: nil, custom_fields: nil, description: nil, ending_before: nil, fiat_credit_type_id: nil, name: nil)
+      # @!attribute seat_config
+      #
+      #   @return [MetronomeSDK::Models::Subscription::SeatConfig, nil]
+      optional :seat_config, -> { MetronomeSDK::Subscription::SeatConfig }
+
+      # @!method initialize(billing_periods:, collection_schedule:, proration:, quantity_management_mode:, quantity_schedule:, starting_at:, subscription_rate:, id: nil, custom_fields: nil, description: nil, ending_before: nil, fiat_credit_type_id: nil, name: nil, seat_config: nil)
       #   Some parameter documentations has been truncated, see
       #   {MetronomeSDK::Models::Subscription} for more details.
       #
@@ -111,6 +116,8 @@ module MetronomeSDK
       #   @param fiat_credit_type_id [String]
       #
       #   @param name [String]
+      #
+      #   @param seat_config [MetronomeSDK::Models::Subscription::SeatConfig]
 
       # @see MetronomeSDK::Models::Subscription#billing_periods
       class BillingPeriods < MetronomeSDK::Internal::Type::BaseModel
@@ -231,8 +238,8 @@ module MetronomeSDK
       # QUANTITY_ONLY. **QUANTITY_ONLY**: The subscription quantity is specified
       # directly on the subscription. `initial_quantity` must be provided with this
       # option. Compatible with recurring commits/credits that use POOLED allocation.
-      # **SEAT_BASED**: (BETA) Use when you want to pass specific seat identifiers (e.g.
-      # add user_123) to increment and decrement a subscription quantity, rather than
+      # **SEAT_BASED**: Use when you want to pass specific seat identifiers (e.g. add
+      # user_123) to increment and decrement a subscription quantity, rather than
       # directly providing the quantity. You must use a **SEAT_BASED** subscription to
       # use a linked recurring credit with an allocation per seat. `seat_config` must be
       # provided with this option.
@@ -316,6 +323,26 @@ module MetronomeSDK
           #   @param name [String]
         end
       end
+
+      # @see MetronomeSDK::Models::Subscription#seat_config
+      class SeatConfig < MetronomeSDK::Internal::Type::BaseModel
+        # @!attribute seat_group_key
+        #   The property name, sent on usage events, that identifies the seat ID associated
+        #   with the usage event. For example, the property name might be seat_id or
+        #   user_id. The property must be set as a group key on billable metrics and a
+        #   presentation/pricing group key on contract products. This allows linked
+        #   recurring credits with an allocation per seat to be consumed by only one seat's
+        #   usage.
+        #
+        #   @return [String]
+        required :seat_group_key, String
+
+        # @!method initialize(seat_group_key:)
+        #   Some parameter documentations has been truncated, see
+        #   {MetronomeSDK::Models::Subscription::SeatConfig} for more details.
+        #
+        #   @param seat_group_key [String] The property name, sent on usage events, that identifies the seat ID associated
+      end
     end
   end
 end

data/lib/metronome_sdk/models/v1/alert_create_params.rb

@@ -97,6 +97,13 @@ module MetronomeSDK
         #   @return [String, nil]
         optional :plan_id, String
 
+        # @!attribute seat_filter
+        #   Required for `low_remaining_seat_balance_reached` notifications. The alert is
+        #   scoped to this seat group key-value pair.
+        #
+        #   @return [MetronomeSDK::Models::V1::AlertCreateParams::SeatFilter, nil]
+        optional :seat_filter, -> { MetronomeSDK::V1::AlertCreateParams::SeatFilter }
+
         # @!attribute uniqueness_key
         #   Prevents the creation of duplicates. If a request to create a record is made
         #   with a previously used uniqueness key, a new record will not be created and the
@@ -105,7 +112,7 @@ module MetronomeSDK
         #   @return [String, nil]
         optional :uniqueness_key, String
 
-        # @!method initialize(alert_type:, name:, threshold:, billable_metric_id: nil, credit_grant_type_filters: nil, credit_type_id: nil, custom_field_filters: nil, customer_id: nil, evaluate_on_create: nil, group_values: nil, invoice_types_filter: nil, plan_id: nil, uniqueness_key: nil, request_options: {})
+        # @!method initialize(alert_type:, name:, threshold:, billable_metric_id: nil, credit_grant_type_filters: nil, credit_type_id: nil, custom_field_filters: nil, customer_id: nil, evaluate_on_create: nil, group_values: nil, invoice_types_filter: nil, plan_id: nil, seat_filter: nil, uniqueness_key: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {MetronomeSDK::Models::V1::AlertCreateParams} for more details.
         #
@@ -133,6 +140,8 @@ module MetronomeSDK
         #
         #   @param plan_id [String] If provided, will create this threshold notification for this specific plan. To
         #
+        #   @param seat_filter [MetronomeSDK::Models::V1::AlertCreateParams::SeatFilter] Required for `low_remaining_seat_balance_reached` notifications. The alert is sc
+        #
         #   @param uniqueness_key [String] Prevents the creation of duplicates. If a request to create a record is made wit
         #
         #   @param request_options [MetronomeSDK::RequestOptions, Hash{Symbol=>Object}]
@@ -157,6 +166,7 @@ module MetronomeSDK
           LOW_REMAINING_CONTRACT_CREDIT_AND_COMMIT_BALANCE_REACHED =
             :low_remaining_contract_credit_and_commit_balance_reached
           INVOICE_TOTAL_REACHED = :invoice_total_reached
+          LOW_REMAINING_SEAT_BALANCE_REACHED = :low_remaining_seat_balance_reached
 
           # @!method self.values
           #   @return [Array<Symbol>]
@@ -211,6 +221,28 @@ module MetronomeSDK
           #   @param key [String]
           #   @param value [String]
         end
+
+        class SeatFilter < MetronomeSDK::Internal::Type::BaseModel
+          # @!attribute seat_group_key
+          #   The seat group key (e.g., "seat_id", "user_id")
+          #
+          #   @return [String]
+          required :seat_group_key, String
+
+          # @!attribute seat_group_value
+          #   Optional seat identifier the alert is scoped to.
+          #
+          #   @return [String, nil]
+          optional :seat_group_value, String
+
+          # @!method initialize(seat_group_key:, seat_group_value: nil)
+          #   Required for `low_remaining_seat_balance_reached` notifications. The alert is
+          #   scoped to this seat group key-value pair.
+          #
+          #   @param seat_group_key [String] The seat group key (e.g., "seat_id", "user_id")
+          #
+          #   @param seat_group_value [String] Optional seat identifier the alert is scoped to.
+        end
       end
     end
   end

data/lib/metronome_sdk/models/v1/contract_add_manual_balance_entry_params.rb

@@ -44,6 +44,13 @@ module MetronomeSDK
         #   @return [String, nil]
         optional :contract_id, String
 
+        # @!attribute per_group_amounts
+        #   If using individually configured commits/credits attached to seat managed
+        #   subscriptions, the amount to add for each seat. Must sum to total amount.
+        #
+        #   @return [Hash{Symbol=>Float}, nil]
+        optional :per_group_amounts, MetronomeSDK::Internal::Type::HashOf[Float]
+
         # @!attribute timestamp
         #   RFC 3339 timestamp indicating when the manual adjustment takes place. If not
         #   provided, it will default to the start of the segment.
@@ -51,7 +58,7 @@ module MetronomeSDK
         #   @return [Time, nil]
         optional :timestamp, Time
 
-        # @!method initialize(id:, amount:, customer_id:, reason:, segment_id:, contract_id: nil, timestamp: nil, request_options: {})
+        # @!method initialize(id:, amount:, customer_id:, reason:, segment_id:, contract_id: nil, per_group_amounts: nil, timestamp: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {MetronomeSDK::Models::V1::ContractAddManualBalanceEntryParams} for more
         #   details.
@@ -68,6 +75,8 @@ module MetronomeSDK
         #
         #   @param contract_id [String] ID of the contract to update. Leave blank to update a customer level balance.
         #
+        #   @param per_group_amounts [Hash{Symbol=>Float}] If using individually configured commits/credits attached to seat managed subscr
+        #
         #   @param timestamp [Time] RFC 3339 timestamp indicating when the manual adjustment takes place. If not pro
         #
         #   @param request_options [MetronomeSDK::RequestOptions, Hash{Symbol=>Object}]