metronome-sdk 3.7.0 → 3.8.0

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

@@ -578,6 +578,14 @@ module MetronomeSDK
               optional :proration,
                        enum: -> { MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit::Proration }
 
+              # @!attribute proration_rounding
+              #   Rounding configuration for prorated recurring commit amounts.
+              #
+              #   @return [MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit::ProrationRounding, nil]
+              optional :proration_rounding,
+                       -> { MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit::ProrationRounding },
+                       nil?: true
+
               # @!attribute recurrence_frequency
               #   The frequency at which the recurring commits will be created. If not provided: -
               #   The commits will be created on the usage invoice frequency. If provided: - The
@@ -611,7 +619,7 @@ module MetronomeSDK
               #   @return [MetronomeSDK::Models::RecurringCommitSubscriptionConfig, nil]
               optional :subscription_config, -> { MetronomeSDK::RecurringCommitSubscriptionConfig }
 
-              # @!method initialize(id:, access_amount:, commit_duration:, priority:, product:, rate_type:, starting_at:, applicable_product_ids: nil, applicable_product_tags: nil, contract: nil, description: nil, ending_before: nil, hierarchy_configuration: nil, invoice_amount: nil, name: nil, netsuite_sales_order_id: nil, proration: nil, recurrence_frequency: nil, rollover_fraction: nil, specifiers: nil, subscription_config: nil)
+              # @!method initialize(id:, access_amount:, commit_duration:, priority:, product:, rate_type:, starting_at:, applicable_product_ids: nil, applicable_product_tags: nil, contract: nil, description: nil, ending_before: nil, hierarchy_configuration: nil, invoice_amount: nil, name: nil, netsuite_sales_order_id: nil, proration: nil, proration_rounding: nil, recurrence_frequency: nil, rollover_fraction: nil, specifiers: nil, subscription_config: nil)
               #   Some parameter documentations has been truncated, see
               #   {MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit}
               #   for more details.
@@ -650,7 +658,9 @@ module MetronomeSDK
               #
               #   @param proration [Symbol, MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit::Proration] Determines whether the first and last commit will be prorated. If not provided,
               #
-              #   @param recurrence_frequency [Symbol, MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit::RecurrenceFrequency] The frequency at which the recurring commits will be created. If not provided:
+              #   @param proration_rounding [MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit::ProrationRounding, nil] Rounding configuration for prorated recurring commit amounts.
+              #
+              #   @param recurrence_frequency [Symbol, MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit::RecurrenceFrequency] The frequency at which the recurring commits will be created. If not provided: -
               #
               #   @param rollover_fraction [Float] Will be passed down to the individual commits. This controls how much of an indi
               #
@@ -795,6 +805,105 @@ module MetronomeSDK
                 #   @return [Array<Symbol>]
               end
 
