metronome-sdk 3.6.0 → 3.8.0

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

@@ -58,7 +58,7 @@ module MetronomeSDK
         #   threshold notification evaluations in real-time as usage events stream in,
         #   unlike competitors who rely on periodic polling or batch evaluation cycles
         #
-        # @overload create(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: {})
+        # @overload create(alert_type:, name:, threshold:, alert_specifiers: nil, 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: {})
         #
         # @param alert_type [Symbol, MetronomeSDK::Models::V1::AlertCreateParams::AlertType] Type of the threshold notification
         #
@@ -66,6 +66,8 @@ module MetronomeSDK
         #
         # @param threshold [Float] Threshold value of the notification policy. Depending upon the notification typ
         #
+        # @param alert_specifiers [Array<MetronomeSDK::Models::V1::AlertCreateParams::AlertSpecifier>] Can be used with only `low_remaining_contract_credit_and_commit_balance_reached`
+        #
         # @param billable_metric_id [String] For threshold notifications of type `usage_threshold_reached`, specifies which b
         #
         # @param credit_grant_type_filters [Array<String>] An array of strings, representing a way to filter the credit grant this threshol

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

@@ -59,6 +59,10 @@ module MetronomeSDK
             #
             # Add a new rate
             #
+            # This endpoint is heavily rate limited. For adding multiple rates, using the
+            # [addRates](https://docs.metronome.com/api-reference/rate-cards/add-rates)
+            # endpoint is strongly encouraged.
+            #
             # @overload add(entitled:, product_id:, rate_card_id:, rate_type:, starting_at:, billing_frequency: nil, commit_rate: nil, credit_type_id: nil, custom_rate: nil, ending_before: nil, is_prorated: nil, price: nil, pricing_group_values: nil, quantity: nil, tiers: nil, request_options: {})
             #
             # @param entitled [Boolean]

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

@@ -144,7 +144,7 @@ module MetronomeSDK
         #   `usage_filters` to route the correct usage to each contract.
         #   [Read more about usage filters](https://docs.metronome.com/manage-product-access/provision-customer/#create-a-usage-filter).
         #
-        # @overload create(customer_id:, starting_at:, billing_provider_configuration: nil, commits: nil, credits: nil, custom_fields: nil, discounts: nil, ending_before: nil, hierarchy_configuration: nil, multiplier_override_prioritization: nil, name: nil, net_payment_terms_days: nil, netsuite_sales_order_id: nil, overrides: nil, package_alias: nil, package_id: nil, prepaid_balance_threshold_configuration: nil, professional_services: nil, rate_card_alias: nil, rate_card_id: nil, recurring_commits: nil, recurring_credits: nil, reseller_royalties: nil, revenue_system_configuration: nil, salesforce_opportunity_id: nil, scheduled_charges: nil, scheduled_charges_on_usage_invoices: nil, spend_threshold_configuration: nil, subscriptions: nil, total_contract_value: nil, transition: nil, uniqueness_key: nil, usage_filter: nil, usage_statement_schedule: nil, request_options: {})
+        # @overload create(customer_id:, starting_at:, billing_provider_configuration: nil, commits: nil, credits: nil, custom_fields: nil, discounts: nil, ending_before: nil, hierarchy_configuration: nil, multiplier_override_prioritization: nil, name: nil, net_payment_terms_days: nil, netsuite_sales_order_id: nil, overrides: nil, package_alias: nil, package_id: nil, prepaid_balance_threshold_configuration: nil, professional_services: nil, rate_card_alias: nil, rate_card_id: nil, recurring_commits: nil, recurring_credits: nil, reseller_royalties: nil, revenue_system_configuration: nil, salesforce_opportunity_id: nil, scheduled_charges: nil, scheduled_charges_on_usage_invoices: nil, spend_threshold_configuration: nil, spend_trackers: nil, subscriptions: nil, total_contract_value: nil, transition: nil, uniqueness_key: nil, usage_filter: nil, usage_statement_schedule: nil, request_options: {})
         #
         # @param customer_id [String]
         #
