metronome-sdk 3.5.0 → 3.6.0

data/lib/metronome_sdk/models/v2/contract_get_edit_history_response.rb

@@ -86,8 +86,9 @@ module MetronomeSDK
           # @!attribute add_subscriptions
           #   List of subscriptions on the contract.
           #
-          #   @return [Array<MetronomeSDK::Models::Subscription>, nil]
-          optional :add_subscriptions, -> { MetronomeSDK::Internal::Type::ArrayOf[MetronomeSDK::Subscription] }
+          #   @return [Array<MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription>, nil]
+          optional :add_subscriptions,
+                   -> { MetronomeSDK::Internal::Type::ArrayOf[MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription] }
 
           # @!attribute add_usage_filters
           #
@@ -234,7 +235,7 @@ module MetronomeSDK
           #
           #   @param add_spend_threshold_configuration [MetronomeSDK::Models::SpendThresholdConfigurationV2]
           #
-          #   @param add_subscriptions [Array<MetronomeSDK::Models::Subscription>] List of subscriptions on the contract.
+          #   @param add_subscriptions [Array<MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription>] List of subscriptions on the contract.
           #
           #   @param add_usage_filters [Array<MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddUsageFilter>]
           #
@@ -1774,6 +1775,364 @@ module MetronomeSDK
             end
           end
 