+              # @see MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit#proration_rounding
+              class ProrationRounding < MetronomeSDK::Internal::Type::BaseModel
+                # @!attribute access
+                #
+                #   @return [MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit::ProrationRounding::Access, nil]
+                optional :access,
+                         -> { MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit::ProrationRounding::Access }
+
+                # @!attribute invoice
+                #
+                #   @return [MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit::ProrationRounding::Invoice, nil]
+                optional :invoice,
+                         -> { MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit::ProrationRounding::Invoice }
+
+                # @!method initialize(access: nil, invoice: nil)
+                #   Rounding configuration for prorated recurring commit amounts.
+                #
+                #   @param access [MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit::ProrationRounding::Access]
+                #   @param invoice [MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit::ProrationRounding::Invoice]
+
+                # @see MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit::ProrationRounding#access
+                class Access < MetronomeSDK::Internal::Type::BaseModel
+                  # @!attribute decimal_places
+                  #   Number of decimal places to round to. Applied directly to the stored monetary
+                  #   representation. Negative values round to powers of 10 (e.g., -2 rounds to
+                  #   nearest 100 in the stored unit. For USD, this means rounding to the nearest
+                  #   dollar).
+                  #
+                  #   @return [Float]
+                  required :decimal_places, Float
+
+                  # @!attribute rounding_method
+                  #
+                  #   @return [Symbol, MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit::ProrationRounding::Access::RoundingMethod]
+                  required :rounding_method,
+                           enum: -> { MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit::ProrationRounding::Access::RoundingMethod }
+
+                  # @!method initialize(decimal_places:, rounding_method:)
+                  #   Some parameter documentations has been truncated, see
+                  #   {MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit::ProrationRounding::Access}
+                  #   for more details.
+                  #
+                  #   @param decimal_places [Float] Number of decimal places to round to. Applied directly to the stored monetary re
+                  #
+                  #   @param rounding_method [Symbol, MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit::ProrationRounding::Access::RoundingMethod]
+
+                  # @see MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit::ProrationRounding::Access#rounding_method
+                  module RoundingMethod
+                    extend MetronomeSDK::Internal::Type::Enum
+
+                    HALF_UP = :HALF_UP
+                    FLOOR = :FLOOR
+                    CEILING = :CEILING
+
+                    # @!method self.values
+                    #   @return [Array<Symbol>]
+                  end
+                end
+
+                # @see MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit::ProrationRounding#invoice
+                class Invoice < MetronomeSDK::Internal::Type::BaseModel
+                  # @!attribute decimal_places
+                  #   Number of decimal places to round to. Applied directly to the stored monetary
+                  #   representation. Negative values round to powers of 10 (e.g., -2 rounds to
+                  #   nearest 100 in the stored unit. For USD, this means rounding to the nearest
+                  #   dollar).
+                  #
+                  #   @return [Float]
+                  required :decimal_places, Float
+
+                  # @!attribute rounding_method
+                  #
+                  #   @return [Symbol, MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit::ProrationRounding::Invoice::RoundingMethod]
+                  required :rounding_method,
+                           enum: -> { MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit::ProrationRounding::Invoice::RoundingMethod }
+
+                  # @!method initialize(decimal_places:, rounding_method:)
+                  #   Some parameter documentations has been truncated, see
+                  #   {MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit::ProrationRounding::Invoice}
+                  #   for more details.
+                  #
+                  #   @param decimal_places [Float] Number of decimal places to round to. Applied directly to the stored monetary re
+                  #
+                  #   @param rounding_method [Symbol, MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit::ProrationRounding::Invoice::RoundingMethod]
+
+                  # @see MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit::ProrationRounding::Invoice#rounding_method
+                  module RoundingMethod
+                    extend MetronomeSDK::Internal::Type::Enum
+
+                    HALF_UP = :HALF_UP
+                    FLOOR = :FLOOR
+                    CEILING = :CEILING
+
+                    # @!method self.values
+                    #   @return [Array<Symbol>]
+                  end
+                end
+              end
+
               # The frequency at which the recurring commits will be created. If not provided: -
               # The commits will be created on the usage invoice frequency. If provided: - The
               # period defined in the duration will correspond to this frequency. - Commits will
@@ -809,6 +918,7 @@ module MetronomeSDK
                 QUARTERLY = :QUARTERLY
                 ANNUAL = :ANNUAL
                 WEEKLY = :WEEKLY
+                DAILY = :DAILY
 
                 # @!method self.values
                 #   @return [Array<Symbol>]
@@ -916,6 +1026,14 @@ module MetronomeSDK
               optional :proration,
                        enum: -> { MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCredit::Proration }
 
+              # @!attribute proration_rounding
+              #   Rounding configuration for prorated recurring credit amounts.
+              #
+              #   @return [MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCredit::ProrationRounding, nil]
+              optional :proration_rounding,
+                       -> { MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCredit::ProrationRounding },
+                       nil?: true
+
               # @!attribute recurrence_frequency
               #   The frequency at which the recurring commits will be created. If not provided: -
               #   The commits will be created on the usage invoice frequency. If provided: - The
@@ -949,7 +1067,7 @@ module MetronomeSDK
               #   @return [MetronomeSDK::Models::RecurringCommitSubscriptionConfig, nil]
               optional :subscription_config, -> { MetronomeSDK::RecurringCommitSubscriptionConfig }
 