@@ -202,6 +202,8 @@ module MetronomeSDK
         #
         # @param spend_threshold_configuration [MetronomeSDK::Models::SpendThresholdConfiguration]
         #
+        # @param spend_trackers [Array<MetronomeSDK::Models::V1::ContractCreateParams::SpendTracker>] Spend trackers to attach to this contract. Aliases must be unique within a contr
+        #
         # @param subscriptions [Array<MetronomeSDK::Models::V1::ContractCreateParams::Subscription>] Optional list of [subscriptions](https://docs.metronome.com/manage-product-acces
         #
         # @param total_contract_value [Float] This field's availability is dependent on your client's configuration.
@@ -566,6 +568,71 @@ module MetronomeSDK
           )
         end
 
+        # Some parameter documentations has been truncated, see
+        # {MetronomeSDK::Models::V1::ContractGetSubscriptionSeatsHistoryParams} for more
+        # details.
+        #
+        # Get the history of subscription seats schedule over time for a given
+        # `subscription_id`. This endpoint provides information about seat assignments and
+        # total quantities for different time periods, allowing you to track how seat
+        # assignments have changed over time.
+        #
+        # ### Use this endpoint to:
+        #
+        # - Track changes to seat assignments over time
+        # - Get seat schedule for a specific date using the `covering_date` parameter
+        # - Get seat schedule history with optional date range filtering using
+        #   `starting_at` and `ending_before`
+        #
+        # ### Key response fields:
+        #
+        # - data: array of seat schedule entries with time periods, quantity, and
+        #   assignments
+        # - next_page: cursor for pagination to retrieve additional results
+        #
+        # ### Usage guidelines:
+        #
+        # - Use `covering_date` to get the active seats for a specific point in time.
+        #   `covering_date` cannot be used with `starting_at` or `ending_before`.
+        # - Use `starting_at` and `ending_before` to filter results by time range.
+        #   `starting_at` and `ending_before` cannot be used with `covering_date`.
+        # - Maximum limit is 10 seat schedule entries per request
+        # - Results are ordered by `starting_at` timestamp
+        #
+        # @overload get_subscription_seats_history(contract_id:, customer_id:, subscription_id:, covering_date: nil, cursor: nil, ending_before: nil, limit: nil, starting_at: nil, request_options: {})
+        #
+        # @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}, nil]
+        #
+        # @return [MetronomeSDK::Models::V1::ContractGetSubscriptionSeatsHistoryResponse]
+        #
+        # @see MetronomeSDK::Models::V1::ContractGetSubscriptionSeatsHistoryParams
+        def get_subscription_seats_history(params)
+          parsed, options = MetronomeSDK::V1::ContractGetSubscriptionSeatsHistoryParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: "v1/contracts/getSubscriptionSeatsHistory",
+            body: parsed,
+            model: MetronomeSDK::Models::V1::ContractGetSubscriptionSeatsHistoryResponse,
+            options: options
+          )
+        end
+
         # Some parameter documentations has been truncated, see
         # {MetronomeSDK::Models::V1::ContractListBalancesParams} for more details.
         #
@@ -677,7 +744,7 @@ module MetronomeSDK
         # - 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: {})
+        # @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, skip_missing_seat_ids: nil, starting_at: nil, subscription_ids: nil, request_options: {})
         #
         # @param contract_id [String] The contract ID to retrieve seat balances for
         #
@@ -697,6 +764,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/resources/v1/customers/alerts.rb

@@ -47,11 +47,11 @@ module MetronomeSDK
           # - `null` - Notification has been archived
           # - `triggered_by`: Additional context about what caused the notification to
           #   trigger (when applicable)
+          # - `updated_at`: Timestamp of when the `customer_status` was last updated
           # - alert: Complete threshold notification configuration including:
           #   - Notification ID, name, and type
           #   - Current threshold values and credit type information
           #   - Notification status (enabled, disabled, or archived)
-          #   - Last update timestamp
           #   - Any applied filters (credit grant types, custom fields, group values)
           #
           # ### Usage guidelines:
@@ -69,12 +69,14 @@ module MetronomeSDK
           # - Error handling: Returns 404 if either the customer or alert_id doesn't exist
           #   or isn't accessible to your organization
           #
-          # @overload retrieve(alert_id:, customer_id:, group_values: nil, plans_or_contracts: nil, seat_filter: nil, request_options: {})
+          # @overload retrieve(alert_id:, customer_id:, alert_specifiers: nil, group_values: nil, plans_or_contracts: nil, seat_filter: nil, request_options: {})
           #
           # @param alert_id [String] The Metronome ID of the threshold notification
           #
           # @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

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

@@ -136,7 +136,7 @@ module MetronomeSDK
           # - Voided invoices are included in results by default unless filtered out by
           #   status
           #
-          # @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: {})
+          # @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, webhook_notification_id: nil, request_options: {})
           #
           # @param customer_id [String] Path param
           #
@@ -160,6 +160,8 @@ module MetronomeSDK
           #
           # @param type [Symbol, MetronomeSDK::Models::V1::Customers::InvoiceListParams::Type] Query param: Filter invoices by type. Defaults to returning all invoice types.
           #
+          # @param webhook_notification_id [String] Query param: Indicates that this API request was triggered by a webhook notifica
+          #
           # @param request_options [MetronomeSDK::RequestOptions, Hash{Symbol=>Object}, nil]
           #
           # @return [MetronomeSDK::Internal::CursorPage<MetronomeSDK::Models::V1::Customers::Invoice>]

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

@@ -30,8 +30,13 @@ module MetronomeSDK
         #
         # - Dashboard types: Choose from `invoices`, `usage`, or `commits_and_credits`
         # - Customization options:
-        #   - `dashboard_options`: Configure whether you want invoices to show zero usage
-        #     line items
+        #   - `dashboard_options`: Configure dashboard behavior. For the invoices
+        #     dashboard, supported keys include: `show_zero_usage_line_items`
+        #     ("true"/"false"), `hide_voided_invoices` ("true"/"false"), `contract_id`
+        #     (UUID, filters invoices by contract), `invoice_type` ("USAGE" or
+        #     "SCHEDULED", filters by invoice type), `invoice_status_filter` ("VOID",
+        #     "FINALIZED", "DRAFT", "FINALIZED_AND_DRAFT", or "ALL"), and
+        #     `billable_status_filter` ("BILLABLE", "UNBILLABLE", or "ALL")
         #   - `color_overrides`: Match your brand's color palette
         #   - `bm_group_key_overrides`: Customize how dimensions are displayed (for the
         #     usage embeddable dashboard)

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

@@ -58,7 +58,7 @@ module MetronomeSDK
         #   provisioning with a package. Edited contracts will still be associated with
         #   the package used during provisioning.
         #
-        # @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: {})
+        # @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, spend_trackers: nil, subscriptions: nil, uniqueness_key: nil, usage_statement_schedule: nil, request_options: {})
         #
         # @param name [String]
         #
@@ -98,6 +98,8 @@ module MetronomeSDK
         #
         # @param spend_threshold_configuration [MetronomeSDK::Models::SpendThresholdConfiguration]
         #
+        # @param spend_trackers [Array<MetronomeSDK::Models::V1::PackageCreateParams::SpendTracker>]
+        #
         # @param subscriptions [Array<MetronomeSDK::Models::V1::PackageCreateParams::Subscription>]
         #
         # @param uniqueness_key [String] Prevents the creation of duplicates. If a request to create a record is made wit
@@ -216,10 +218,9 @@ module MetronomeSDK
         #
         # ### **Usage guidelines:**
         #
-        # Use the **`starting_at`**, **`covering_date`**,
-        # and **`include_archived`** parameters to filter the list of returned contracts.
-        # For example, to list only currently active contracts,
-        # pass **`covering_date`** equal to the current time.
+        # Use the **`starting_at`**, **`covering_date`**, and **`include_archived`**
+        # parameters to filter the list of returned contracts. For example, to list only
+        # currently active contracts, pass **`covering_date`** equal to the current time.
         #
         # @overload list_contracts_on_package(package_id:, limit: nil, next_page: nil, covering_date: nil, include_archived: nil, starting_at: nil, request_options: {})
         #