+          class AddSubscription < MetronomeSDK::Internal::Type::BaseModel
+            # @!attribute billing_periods
+            #   Previous, current, and next billing periods for the subscription.
+            #
+            #   @return [MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription::BillingPeriods]
+            required :billing_periods,
+                     -> { MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription::BillingPeriods }
+
+            # @!attribute collection_schedule
+            #
+            #   @return [Symbol, MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription::CollectionSchedule]
+            required :collection_schedule,
+                     enum: -> { MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription::CollectionSchedule }
+
+            # @!attribute proration
+            #
+            #   @return [MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription::Proration]
+            required :proration,
+                     -> { MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription::Proration }
+
+            # @!attribute quantity_management_mode
+            #   Determines how the subscription's quantity is controlled. Defaults to
+            #   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**: 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.
+            #
+            #   @return [Symbol, MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription::QuantityManagementMode]
+            required :quantity_management_mode,
+                     enum: -> { MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription::QuantityManagementMode }
+
+            # @!attribute quantity_schedule
+            #   List of quantity schedule items for the subscription. Only includes the current
+            #   quantity and future quantity changes.
+            #
+            #   @return [Array<MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription::QuantitySchedule>]
+            required :quantity_schedule,
+                     -> { MetronomeSDK::Internal::Type::ArrayOf[MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription::QuantitySchedule] }
+
+            # @!attribute starting_at
+            #
+            #   @return [Time]
+            required :starting_at, Time
+
+            # @!attribute subscription_rate
+            #
+            #   @return [MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription::SubscriptionRate]
+            required :subscription_rate,
+                     -> { MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription::SubscriptionRate }
+
+            # @!attribute id
+            #
+            #   @return [String, nil]
+            optional :id, String
+
+            # @!attribute custom_fields
+            #   Custom fields to be added eg. { "key1": "value1", "key2": "value2" }
+            #
+            #   @return [Hash{Symbol=>String}, nil]
+            optional :custom_fields, MetronomeSDK::Internal::Type::HashOf[String]
+
+            # @!attribute description
+            #
+            #   @return [String, nil]
+            optional :description, String
+
+            # @!attribute ending_before
+            #
+            #   @return [Time, nil]
+            optional :ending_before, Time
+
+            # @!attribute fiat_credit_type_id
+            #
+            #   @return [String, nil]
+            optional :fiat_credit_type_id, String
+
+            # @!attribute name
+            #
+            #   @return [String, nil]
+            optional :name, String
+
+            # @!attribute seat_config
+            #
+            #   @return [MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription::SeatConfig, nil]
+            optional :seat_config,
+                     -> { MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription::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::V2::ContractGetEditHistoryResponse::Data::AddSubscription}
+            #   for more details.
+            #
+            #   @param billing_periods [MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription::BillingPeriods] Previous, current, and next billing periods for the subscription.
+            #
+            #   @param collection_schedule [Symbol, MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription::CollectionSchedule]
+            #
+            #   @param proration [MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription::Proration]
+            #
+            #   @param quantity_management_mode [Symbol, MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription::QuantityManagementMode] Determines how the subscription's quantity is controlled. Defaults to QUANTITY_O
+            #
+            #   @param quantity_schedule [Array<MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription::QuantitySchedule>] List of quantity schedule items for the subscription. Only includes the current
+            #
+            #   @param starting_at [Time]
+            #
+            #   @param subscription_rate [MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription::SubscriptionRate]
+            #
+            #   @param id [String]
+            #
+            #   @param custom_fields [Hash{Symbol=>String}] Custom fields to be added eg. { "key1": "value1", "key2": "value2" }
+            #
+            #   @param description [String]
+            #
+            #   @param ending_before [Time]
+            #
+            #   @param fiat_credit_type_id [String]
+            #
+            #   @param name [String]
+            #
+            #   @param seat_config [MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription::SeatConfig]
+
+            # @see MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription#billing_periods
+            class BillingPeriods < MetronomeSDK::Internal::Type::BaseModel
+              # @!attribute current
+              #
+              #   @return [MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription::BillingPeriods::Current, nil]
+              optional :current,
+                       -> { MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription::BillingPeriods::Current }
+
+              # @!attribute next_
+              #
+              #   @return [MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription::BillingPeriods::Next, nil]
+              optional :next_,
+                       -> { MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription::BillingPeriods::Next },
+                       api_name: :next
+
+              # @!attribute previous
+              #
+              #   @return [MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription::BillingPeriods::Previous, nil]
+              optional :previous,
+                       -> { MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription::BillingPeriods::Previous }
+
+              # @!method initialize(current: nil, next_: nil, previous: nil)
+              #   Previous, current, and next billing periods for the subscription.
+              #
+              #   @param current [MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription::BillingPeriods::Current]
+              #   @param next_ [MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription::BillingPeriods::Next]
+              #   @param previous [MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription::BillingPeriods::Previous]
+
+              # @see MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription::BillingPeriods#current
+              class Current < MetronomeSDK::Internal::Type::BaseModel
+                # @!attribute ending_before
+                #
+                #   @return [Time]
+                required :ending_before, Time
+
+                # @!attribute starting_at
+                #
+                #   @return [Time]
+                required :starting_at, Time
+
+                # @!method initialize(ending_before:, starting_at:)
+                #   @param ending_before [Time]
+                #   @param starting_at [Time]
+              end
+
+              # @see MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription::BillingPeriods#next_
+              class Next < MetronomeSDK::Internal::Type::BaseModel
+                # @!attribute ending_before
+                #
+                #   @return [Time]
+                required :ending_before, Time
+
+                # @!attribute starting_at
+                #
+                #   @return [Time]
+                required :starting_at, Time
+
+                # @!method initialize(ending_before:, starting_at:)
+                #   @param ending_before [Time]
+                #   @param starting_at [Time]
+              end
+
+              # @see MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription::BillingPeriods#previous
+              class Previous < MetronomeSDK::Internal::Type::BaseModel
+                # @!attribute ending_before
+                #
+                #   @return [Time]
+                required :ending_before, Time
+
+                # @!attribute starting_at
+                #
+                #   @return [Time]
+                required :starting_at, Time
+
+                # @!method initialize(ending_before:, starting_at:)
+                #   @param ending_before [Time]
+                #   @param starting_at [Time]
+              end
+            end
+
+            # @see MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription#collection_schedule
+            module CollectionSchedule
+              extend MetronomeSDK::Internal::Type::Enum
+
+              ADVANCE = :ADVANCE
+              ARREARS = :ARREARS
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+
+            # @see MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription#proration
+            class Proration < MetronomeSDK::Internal::Type::BaseModel
+              # @!attribute invoice_behavior
+              #
+              #   @return [Symbol, MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription::Proration::InvoiceBehavior]
+              required :invoice_behavior,
+                       enum: -> { MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription::Proration::InvoiceBehavior }
+
+              # @!attribute is_prorated
+              #
+              #   @return [Boolean]
+              required :is_prorated, MetronomeSDK::Internal::Type::Boolean
+
+              # @!method initialize(invoice_behavior:, is_prorated:)
+              #   @param invoice_behavior [Symbol, MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription::Proration::InvoiceBehavior]
+              #   @param is_prorated [Boolean]
+
+              # @see MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription::Proration#invoice_behavior
+              module InvoiceBehavior
+                extend MetronomeSDK::Internal::Type::Enum
+
+                BILL_IMMEDIATELY = :BILL_IMMEDIATELY
+                BILL_ON_NEXT_COLLECTION_DATE = :BILL_ON_NEXT_COLLECTION_DATE
+
+                # @!method self.values
+                #   @return [Array<Symbol>]
+              end
+            end
+
+            # Determines how the subscription's quantity is controlled. Defaults to
+            # 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**: 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.
+            #
+            # @see MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription#quantity_management_mode
+            module QuantityManagementMode
+              extend MetronomeSDK::Internal::Type::Enum
+
+              SEAT_BASED = :SEAT_BASED
+              QUANTITY_ONLY = :QUANTITY_ONLY
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+
+            class QuantitySchedule < MetronomeSDK::Internal::Type::BaseModel
+              # @!attribute quantity
+              #
+              #   @return [Float]
+              required :quantity, Float
+
+              # @!attribute starting_at
+              #
+              #   @return [Time]
+              required :starting_at, Time
+
+              # @!attribute ending_before
+              #
+              #   @return [Time, nil]
+              optional :ending_before, Time
+
+              # @!method initialize(quantity:, starting_at:, ending_before: nil)
+              #   @param quantity [Float]
+              #   @param starting_at [Time]
+              #   @param ending_before [Time]
+            end
+
+            # @see MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription#subscription_rate
+            class SubscriptionRate < MetronomeSDK::Internal::Type::BaseModel
+              # @!attribute billing_frequency
+              #
+              #   @return [Symbol, MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription::SubscriptionRate::BillingFrequency]
+              required :billing_frequency,
+                       enum: -> { MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription::SubscriptionRate::BillingFrequency }
+
+              # @!attribute product
+              #
+              #   @return [MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription::SubscriptionRate::Product]
+              required :product,
+                       -> { MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription::SubscriptionRate::Product }
+
+              # @!method initialize(billing_frequency:, product:)
+              #   @param billing_frequency [Symbol, MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription::SubscriptionRate::BillingFrequency]
+              #   @param product [MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription::SubscriptionRate::Product]
+
+              # @see MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription::SubscriptionRate#billing_frequency
+              module BillingFrequency
+                extend MetronomeSDK::Internal::Type::Enum
+
+                MONTHLY = :MONTHLY
+                QUARTERLY = :QUARTERLY
+                ANNUAL = :ANNUAL
+                WEEKLY = :WEEKLY
+
+                # @!method self.values
+                #   @return [Array<Symbol>]
+              end
+
+              # @see MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription::SubscriptionRate#product
+              class Product < MetronomeSDK::Internal::Type::BaseModel
+                # @!attribute id
+                #
+                #   @return [String]
+                required :id, String
+
+                # @!attribute name
+                #
+                #   @return [String]
+                required :name, String
+
+                # @!method initialize(id:, name:)
+                #   @param id [String]
+                #   @param name [String]
+              end
+            end
+
+            # @see MetronomeSDK::Models::V2::ContractGetEditHistoryResponse::Data::AddSubscription#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::V2::ContractGetEditHistoryResponse::Data::AddSubscription::SeatConfig}
+              #   for more details.
+              #
+              #   @param seat_group_key [String] The property name, sent on usage events, that identifies the seat ID associated
+            end
+          end
+
           class AddUsageFilter < MetronomeSDK::Internal::Type::BaseModel
             # @!attribute group_key
             #