-              # @!method initialize(id:, access_amount:, commit_duration:, priority:, product:, rate_type:, starting_at:, applicable_product_ids: nil, applicable_product_tags: nil, contract: nil, description: nil, ending_before: nil, hierarchy_configuration: nil, name: nil, netsuite_sales_order_id: nil, proration: nil, recurrence_frequency: nil, rollover_fraction: nil, specifiers: nil, subscription_config: nil)
+              # @!method initialize(id:, access_amount:, commit_duration:, priority:, product:, rate_type:, starting_at:, applicable_product_ids: nil, applicable_product_tags: nil, contract: nil, description: nil, ending_before: nil, hierarchy_configuration: nil, name: nil, netsuite_sales_order_id: nil, proration: nil, proration_rounding: nil, recurrence_frequency: nil, rollover_fraction: nil, specifiers: nil, subscription_config: nil)
               #   Some parameter documentations has been truncated, see
               #   {MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCredit}
               #   for more details.
@@ -986,7 +1104,9 @@ module MetronomeSDK
               #
               #   @param proration [Symbol, MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCredit::Proration] Determines whether the first and last commit will be prorated. If not provided,
               #
-              #   @param recurrence_frequency [Symbol, MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCredit::RecurrenceFrequency] The frequency at which the recurring commits will be created. If not provided:
+              #   @param proration_rounding [MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCredit::ProrationRounding, nil] Rounding configuration for prorated recurring credit amounts.
+              #
+              #   @param recurrence_frequency [Symbol, MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCredit::RecurrenceFrequency] The frequency at which the recurring commits will be created. If not provided: -
               #
               #   @param rollover_fraction [Float] Will be passed down to the individual commits. This controls how much of an indi
               #
@@ -1106,6 +1226,59 @@ module MetronomeSDK
                 #   @return [Array<Symbol>]
               end
 
+              # @see MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCredit#proration_rounding
+              class ProrationRounding < MetronomeSDK::Internal::Type::BaseModel
+                # @!attribute access
+                #
+                #   @return [MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCredit::ProrationRounding::Access, nil]
+                optional :access,
+                         -> { MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCredit::ProrationRounding::Access }
+
+                # @!method initialize(access: nil)
+                #   Rounding configuration for prorated recurring credit amounts.
+                #
+                #   @param access [MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCredit::ProrationRounding::Access]
+
+                # @see MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCredit::ProrationRounding#access
+                class Access < MetronomeSDK::Internal::Type::BaseModel
+                  # @!attribute decimal_places
+                  #   Number of decimal places to round to. Applied directly to the stored monetary
+                  #   representation. Negative values round to powers of 10 (e.g., -2 rounds to
+                  #   nearest 100 in the stored unit. For USD, this means rounding to the nearest
+                  #   dollar).
+                  #
+                  #   @return [Float]
+                  required :decimal_places, Float
+
+                  # @!attribute rounding_method
+                  #
+                  #   @return [Symbol, MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCredit::ProrationRounding::Access::RoundingMethod]
+                  required :rounding_method,
+                           enum: -> { MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCredit::ProrationRounding::Access::RoundingMethod }
+
+                  # @!method initialize(decimal_places:, rounding_method:)
+                  #   Some parameter documentations has been truncated, see
+                  #   {MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCredit::ProrationRounding::Access}
+                  #   for more details.
+                  #
+                  #   @param decimal_places [Float] Number of decimal places to round to. Applied directly to the stored monetary re
+                  #
+                  #   @param rounding_method [Symbol, MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCredit::ProrationRounding::Access::RoundingMethod]
+
+                  # @see MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCredit::ProrationRounding::Access#rounding_method
+                  module RoundingMethod
+                    extend MetronomeSDK::Internal::Type::Enum
+
+                    HALF_UP = :HALF_UP
+                    FLOOR = :FLOOR
+                    CEILING = :CEILING
+
+                    # @!method self.values
+                    #   @return [Array<Symbol>]
+                  end
+                end
+              end
+
               # The frequency at which the recurring commits will be created. If not provided: -
               # The commits will be created on the usage invoice frequency. If provided: - The
               # period defined in the duration will correspond to this frequency. - Commits will