data/lib/metronome_sdk/resources/v1.rb

@@ -80,9 +80,6 @@ module MetronomeSDK
       # @return [MetronomeSDK::Resources::V1::Packages]
       attr_reader :packages
 
-      # @return [MetronomeSDK::Resources::V1::Payments]
-      attr_reader :payments
-
       # Use these endpoints to configure a billing API key, a webhook secret, or invoice
       # finalization behavior.
       # @return [MetronomeSDK::Resources::V1::Settings]
@@ -107,7 +104,6 @@ module MetronomeSDK
         @invoices = MetronomeSDK::Resources::V1::Invoices.new(client: client)
         @contracts = MetronomeSDK::Resources::V1::Contracts.new(client: client)
         @packages = MetronomeSDK::Resources::V1::Packages.new(client: client)
-        @payments = MetronomeSDK::Resources::V1::Payments.new(client: client)
         @settings = MetronomeSDK::Resources::V1::Settings.new(client: client)
       end
     end

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

@@ -128,7 +128,7 @@ module MetronomeSDK
         # - Contract editing must be enabled to use this endpoint. Reach out to your
         #   Metronome representative to learn more.
         #
-        # @overload edit(contract_id:, customer_id:, add_billing_provider_configuration_update: nil, add_commits: nil, add_credits: nil, add_discounts: nil, add_overrides: nil, add_prepaid_balance_threshold_configuration: nil, add_professional_services: nil, add_recurring_commits: nil, add_recurring_credits: nil, add_reseller_royalties: nil, add_revenue_system_configuration_update: nil, add_scheduled_charges: nil, add_spend_threshold_configuration: nil, add_subscriptions: nil, allow_contract_ending_before_finalized_invoice: nil, archive_commits: nil, archive_credits: nil, archive_scheduled_charges: nil, remove_overrides: nil, uniqueness_key: nil, update_commits: nil, update_contract_end_date: nil, update_contract_name: nil, update_credits: nil, update_net_payment_terms_days: nil, update_prepaid_balance_threshold_configuration: nil, update_recurring_commits: nil, update_recurring_credits: nil, update_scheduled_charges: nil, update_spend_threshold_configuration: nil, update_subscriptions: nil, request_options: {})
+        # @overload edit(contract_id:, customer_id:, add_billing_provider_configuration_update: nil, add_commits: nil, add_credits: nil, add_discounts: nil, add_overrides: nil, add_prepaid_balance_threshold_configuration: nil, add_professional_services: nil, add_recurring_commits: nil, add_recurring_credits: nil, add_reseller_royalties: nil, add_revenue_system_configuration_update: nil, add_scheduled_charges: nil, add_spend_threshold_configuration: nil, add_spend_trackers: nil, add_subscriptions: nil, allow_contract_ending_before_finalized_invoice: nil, archive_commits: nil, archive_credits: nil, archive_scheduled_charges: nil, archive_spend_trackers: nil, remove_overrides: nil, uniqueness_key: nil, update_commits: nil, update_contract_end_date: nil, update_contract_name: nil, update_credits: nil, update_net_payment_terms_days: nil, update_prepaid_balance_threshold_configuration: nil, update_recurring_commits: nil, update_recurring_credits: nil, update_scheduled_charges: nil, update_spend_threshold_configuration: nil, update_subscriptions: nil, request_options: {})
         #
         # @param contract_id [String] ID of the contract being edited
         #
@@ -160,6 +160,8 @@ module MetronomeSDK
         #
         # @param add_spend_threshold_configuration [MetronomeSDK::Models::SpendThresholdConfigurationV2]
         #