data/lib/metronome_sdk/resources/v1/contracts/products.rb

@@ -15,7 +15,7 @@ module MetronomeSDK
           # an ERP system. Give the product a meaningful name as they will appear on
           # customer invoices.
           #
-          # @overload create(name:, type:, billable_metric_id: nil, composite_product_ids: nil, composite_tags: nil, custom_fields: nil, exclude_free_usage: nil, is_refundable: nil, netsuite_internal_item_id: nil, netsuite_overage_item_id: nil, presentation_group_key: nil, pricing_group_key: nil, quantity_conversion: nil, quantity_rounding: nil, tags: nil, request_options: {})
+          # @overload create(name:, type:, billable_metric_id: nil, composite_product_ids: nil, composite_tags: nil, custom_fields: nil, exclude_free_usage: nil, is_refundable: nil, netsuite_internal_item_id: nil, netsuite_overage_item_id: nil, presentation_group_key: nil, pricing_group_key: nil, quantity_conversion: nil, quantity_rounding: nil, sql_breakdown_granularity: nil, tags: nil, request_options: {})
           #
           # @param name [String] displayed on invoices
           #
@@ -45,6 +45,8 @@ module MetronomeSDK
           #
           # @param quantity_rounding [MetronomeSDK::Models::V1::Contracts::QuantityRounding, nil] Optional. Only valid for USAGE products. If provided, the quantity will be round
           #