@@ -1120,6 +1293,7 @@ module MetronomeSDK
                 QUARTERLY = :QUARTERLY
                 ANNUAL = :ANNUAL
                 WEEKLY = :WEEKLY
+                DAILY = :DAILY
 
                 # @!method self.values
                 #   @return [Array<Symbol>]

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

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+module MetronomeSDK
+  module Models
+    module V1
+      # @see MetronomeSDK::Resources::V1::Contracts#get_subscription_seats_history
+      class ContractGetSubscriptionSeatsHistoryParams < MetronomeSDK::Internal::Type::BaseModel
+        extend MetronomeSDK::Internal::Type::RequestParameters::Converter
+        include MetronomeSDK::Internal::Type::RequestParameters
+
+        # @!attribute contract_id
+        #
+        #   @return [String]
+        required :contract_id, String
+
+        # @!attribute customer_id
+        #
+        #   @return [String]
+        required :customer_id, String
+
+        # @!attribute subscription_id
+        #
+        #   @return [String]
+        required :subscription_id, String
+
+        # @!attribute covering_date
+        #   Get the seats history segment for the covering date. Cannot be used with
+        #   `starting_at` or `ending_before`.
+        #
+        #   @return [Time, nil]
+        optional :covering_date, Time, nil?: true
+
+        # @!attribute cursor
+        #   Cursor for pagination. Use the value from the `next_page` field of the previous
+        #   response to retrieve the next page of results.
+        #
+        #   @return [String, nil]
+        optional :cursor, String, nil?: true
+
+        # @!attribute ending_before
+        #   Include seats history segments that are active at or before this timestamp. Use
+        #   with `starting_at` to get a specific time range. If not set, there's no upper
+        #   bound.
+        #
+        #   @return [Time, nil]
+        optional :ending_before, Time, nil?: true
+
+        # @!attribute limit
+        #   Maximum number of seat schedule entries to return. Defaults to 10. Required
+        #   range: 1 <= x <= 10.
+        #
+        #   @return [Integer, nil]
+        optional :limit, Integer, nil?: true
+
+        # @!attribute starting_at
+        #   Include seats history segments that are active at or after this timestamp. Use
+        #   with `ending_before` to get a specific time range. If not set, there's no lower
+        #   bound.
+        #
+        #   @return [Time, nil]
+        optional :starting_at, Time, nil?: true
+
+        # @!method initialize(contract_id:, customer_id:, subscription_id:, covering_date: nil, cursor: nil, ending_before: nil, limit: nil, starting_at: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {MetronomeSDK::Models::V1::ContractGetSubscriptionSeatsHistoryParams} for more
+        #   details.
+        #
+        #   @param contract_id [String]
+        #
+        #   @param customer_id [String]
+        #
+        #   @param subscription_id [String]
+        #
+        #   @param covering_date [Time, nil] Get the seats history segment for the covering date. Cannot be used with `starti
+        #
+        #   @param cursor [String, nil] Cursor for pagination. Use the value from the `next_page` field of the previous
+        #
+        #   @param ending_before [Time, nil] Include seats history segments that are active at or before this timestamp. Use
+        #
+        #   @param limit [Integer, nil] Maximum number of seat schedule entries to return. Defaults to 10. Required rang
+        #
+        #   @param starting_at [Time, nil] Include seats history segments that are active at or after this timestamp. Use w
+        #
+        #   @param request_options [MetronomeSDK::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

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

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+module MetronomeSDK
+  module Models
+    module V1
+      # @see MetronomeSDK::Resources::V1::Contracts#get_subscription_seats_history
+      class ContractGetSubscriptionSeatsHistoryResponse < MetronomeSDK::Internal::Type::BaseModel
+        # @!attribute data
+        #
+        #   @return [Array<MetronomeSDK::Models::V1::ContractGetSubscriptionSeatsHistoryResponse::Data>]
+        required :data,
+                 -> { MetronomeSDK::Internal::Type::ArrayOf[MetronomeSDK::Models::V1::ContractGetSubscriptionSeatsHistoryResponse::Data] }
+
+        # @!attribute next_page
+        #   Cursor for the next page of results
+        #
+        #   @return [String, nil]
+        required :next_page, String, nil?: true
+
+        # @!method initialize(data:, next_page:)
+        #   @param data [Array<MetronomeSDK::Models::V1::ContractGetSubscriptionSeatsHistoryResponse::Data>]
+        #
+        #   @param next_page [String, nil] Cursor for the next page of results
+
+        class Data < MetronomeSDK::Internal::Type::BaseModel
+          # @!attribute assigned_seat_ids
+          #   Array of seat IDs that are assigned in this period
+          #
+          #   @return [Array<String>]
+          required :assigned_seat_ids, MetronomeSDK::Internal::Type::ArrayOf[String]
+
+          # @!attribute ending_before
+          #   The end time of this seat schedule period (null if ongoing)
+          #
+          #   @return [Time, nil]
+          required :ending_before, Time, nil?: true
+
+          # @!attribute starting_at
+          #   The start time of this seat schedule period
+          #
+          #   @return [Time]
+          required :starting_at, Time
+
+          # @!attribute total_quantity
+          #   Total number of assigned and unassigned seats in this period
+          #
+          #   @return [Integer]
+          required :total_quantity, Integer
+
+          # @!method initialize(assigned_seat_ids:, ending_before:, starting_at:, total_quantity:)
+          #   @param assigned_seat_ids [Array<String>] Array of seat IDs that are assigned in this period
+          #
+          #   @param ending_before [Time, nil] The end time of this seat schedule period (null if ongoing)
+          #
+          #   @param starting_at [Time] The start time of this seat schedule period
+          #
+          #   @param total_quantity [Integer] Total number of assigned and unassigned seats in this period
+        end
+      end
+    end
+  end
+end

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