+        # @param add_spend_trackers [Array<MetronomeSDK::Models::V2::ContractEditParams::AddSpendTracker>] Spend trackers to add to this contract. Aliases must be unique within a contract
+        #
         # @param add_subscriptions [Array<MetronomeSDK::Models::V2::ContractEditParams::AddSubscription>] Optional list of [subscriptions](https://docs.metronome.com/manage-product-acces
         #
         # @param allow_contract_ending_before_finalized_invoice [Boolean] If true, allows setting the contract end date earlier than the end_timestamp of
@@ -170,6 +172,8 @@ module MetronomeSDK
         #
         # @param archive_scheduled_charges [Array<MetronomeSDK::Models::V2::ContractEditParams::ArchiveScheduledCharge>] IDs of scheduled charges to archive
         #
+        # @param archive_spend_trackers [Array<String>] Aliases of spend trackers to archive.
+        #
         # @param remove_overrides [Array<MetronomeSDK::Models::V2::ContractEditParams::RemoveOverride>] IDs of overrides to remove
         #
         # @param uniqueness_key [String] Optional uniqueness key to prevent duplicate contract edits.

data/lib/metronome_sdk/version.rb

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

data/lib/metronome_sdk.rb

@@ -117,6 +117,8 @@ require_relative "metronome_sdk/models/v1/contract_create_params"
 require_relative "metronome_sdk/models/v1/contract_create_response"
 require_relative "metronome_sdk/models/v1/contract_get_net_balance_params"
 require_relative "metronome_sdk/models/v1/contract_get_net_balance_response"
+require_relative "metronome_sdk/models/v1/contract_get_subscription_seats_history_params"
+require_relative "metronome_sdk/models/v1/contract_get_subscription_seats_history_response"
 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"
@@ -271,13 +273,6 @@ require_relative "metronome_sdk/models/v1/package_list_params"
 require_relative "metronome_sdk/models/v1/package_list_response"
 require_relative "metronome_sdk/models/v1/package_retrieve_params"
 require_relative "metronome_sdk/models/v1/package_retrieve_response"
-require_relative "metronome_sdk/models/v1/payment"
-require_relative "metronome_sdk/models/v1/payment_attempt_params"
-require_relative "metronome_sdk/models/v1/payment_attempt_response"
-require_relative "metronome_sdk/models/v1/payment_cancel_params"
-require_relative "metronome_sdk/models/v1/payment_cancel_response"
-require_relative "metronome_sdk/models/v1/payment_list_params"
-require_relative "metronome_sdk/models/v1/payment_status"
 require_relative "metronome_sdk/models/v1/plan_detail"
 require_relative "metronome_sdk/models/v1/plan_get_details_params"
 require_relative "metronome_sdk/models/v1/plan_get_details_response"
@@ -343,7 +338,6 @@ require_relative "metronome_sdk/resources/v1/custom_fields"
 require_relative "metronome_sdk/resources/v1/dashboards"
 require_relative "metronome_sdk/resources/v1/invoices"
 require_relative "metronome_sdk/resources/v1/packages"
-require_relative "metronome_sdk/resources/v1/payments"
 require_relative "metronome_sdk/resources/v1/plans"
 require_relative "metronome_sdk/resources/v1/pricing_units"
 require_relative "metronome_sdk/resources/v1/services"

data/rbi/metronome_sdk/models/commit.rbi

@@ -91,6 +91,14 @@ module MetronomeSDK
       sig { params(contract: MetronomeSDK::Commit::Contract::OrHash).void }
       attr_writer :contract
 
+      # The actor who created this commit. Omitted for system-generated commits such as
+      # recurring commits, rollover commits, and threshold commits.
+      sig { returns(T.nilable(String)) }
+      attr_reader :created_by
+
+      sig { params(created_by: String).void }
+      attr_writer :created_by
+
       # Custom fields to be added eg. { "key1": "value1", "key2": "value2" }
       sig { returns(T.nilable(T::Hash[Symbol, String])) }
       attr_reader :custom_fields
@@ -237,6 +245,18 @@ module MetronomeSDK
       end
       attr_writer :specifiers
 