+          # @param sql_breakdown_granularity [Symbol, MetronomeSDK::Models::V1::Contracts::ProductCreateParams::SqlBreakdownGranularity] Defines the breakdown behavior when calculating usage from SQL Billable Metrics.
+          #
           # @param tags [Array<String>]
           #
           # @param request_options [MetronomeSDK::RequestOptions, Hash{Symbol=>Object}, nil]
@@ -99,7 +101,7 @@ module MetronomeSDK
           # - Product type cannot be changed after creation. For incorrect product types,
           #   create a new product and archive the original instead.
           #
-          # @overload update(product_id:, starting_at:, billable_metric_id: nil, composite_product_ids: nil, composite_tags: nil, exclude_free_usage: nil, is_refundable: nil, name: nil, netsuite_internal_item_id: nil, netsuite_overage_item_id: nil, presentation_group_key: nil, pricing_group_key: nil, quantity_conversion: nil, quantity_rounding: nil, tags: nil, request_options: {})
+          # @overload update(product_id:, starting_at:, billable_metric_id: nil, composite_product_ids: nil, composite_tags: nil, exclude_free_usage: nil, is_refundable: nil, name: nil, netsuite_internal_item_id: nil, netsuite_overage_item_id: nil, presentation_group_key: nil, pricing_group_key: nil, quantity_conversion: nil, quantity_rounding: nil, sql_breakdown_granularity: nil, tags: nil, request_options: {})
           #
           # @param product_id [String] ID of the product to update
           #
@@ -129,6 +131,8 @@ module MetronomeSDK
           #
           # @param quantity_rounding [MetronomeSDK::Models::V1::Contracts::QuantityRounding, nil] Optional. Only valid for USAGE products. If provided, the quantity will be round
           #
+          # @param sql_breakdown_granularity [Symbol, MetronomeSDK::Models::V1::Contracts::ProductUpdateParams::SqlBreakdownGranularity] Defines the breakdown behavior when calculating usage from SQL Billable Metrics.
+          #
           # @param tags [Array<String>] If not provided, defaults to product's current tags
           #
           # @param request_options [MetronomeSDK::RequestOptions, Hash{Symbol=>Object}, nil]

data/lib/metronome_sdk/resources/v1/contracts.rb

@@ -22,8 +22,8 @@ module MetronomeSDK
         #
         # Contracts define a customer's products, pricing, discounts, access duration, and
         # billing configuration. Contracts serve as the central billing agreement for both