@@ -71,6 +71,13 @@ module MetronomeSDK
         #   @return [Array<String>, nil]
         optional :seat_ids, MetronomeSDK::Internal::Type::ArrayOf[String]
 
+        # @!attribute skip_missing_seat_ids
+        #   When true, any seat_ids not found in contract subscriptions will be silently
+        #   omitted from the response instead of returning a 400 error.
+        #
+        #   @return [Boolean, nil]
+        optional :skip_missing_seat_ids, MetronomeSDK::Internal::Type::Boolean
+
         # @!attribute starting_at
         #   Include only commits or credits with access effective on or after this date
         #   (cannot be used with covering_date).
@@ -86,7 +93,7 @@ module MetronomeSDK
         #   @return [Array<String>, nil]
         optional :subscription_ids, MetronomeSDK::Internal::Type::ArrayOf[String]
 
-        # @!method initialize(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: {})
+        # @!method initialize(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, skip_missing_seat_ids: nil, starting_at: nil, subscription_ids: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {MetronomeSDK::Models::V1::ContractListSeatBalancesParams} for more details.
         #
@@ -108,6 +115,8 @@ module MetronomeSDK
         #
         #   @param seat_ids [Array<String>] Optional filter to only include specific seats.
         #
+        #   @param skip_missing_seat_ids [Boolean] When true, any seat_ids not found in contract subscriptions will be silently omi
+        #
         #   @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

data/lib/metronome_sdk/models/v1/customers/alert_retrieve_params.rb

@@ -21,6 +21,14 @@ module MetronomeSDK
           #   @return [String]
           required :customer_id, String
 
+          # @!attribute alert_specifiers
+          #   Can be used with only `low_remaining_contract_credit_and_commit_balance_reached`
+          #   notifications. Used to filter the alert by the custom field key-value pair.
+          #
+          #   @return [Array<MetronomeSDK::Models::V1::Customers::AlertRetrieveParams::AlertSpecifier>, nil]
+          optional :alert_specifiers,
+                   -> { MetronomeSDK::Internal::Type::ArrayOf[MetronomeSDK::V1::Customers::AlertRetrieveParams::AlertSpecifier] }
+
           # @!attribute group_values
           #   Only present for `spend_threshold_reached` notifications. Retrieve the
           #   notification for a specific group key-value pair.