+      # Optional attributes controlling how this commit interacts with spend trackers.
+      sig { returns(T.nilable(MetronomeSDK::Commit::SpendTrackerAttributes)) }
+      attr_reader :spend_tracker_attributes
+
+      sig do
+        params(
+          spend_tracker_attributes:
+            MetronomeSDK::Commit::SpendTrackerAttributes::OrHash
+        ).void
+      end
+      attr_writer :spend_tracker_attributes
+
       # The subscription configuration for this commit, if it was generated from a
       # recurring commit with a subscription attached.
       sig { returns(T.nilable(MetronomeSDK::Commit::SubscriptionConfig)) }
@@ -273,6 +293,7 @@ module MetronomeSDK
           archived_at: Time,
           balance: Float,
           contract: MetronomeSDK::Commit::Contract::OrHash,
+          created_by: String,
           custom_fields: T::Hash[Symbol, String],
           description: String,
           hierarchy_configuration:
@@ -307,6 +328,8 @@ module MetronomeSDK
           rollover_fraction: Float,
           salesforce_opportunity_id: String,
           specifiers: T::Array[MetronomeSDK::CommitSpecifier::OrHash],
+          spend_tracker_attributes:
+            MetronomeSDK::Commit::SpendTrackerAttributes::OrHash,
           subscription_config: MetronomeSDK::Commit::SubscriptionConfig::OrHash,
           uniqueness_key: String
         ).returns(T.attached_class)
@@ -342,6 +365,9 @@ module MetronomeSDK
         # included in the balance, including future-dated manual ledger entries.
         balance: nil,
         contract: nil,
+        # The actor who created this commit. Omitted for system-generated commits such as
+        # recurring commits, rollover commits, and threshold commits.
+        created_by: nil,
         # Custom fields to be added eg. { "key1": "value1", "key2": "value2" }
         custom_fields: nil,
         description: nil,
@@ -372,6 +398,8 @@ module MetronomeSDK
         # or credit. A customer's usage needs to meet the condition of at least one of the
         # specifiers to contribute to a commit's or credit's drawdown.
         specifiers: nil,
+        # Optional attributes controlling how this commit interacts with spend trackers.
+        spend_tracker_attributes: nil,
         # The subscription configuration for this commit, if it was generated from a
         # recurring commit with a subscription attached.
         subscription_config: nil,
@@ -398,6 +426,7 @@ module MetronomeSDK
             archived_at: Time,
             balance: Float,
             contract: MetronomeSDK::Commit::Contract,
+            created_by: String,
             custom_fields: T::Hash[Symbol, String],
             description: String,
             hierarchy_configuration: MetronomeSDK::CommitHierarchyConfiguration,
@@ -413,6 +442,8 @@ module MetronomeSDK
             rollover_fraction: Float,
             salesforce_opportunity_id: String,
             specifiers: T::Array[MetronomeSDK::CommitSpecifier],
+            spend_tracker_attributes:
+              MetronomeSDK::Commit::SpendTrackerAttributes,
             subscription_config: MetronomeSDK::Commit::SubscriptionConfig,
             uniqueness_key: String
           }
@@ -1824,6 +1855,36 @@ module MetronomeSDK
         end
       end
 
+      class SpendTrackerAttributes < MetronomeSDK::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              MetronomeSDK::Commit::SpendTrackerAttributes,
+              MetronomeSDK::Internal::AnyHash
+            )
+          end
+
+        # If true, this commit is included in spend trackers with discounted set to
+        # DISCOUNTED_ONLY
+        sig { returns(T::Boolean) }
+        attr_accessor :counts_as_discounted
+
+        # Optional attributes controlling how this commit interacts with spend trackers.
+        sig do
+          params(counts_as_discounted: T::Boolean).returns(T.attached_class)
+        end
+        def self.new(
+          # If true, this commit is included in spend trackers with discounted set to
+          # DISCOUNTED_ONLY
+          counts_as_discounted:
+        )
+        end
+
+        sig { override.returns({ counts_as_discounted: T::Boolean }) }
+        def to_hash
+        end
+      end
+
       class SubscriptionConfig < MetronomeSDK::Internal::Type::BaseModel
         OrHash =
           T.type_alias do