-        # PLG and Enterprise customers, you can automatically customers access to your
-        # products and services directly from your product or CRM.
+        # PLG and Enterprise customers. You can automatically grant customers access to
+        # your products and services directly from your product or CRM.
         #
         # ### Use this endpoint to:
         #
@@ -650,6 +650,73 @@ module MetronomeSDK
           )
         end
 
+        # Some parameter documentations has been truncated, see
+        # {MetronomeSDK::Models::V1::ContractListSeatBalancesParams} for more details.
+        #
+        # Retrieve detailed balance for seat-based credits and commits from the contract's
+        # subscriptions, broken down by individual seats.
+        #
+        # ### Use this endpoint to:
+        #
+        # - Display per-seat balance information in customer dashboards
+        # - Filter balance data by subscription or specific seats
+        #
+        # ### Key response fields:
+        #
+        # An array of seat balance objects containing:
+        #
+        # - Seat id
+        # - Balance: current total balance across all commits and credits
+        #
+        # ### Usage guidelines:
+        #
+        # - Date filtering: use `covering_date` OR `starting_at`/`ending_before` to filter
+        #   balance data by time range
+        # - Set `include_credits_and_commits=true` for detailed commits and credits
+        #   breakdown per seat
+        # - Set `include_ledgers=true` for detailed transaction history per commit/credit
+        #   per seat
+        #
+        # @overload list_seat_balances(contract_id:, customer_id:, covering_date: nil, cursor: nil, effective_before: nil, include_credits_and_commits: nil, include_ledgers: nil, limit: nil, seat_ids: nil, starting_at: nil, subscription_ids: nil, request_options: {})
+        #
+        # @param contract_id [String] The contract ID to retrieve seat balances for
+        #
+        # @param customer_id [String] The customer ID to retrieve seat balances for
+        #
+        # @param covering_date [Time] Include only commits or credits with access that cover this specific date (canno
+        #
+        # @param cursor [String] Page token from a previous response to retrieve the next page
+        #
+        # @param effective_before [Time] Include only commits or credits with access effective on or before this date (ca
+        #
+        # @param include_credits_and_commits [Boolean] Include credits and commits in the response
+        #
+        # @param include_ledgers [Boolean] Include ledger entries for each commit and commit. `include_credits_and_commits`
+        #
+        # @param limit [Integer] Maximum number of seats to return. Range: 1-100. Default: 25.
+        #
+        # @param seat_ids [Array<String>] Optional filter to only include specific seats.
+        #
+        # @param starting_at [Time] Include only commits or credits with access effective on or after this date (can
+        #
+        # @param subscription_ids [Array<String>] Optional filter to only include seats from specific subscriptions. If subscripti
+        #
+        # @param request_options [MetronomeSDK::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [MetronomeSDK::Models::V1::ContractListSeatBalancesResponse]
+        #
+        # @see MetronomeSDK::Models::V1::ContractListSeatBalancesParams
+        def list_seat_balances(params)
+          parsed, options = MetronomeSDK::V1::ContractListSeatBalancesParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: "v1/contracts/seatBalances/list",
+            body: parsed,
+            model: MetronomeSDK::Models::V1::ContractListSeatBalancesResponse,
+            options: options
+          )
+        end
+
         # Some parameter documentations has been truncated, see
         # {MetronomeSDK::Models::V1::ContractRetrieveRateScheduleParams} for more details.
         #

data/lib/metronome_sdk/resources/v1/customers/invoices.rb

@@ -136,10 +136,12 @@ module MetronomeSDK
           # - Voided invoices are included in results by default unless filtered out by
           #   status
           #
-          # @overload list(customer_id:, credit_type_id: nil, ending_before: nil, limit: nil, next_page: nil, skip_zero_qty_line_items: nil, sort: nil, starting_on: nil, status: nil, request_options: {})
+          # @overload list(customer_id:, contract_id: nil, credit_type_id: nil, ending_before: nil, limit: nil, next_page: nil, skip_zero_qty_line_items: nil, sort: nil, starting_on: nil, status: nil, type: nil, request_options: {})
           #
           # @param customer_id [String] Path param
           #