@@ -44,7 +52,7 @@ module MetronomeSDK
           #   @return [MetronomeSDK::Models::V1::Customers::AlertRetrieveParams::SeatFilter, nil]
           optional :seat_filter, -> { MetronomeSDK::V1::Customers::AlertRetrieveParams::SeatFilter }
 
-          # @!method initialize(alert_id:, customer_id:, group_values: nil, plans_or_contracts: nil, seat_filter: nil, request_options: {})
+          # @!method initialize(alert_id:, customer_id:, alert_specifiers: nil, group_values: nil, plans_or_contracts: nil, seat_filter: nil, request_options: {})
           #   Some parameter documentations has been truncated, see
           #   {MetronomeSDK::Models::V1::Customers::AlertRetrieveParams} for more details.
           #
@@ -52,6 +60,8 @@ module MetronomeSDK
           #
           #   @param customer_id [String] The Metronome ID of the customer
           #
+          #   @param alert_specifiers [Array<MetronomeSDK::Models::V1::Customers::AlertRetrieveParams::AlertSpecifier>] Can be used with only `low_remaining_contract_credit_and_commit_balance_reached`
+          #
           #   @param group_values [Array<MetronomeSDK::Models::V1::Customers::AlertRetrieveParams::GroupValue>] Only present for `spend_threshold_reached` notifications. Retrieve the notificat
           #
           #   @param plans_or_contracts [Symbol, MetronomeSDK::Models::V1::Customers::AlertRetrieveParams::PlansOrContracts] When parallel threshold notifications are enabled during migration, this flag de
@@ -60,6 +70,122 @@ module MetronomeSDK
           #
           #   @param request_options [MetronomeSDK::RequestOptions, Hash{Symbol=>Object}]
 
+          class AlertSpecifier < MetronomeSDK::Internal::Type::BaseModel
+            # @!attribute custom_field_filters
+            #   A list of custom field filters for notification types that support advanced
+            #   filtering
+            #
+            #   @return [Array<MetronomeSDK::Models::V1::Customers::AlertRetrieveParams::AlertSpecifier::CustomFieldFilter>]
+            required :custom_field_filters,
+                     -> { MetronomeSDK::Internal::Type::ArrayOf[MetronomeSDK::V1::Customers::AlertRetrieveParams::AlertSpecifier::CustomFieldFilter] }
+
+            # @!attribute exclude
+            #   If provided, the specifier will not apply to balances that matches the inclusion
+            #   criteria and any of the excluding values.
+            #
+            #   @return [Array<MetronomeSDK::Models::V1::Customers::AlertRetrieveParams::AlertSpecifier::Exclude>, nil]
+            optional :exclude,
+                     -> { MetronomeSDK::Internal::Type::ArrayOf[MetronomeSDK::V1::Customers::AlertRetrieveParams::AlertSpecifier::Exclude] }
+
+            # @!method initialize(custom_field_filters:, exclude: nil)
+            #   Some parameter documentations has been truncated, see
+            #   {MetronomeSDK::Models::V1::Customers::AlertRetrieveParams::AlertSpecifier} for
+            #   more details.
+            #
+            #   @param custom_field_filters [Array<MetronomeSDK::Models::V1::Customers::AlertRetrieveParams::AlertSpecifier::CustomFieldFilter>] A list of custom field filters for notification types that support advanced filt
+            #
+            #   @param exclude [Array<MetronomeSDK::Models::V1::Customers::AlertRetrieveParams::AlertSpecifier::Exclude>] If provided, the specifier will not apply to balances that matches the inclusion
+
+            class CustomFieldFilter < MetronomeSDK::Internal::Type::BaseModel
+              # @!attribute entity
+              #
+              #   @return [Symbol, MetronomeSDK::Models::V1::Customers::AlertRetrieveParams::AlertSpecifier::CustomFieldFilter::Entity]
+              required :entity,
+                       enum: -> { MetronomeSDK::V1::Customers::AlertRetrieveParams::AlertSpecifier::CustomFieldFilter::Entity }
+
+              # @!attribute key
+              #
+              #   @return [String]
+              required :key, String
+
+              # @!attribute value
+              #
+              #   @return [String]
+              required :value, String
+
+              # @!method initialize(entity:, key:, value:)
+              #   @param entity [Symbol, MetronomeSDK::Models::V1::Customers::AlertRetrieveParams::AlertSpecifier::CustomFieldFilter::Entity]
+              #   @param key [String]
+              #   @param value [String]
+
+              # @see MetronomeSDK::Models::V1::Customers::AlertRetrieveParams::AlertSpecifier::CustomFieldFilter#entity
+              module Entity
+                extend MetronomeSDK::Internal::Type::Enum
+
+                CONTRACT = :Contract
+                COMMIT = :Commit
+                CONTRACT_CREDIT = :ContractCredit
+                CONTRACT_CREDIT_OR_COMMIT = :ContractCreditOrCommit
+
+                # @!method self.values
+                #   @return [Array<Symbol>]
+              end
+            end
+
+            class Exclude < MetronomeSDK::Internal::Type::BaseModel
+              # @!attribute custom_field_filters
+              #   A list of custom field filters for notification types that support advanced
+              #   filtering
+              #
+              #   @return [Array<MetronomeSDK::Models::V1::Customers::AlertRetrieveParams::AlertSpecifier::Exclude::CustomFieldFilter>, nil]
+              optional :custom_field_filters,
+                       -> { MetronomeSDK::Internal::Type::ArrayOf[MetronomeSDK::V1::Customers::AlertRetrieveParams::AlertSpecifier::Exclude::CustomFieldFilter] }
+
+              # @!method initialize(custom_field_filters: nil)
+              #   Some parameter documentations has been truncated, see
+              #   {MetronomeSDK::Models::V1::Customers::AlertRetrieveParams::AlertSpecifier::Exclude}
+              #   for more details.
+              #
+              #   @param custom_field_filters [Array<MetronomeSDK::Models::V1::Customers::AlertRetrieveParams::AlertSpecifier::Exclude::CustomFieldFilter>] A list of custom field filters for notification types that support advanced filt
+
+              class CustomFieldFilter < MetronomeSDK::Internal::Type::BaseModel
+                # @!attribute entity
+                #
+                #   @return [Symbol, MetronomeSDK::Models::V1::Customers::AlertRetrieveParams::AlertSpecifier::Exclude::CustomFieldFilter::Entity]
+                required :entity,
+                         enum: -> { MetronomeSDK::V1::Customers::AlertRetrieveParams::AlertSpecifier::Exclude::CustomFieldFilter::Entity }
+
+                # @!attribute key
+                #
+                #   @return [String]
+                required :key, String
+
+                # @!attribute value
+                #
+                #   @return [String]
+                required :value, String
+
+                # @!method initialize(entity:, key:, value:)
+                #   @param entity [Symbol, MetronomeSDK::Models::V1::Customers::AlertRetrieveParams::AlertSpecifier::Exclude::CustomFieldFilter::Entity]
+                #   @param key [String]
+                #   @param value [String]
+
+                # @see MetronomeSDK::Models::V1::Customers::AlertRetrieveParams::AlertSpecifier::Exclude::CustomFieldFilter#entity
+                module Entity
+                  extend MetronomeSDK::Internal::Type::Enum
+
+                  CONTRACT = :Contract
+                  COMMIT = :Commit
+                  CONTRACT_CREDIT = :ContractCredit
+                  CONTRACT_CREDIT_OR_COMMIT = :ContractCreditOrCommit
+
+                  # @!method self.values
+                  #   @return [Array<Symbol>]
+                end
+              end
+            end
+          end
+
           class GroupValue < MetronomeSDK::Internal::Type::BaseModel
             # @!attribute key
             #