+          # @param contract_id [String] Query param: Only return invoices for the specified contract
+          #
           # @param credit_type_id [String] Query param: Only return invoices for the specified credit type
           #
           # @param ending_before [Time] Query param: RFC 3339 timestamp (exclusive). Invoices will only be returned for
@@ -156,6 +158,8 @@ module MetronomeSDK
           #
           # @param status [String] Query param: Invoice status, e.g. DRAFT, FINALIZED, or VOID
           #
+          # @param type [Symbol, MetronomeSDK::Models::V1::Customers::InvoiceListParams::Type] Query param: Filter invoices by type. Defaults to returning all invoice types.
+          #
           # @param request_options [MetronomeSDK::RequestOptions, Hash{Symbol=>Object}, nil]
           #
           # @return [MetronomeSDK::Internal::CursorPage<MetronomeSDK::Models::V1::Customers::Invoice>]

data/lib/metronome_sdk/resources/v1/packages.rb

@@ -58,14 +58,12 @@ module MetronomeSDK
         #   provisioning with a package. Edited contracts will still be associated with
         #   the package used during provisioning.
         #
-        # @overload create(name:, aliases: nil, billing_anchor_date: nil, billing_provider: nil, commits: nil, contract_name: nil, credits: nil, delivery_method: nil, duration: nil, multiplier_override_prioritization: nil, net_payment_terms_days: nil, overrides: nil, prepaid_balance_threshold_configuration: nil, rate_card_alias: nil, rate_card_id: nil, recurring_commits: nil, recurring_credits: nil, scheduled_charges: nil, scheduled_charges_on_usage_invoices: nil, spend_threshold_configuration: nil, subscriptions: nil, uniqueness_key: nil, usage_statement_schedule: nil, request_options: {})
+        # @overload create(name:, aliases: nil, billing_provider: nil, commits: nil, contract_name: nil, credits: nil, delivery_method: nil, duration: nil, multiplier_override_prioritization: nil, net_payment_terms_days: nil, overrides: nil, prepaid_balance_threshold_configuration: nil, rate_card_alias: nil, rate_card_id: nil, recurring_commits: nil, recurring_credits: nil, scheduled_charges: nil, scheduled_charges_on_usage_invoices: nil, spend_threshold_configuration: nil, subscriptions: nil, uniqueness_key: nil, usage_statement_schedule: nil, request_options: {})
         #
         # @param name [String]
         #
         # @param aliases [Array<MetronomeSDK::Models::V1::PackageCreateParams::Alias>] Reference this alias when creating a contract. If the same alias is assigned to
         #
-        # @param billing_anchor_date [Symbol, MetronomeSDK::Models::V1::PackageCreateParams::BillingAnchorDate]
-        #
         # @param billing_provider [Symbol, MetronomeSDK::Models::V1::PackageCreateParams::BillingProvider]
         #
         # @param commits [Array<MetronomeSDK::Models::V1::PackageCreateParams::Commit>]

data/lib/metronome_sdk/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module MetronomeSDK
-  VERSION = "3.5.0"
+  VERSION = "3.6.0"
 end

data/lib/metronome_sdk.rb

@@ -121,6 +121,8 @@ require_relative "metronome_sdk/models/v1/contract_list_balances_params"
 require_relative "metronome_sdk/models/v1/contract_list_balances_response"
 require_relative "metronome_sdk/models/v1/contract_list_params"
 require_relative "metronome_sdk/models/v1/contract_list_response"
+require_relative "metronome_sdk/models/v1/contract_list_seat_balances_params"
+require_relative "metronome_sdk/models/v1/contract_list_seat_balances_response"
 require_relative "metronome_sdk/models/v1/contract_retrieve_params"
 require_relative "metronome_sdk/models/v1/contract_retrieve_rate_schedule_params"
 require_relative "metronome_sdk/models/v1/contract_retrieve_rate_schedule_response"