@metronome/sdk 0.3.0 → 1.0.0

package/resources/v2/contracts.d.ts

@@ -1,10 +1,26 @@
-import { APIResource } from "../../resource.js";
-import * as Core from "../../core.js";
+import { APIResource } from "../../core/resource.js";
 import * as Shared from "../shared.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { RequestOptions } from "../../internal/request-options.js";
 export declare class Contracts extends APIResource {
     /**
-     * Get a specific contract. New clients should use this endpoint rather than the v1
-     * endpoint.
+     * Gets the details for a specific contract, including contract term, rate card
+     * information, credits and commits, and more.
+     *
+     * ### Use this endpoint to:
+     *
+     * - Check the duration of a customer's current contract
+     * - Get details on contract terms, including access schedule amounts for
+     *   commitments and credits
+     * - Understand the state of a contract at a past time. As you can evolve the terms
+     *   of a contract over time through editing, use the `as_of_date` parameter to
+     *   view the full contract configuration as of that point in time.
+     *
+     * ### Usage guidelines:
+     *
+     * - Optionally, use the `include_balance` and `include_ledger` fields to include
+     *   balances and ledgers in the credit and commit responses. Using these fields
+     *   will cause the query to be slower.
      *
      * @example
      * ```ts
@@ -14,10 +30,23 @@ export declare class Contracts extends APIResource {
      * });
      * ```
      */
-    retrieve(body: ContractRetrieveParams, options?: Core.RequestOptions): Core.APIPromise<ContractRetrieveResponse>;
+    retrieve(body: ContractRetrieveParams, options?: RequestOptions): APIPromise<ContractRetrieveResponse>;
     /**
-     * List all contracts for a customer in chronological order. New clients should use
-     * this endpoint rather than the v1 endpoint.
+     * For a given customer, lists all of their contracts in chronological order.
+     *
+     * ### Use this endpoint to:
+     *
+     * - Check if a customer is provisioned with any contract, and at which tier
+     * - Check the duration and terms of a customer's current contract
+     * - Power a page in your end customer experience that shows the customer's history
+     *   of tiers (e.g. this customer started out on the Pro Plan, then downgraded to
+     *   the Starter plan).
+     *
+     * ### 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.
      *
      * @example
      * ```ts
@@ -26,9 +55,30 @@ export declare class Contracts extends APIResource {
      * });
      * ```
      */
-    list(body: ContractListParams, options?: Core.RequestOptions): Core.APIPromise<ContractListResponse>;
+    list(body: ContractListParams, options?: RequestOptions): APIPromise<ContractListResponse>;
     /**
-     * Edit a contract. Contract editing must be enabled to use this endpoint.
+     * The ability to edit a contract helps you react quickly to the needs of your
+     * customers and your business.
+     *
+     * ### Use this endpoint to:
+     *
+     * - Encode mid-term commitment and discount changes
+     * - Fix configuration mistakes and easily roll back packaging changes
+     *
+     * ### Key response fields:
+     *
+     * - The `id` of the edit
+     * - Complete edit details. For example, if you edited the contract to add new
+     *   overrides and credits, you will receive the IDs of those overrides and credits
+     *   in the response.
+     *
+     * ### Usage guidelines:
+     *
+     * - When you edit a contract, any draft invoices update immediately to reflect
+     *   that edit. Finalized invoices remain unchanged - you must void and regenerate
+     *   them in the UI or API to reflect the edit.
+     * - Contract editing must be enabled to use this endpoint. Reach out to your
+     *   Metronome representative to learn more.
      *
      * @example
      * ```ts
@@ -61,10 +111,24 @@ export declare class Contracts extends APIResource {
      * });
      * ```
      */
-    edit(body: ContractEditParams, options?: Core.RequestOptions): Core.APIPromise<ContractEditResponse>;
+    edit(body: ContractEditParams, options?: RequestOptions): APIPromise<ContractEditResponse>;
     /**
-     * Edit a customer or contract commit. Contract commits can only be edited using
-     * this endpoint if contract editing is enabled.
+     * Edit specific details for a contract-level or customer-level commit. Use this
+     * endpoint to modify individual commit access schedules, invoice schedules,
+     * applicable products, invoicing contracts, or other fields.
+     *
+     * ### Usage guidelines:
+     *
+     * - As with all edits in Metronome, draft invoices will reflect the edit
+     *   immediately, while finalized invoices are untouched unless voided and
+     *   regenerated.
+     * - If a commit's invoice schedule item is associated with a finalized invoice,
+     *   you cannot remove or update the invoice schedule item.
+     * - If a commit's invoice schedule item is associated with a voided invoice, you
+     *   cannot remove the invoice schedule item.
+     * - You cannot remove an commit access schedule segment that was applied to a
+     *   finalized invoice. You can void the invoice beforehand and then remove the
+     *   access schedule segment.
      *
      * @example
      * ```ts
@@ -82,10 +146,24 @@ export declare class Contracts extends APIResource {
      * });
      * ```
      */
-    editCommit(body: ContractEditCommitParams, options?: Core.RequestOptions): Core.APIPromise<ContractEditCommitResponse>;
+    editCommit(body: ContractEditCommitParams, options?: RequestOptions): APIPromise<ContractEditCommitResponse>;
     /**
-     * Edit a customer or contract credit. Contract credits can only be edited using
-     * this endpoint if contract editing is enabled.
+     * Edit details for a contract-level or customer-level credit.
+     *
+     * ### Use this endpoint to:
+     *
+     * - Extend the duration or the amount of an existing free credit like a trial
+     * - Modify individual credit access schedules, applicable products, priority, or
+     *   other fields.
+     *
+     * ### Usage guidelines:
+     *
+     * - As with all edits in Metronome, draft invoices will reflect the edit
+     *   immediately, while finalized invoices are untouched unless voided and
+     *   regenerated.
+     * - You cannot remove an access schedule segment that was applied to a finalized
+     *   invoice. You can void the invoice beforehand and then remove the access
+     *   schedule segment.
      *
      * @example
      * ```ts
@@ -103,2464 +181,39 @@ export declare class Contracts extends APIResource {
      * });
      * ```
      */
-    editCredit(body: ContractEditCreditParams, options?: Core.RequestOptions): Core.APIPromise<ContractEditCreditResponse>;
+    editCredit(body: ContractEditCreditParams, options?: RequestOptions): APIPromise<ContractEditCreditResponse>;
     /**
-     * Get the edit history of a specific contract. Contract editing must be enabled to
-     * use this endpoint.
+     * List all the edits made to a contract over time. In Metronome, you can edit a
+     * contract at any point after it's created to fix mistakes or reflect changes in
+     * terms. Metronome stores a full history of all edits that were ever made to a
+     * contract, whether through the UI, `editContract` endpoint, or other endpoints
+     * like `updateContractEndDate`.
      *
-     * @example
-     * ```ts
-     * const response = await client.v2.contracts.getEditHistory({
-     *   contract_id: 'd7abd0cd-4ae9-4db7-8676-e986a4ebd8dc',
-     *   customer_id: '13117714-3f05-48e5-a6e9-a66093f13b4d',
-     * });
-     * ```
-     */
-    getEditHistory(body: ContractGetEditHistoryParams, options?: Core.RequestOptions): Core.APIPromise<ContractGetEditHistoryResponse>;
-}
-export interface ContractRetrieveResponse {
-    data: ContractRetrieveResponse.Data;
-}
-export declare namespace ContractRetrieveResponse {
-    interface Data {
-        id: string;
-        commits: Array<Data.Commit>;
-        created_at: string;
-        created_by: string;
-        customer_id: string;
-        overrides: Array<Data.Override>;
-        scheduled_charges: Array<Shared.ScheduledCharge>;
-        starting_at: string;
-        transitions: Array<Data.Transition>;
-        usage_filter: Array<Data.UsageFilter>;
-        usage_statement_schedule: Data.UsageStatementSchedule;
-        archived_at?: string;
-        credits?: Array<Data.Credit>;
-        custom_fields?: {
-            [key: string]: string;
-        };
-        /**
-         * This field's availability is dependent on your client's configuration.
-         */
-        customer_billing_provider_configuration?: Data.CustomerBillingProviderConfiguration;
-        /**
-         * This field's availability is dependent on your client's configuration.
-         */
-        discounts?: Array<Shared.Discount>;
-        ending_before?: string;
-        /**
-         * Indicates whether there are more items than the limit for this endpoint. Use the
-         * respective list endpoints to get the full lists.
-         */
-        has_more?: Data.HasMore;
-        /**
-         * Either a **parent** configuration with a list of children or a **child**
-         * configuration with a single parent.
-         */
-        hierarchy_configuration?: Data.ParentHierarchyConfiguration | Data.ChildHierarchyConfiguration;
-        /**
-         * Defaults to LOWEST_MULTIPLIER, which applies the greatest discount to list
-         * prices automatically. EXPLICIT prioritization requires specifying priorities for
-         * each multiplier; the one with the lowest priority value will be prioritized
-         * first.
-         */
-        multiplier_override_prioritization?: 'LOWEST_MULTIPLIER' | 'EXPLICIT';
-        name?: string;
-        net_payment_terms_days?: number;
-        /**
-         * This field's availability is dependent on your client's configuration.
-         */
-        netsuite_sales_order_id?: string;
-        prepaid_balance_threshold_configuration?: Data.PrepaidBalanceThresholdConfiguration;
-        /**
-         * Priority of the contract.
-         */
-        priority?: number;
-        /**
-         * This field's availability is dependent on your client's configuration.
-         */
-        professional_services?: Array<Shared.ProService>;
-        rate_card_id?: string;
-        recurring_commits?: Array<Data.RecurringCommit>;
-        recurring_credits?: Array<Data.RecurringCredit>;
-        /**
-         * This field's availability is dependent on your client's configuration.
-         */
-        reseller_royalties?: Array<Data.ResellerRoyalty>;
-        /**
-         * This field's availability is dependent on your client's configuration.
-         */
-        salesforce_opportunity_id?: string;
-        /**
-         * Determines which scheduled and commit charges to consolidate onto the Contract's
-         * usage invoice. The charge's `timestamp` must match the usage invoice's
-         * `ending_before` date for consolidation to occur. This field cannot be modified
-         * after a Contract has been created. If this field is omitted, charges will appear
-         * on a separate invoice from usage charges.
-         */
-        scheduled_charges_on_usage_invoices?: 'ALL';
-        spend_threshold_configuration?: Data.SpendThresholdConfiguration;
-        /**
-         * List of subscriptions on the contract.
-         */
-        subscriptions?: Array<Data.Subscription>;
-        total_contract_value?: number;
-        /**
-         * Prevents the creation of duplicates. If a request to create a record is made
-         * with a previously used uniqueness key, a new record will not be created and the
-         * request will fail with a 409 error.
-         */
-        uniqueness_key?: string;
-    }
-    namespace Data {
-        interface Commit {
-            id: string;
-            product: Commit.Product;
-            type: 'PREPAID' | 'POSTPAID';
-            /**
-             * The schedule that the customer will gain access to the credits purposed with
-             * this commit.
-             */
-            access_schedule?: Shared.ScheduleDuration;
-            applicable_contract_ids?: Array<string>;
-            applicable_product_ids?: Array<string>;
-            applicable_product_tags?: Array<string>;
-            archived_at?: string;
-            /**
-             * The current balance of the credit or commit. This balance reflects the amount of
-             * credit or commit that the customer has access to use at this moment - thus,
-             * expired and upcoming credit or commit segments contribute 0 to the balance. The
-             * balance will match the sum of all ledger entries with the exception of the case
-             * where the sum of negative manual ledger entries exceeds the positive amount
-             * remaining on the credit or commit - in that case, the balance will be 0. All
-             * manual ledger entries associated with active credit or commit segments are
-             * included in the balance, including future-dated manual ledger entries.
-             */
-            balance?: number;
-            contract?: Commit.Contract;
-            custom_fields?: {
-                [key: string]: string;
-            };
-            description?: string;
-            /**
-             * Optional configuration for commit hierarchy access control
-             */
-            hierarchy_configuration?: Commit.HierarchyConfiguration;
-            /**
-             * The contract that this commit will be billed on.
-             */
-            invoice_contract?: Commit.InvoiceContract;
-            /**
-             * The schedule that the customer will be invoiced for this commit.
-             */
-            invoice_schedule?: Shared.SchedulePointInTime;
-            /**
-             * A list of ordered events that impact the balance of a commit. For example, an
-             * invoice deduction or a rollover.
-             */
-            ledger?: Array<Commit.PrepaidCommitSegmentStartLedgerEntry | Commit.PrepaidCommitAutomatedInvoiceDeductionLedgerEntry | Commit.PrepaidCommitRolloverLedgerEntry | Commit.PrepaidCommitExpirationLedgerEntry | Commit.PrepaidCommitCanceledLedgerEntry | Commit.PrepaidCommitCreditedLedgerEntry | Commit.PrepaidCommitSeatBasedAdjustmentLedgerEntry | Commit.PostpaidCommitInitialBalanceLedgerEntry | Commit.PostpaidCommitAutomatedInvoiceDeductionLedgerEntry | Commit.PostpaidCommitRolloverLedgerEntry | Commit.PostpaidCommitTrueupLedgerEntry | Commit.PrepaidCommitManualLedgerEntry | Commit.PostpaidCommitManualLedgerEntry | Commit.PostpaidCommitExpirationLedgerEntry>;
-            name?: string;
-            /**
-             * This field's availability is dependent on your client's configuration.
-             */
-            netsuite_sales_order_id?: string;
-            /**
-             * If multiple credits or commits are applicable, the one with the lower priority
-             * will apply first.
-             */
-            priority?: number;
-            rate_type?: 'COMMIT_RATE' | 'LIST_RATE';
-            rolled_over_from?: Commit.RolledOverFrom;
-            rollover_fraction?: number;
-            /**
-             * This field's availability is dependent on your client's configuration.
-             */
-            salesforce_opportunity_id?: string;
-            /**
-             * List of filters that determine what kind of customer usage draws down a commit
-             * 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?: Array<Commit.Specifier>;
-        }
-        namespace Commit {
-            interface Product {
-                id: string;
-                name: string;
-            }
-            interface Contract {
-                id: string;
-            }
-            /**
-             * Optional configuration for commit hierarchy access control
-             */
-            interface HierarchyConfiguration {
-                child_access: HierarchyConfiguration.CommitHierarchyChildAccessAll | HierarchyConfiguration.CommitHierarchyChildAccessNone | HierarchyConfiguration.CommitHierarchyChildAccessContractIDs;
-            }
-            namespace HierarchyConfiguration {
-                interface CommitHierarchyChildAccessAll {
-                    type: 'ALL';
-                }
-                interface CommitHierarchyChildAccessNone {
-                    type: 'NONE';
-                }
-                interface CommitHierarchyChildAccessContractIDs {
-                    contract_ids: Array<string>;
-                    type: 'CONTRACT_IDS';
-                }
-            }
-            /**
-             * The contract that this commit will be billed on.
-             */
-            interface InvoiceContract {
-                id: string;
-            }
-            interface PrepaidCommitSegmentStartLedgerEntry {
-                amount: number;
-                segment_id: string;
-                timestamp: string;
-                type: 'PREPAID_COMMIT_SEGMENT_START';
-            }
-            interface PrepaidCommitAutomatedInvoiceDeductionLedgerEntry {
-                amount: number;
-                invoice_id: string;
-                segment_id: string;
-                timestamp: string;
-                type: 'PREPAID_COMMIT_AUTOMATED_INVOICE_DEDUCTION';
-                contract_id?: string;
-            }
-            interface PrepaidCommitRolloverLedgerEntry {
-                amount: number;
-                new_contract_id: string;
-                segment_id: string;
-                timestamp: string;
-                type: 'PREPAID_COMMIT_ROLLOVER';
-            }
-            interface PrepaidCommitExpirationLedgerEntry {
-                amount: number;
-                segment_id: string;
-                timestamp: string;
-                type: 'PREPAID_COMMIT_EXPIRATION';
-            }
-            interface PrepaidCommitCanceledLedgerEntry {
-                amount: number;
-                invoice_id: string;
-                segment_id: string;
-                timestamp: string;
-                type: 'PREPAID_COMMIT_CANCELED';
-                contract_id?: string;
-            }
-            interface PrepaidCommitCreditedLedgerEntry {
-                amount: number;
-                invoice_id: string;
-                segment_id: string;
-                timestamp: string;
-                type: 'PREPAID_COMMIT_CREDITED';
-                contract_id?: string;
-            }
-            interface PrepaidCommitSeatBasedAdjustmentLedgerEntry {
-                amount: number;
-                segment_id: string;
-                timestamp: string;
-                type: 'PREPAID_COMMIT_SEAT_BASED_ADJUSTMENT';
-            }
-            interface PostpaidCommitInitialBalanceLedgerEntry {
-                amount: number;
-                timestamp: string;
-                type: 'POSTPAID_COMMIT_INITIAL_BALANCE';
-            }
-            interface PostpaidCommitAutomatedInvoiceDeductionLedgerEntry {
-                amount: number;
-                invoice_id: string;
-                segment_id: string;
-                timestamp: string;
-                type: 'POSTPAID_COMMIT_AUTOMATED_INVOICE_DEDUCTION';
-                contract_id?: string;
-            }
-            interface PostpaidCommitRolloverLedgerEntry {
-                amount: number;
-                new_contract_id: string;
-                segment_id: string;
-                timestamp: string;
-                type: 'POSTPAID_COMMIT_ROLLOVER';
-            }
-            interface PostpaidCommitTrueupLedgerEntry {
-                amount: number;
-                invoice_id: string;
-                timestamp: string;
-                type: 'POSTPAID_COMMIT_TRUEUP';
-                contract_id?: string;
-            }
-            interface PrepaidCommitManualLedgerEntry {
-                amount: number;
-                reason: string;
-                timestamp: string;
-                type: 'PREPAID_COMMIT_MANUAL';
-            }
-            interface PostpaidCommitManualLedgerEntry {
-                amount: number;
-                reason: string;
-                timestamp: string;
-                type: 'POSTPAID_COMMIT_MANUAL';
-            }
-            interface PostpaidCommitExpirationLedgerEntry {
-                amount: number;
-                timestamp: string;
-                type: 'POSTPAID_COMMIT_EXPIRATION';
-            }
-            interface RolledOverFrom {
-                commit_id: string;
-                contract_id: string;
-            }
-            interface Specifier {
-                presentation_group_values?: {
-                    [key: string]: string;
-                };
-                pricing_group_values?: {
-                    [key: string]: string;
-                };
-                /**
-                 * If provided, the specifier will only apply to the product with the specified ID.
-                 */
-                product_id?: string;
-                /**
-                 * If provided, the specifier will only apply to products with all the specified
-                 * tags.
-                 */
-                product_tags?: Array<string>;
-            }
-        }
-        interface Override {
-            id: string;
-            starting_at: string;
-            applicable_product_tags?: Array<string>;
-            ending_before?: string;
-            entitled?: boolean;
-            is_commit_specific?: boolean;
-            multiplier?: number;
-            override_specifiers?: Array<Override.OverrideSpecifier>;
-            override_tiers?: Array<Override.OverrideTier>;
-            overwrite_rate?: Override.OverwriteRate;
-            priority?: number;
-            product?: Override.Product;
-            target?: 'COMMIT_RATE' | 'LIST_RATE';
-            type?: 'OVERWRITE' | 'MULTIPLIER' | 'TIERED';
-        }
-        namespace Override {
-            interface OverrideSpecifier {
-                billing_frequency?: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'WEEKLY';
-                commit_ids?: Array<string>;
-                presentation_group_values?: {
-                    [key: string]: string | null;
-                };
-                pricing_group_values?: {
-                    [key: string]: string;
-                };
-                product_id?: string;
-                product_tags?: Array<string>;
-                recurring_commit_ids?: Array<string>;
-                recurring_credit_ids?: Array<string>;
-            }
-            interface OverrideTier {
-                multiplier: number;
-                size?: number;
-            }
-            interface OverwriteRate {
-                rate_type: 'FLAT' | 'PERCENTAGE' | 'SUBSCRIPTION' | 'TIERED' | 'CUSTOM';
-                credit_type?: Shared.CreditTypeData;
-                /**
-                 * Only set for CUSTOM rate_type. This field is interpreted by custom rate
-                 * processors.
-                 */
-                custom_rate?: {
-                    [key: string]: unknown;
-                };
-                /**
-                 * Default proration configuration. Only valid for SUBSCRIPTION rate_type. Must be
-                 * set to true.
-                 */
-                is_prorated?: boolean;
-                /**
-                 * Default price. For FLAT rate_type, this must be >=0. For PERCENTAGE rate_type,
-                 * this is a decimal fraction, e.g. use 0.1 for 10%; this must be >=0 and <=1.
-                 */
-                price?: number;
-                /**
-                 * Default quantity. For SUBSCRIPTION rate_type, this must be >=0.
-                 */
-                quantity?: number;
-                /**
-                 * Only set for TIERED rate_type.
-                 */
-                tiers?: Array<Shared.Tier>;
-            }
-            interface Product {
-                id: string;
-                name: string;
-            }
-        }
-        interface Transition {
-            from_contract_id: string;
-            to_contract_id: string;
-            type: 'SUPERSEDE' | 'RENEWAL';
-        }
-        interface UsageFilter {
-            group_key: string;
-            group_values: Array<string>;
-            /**
-             * This will match contract starting_at value if usage filter is active from the
-             * beginning of the contract.
-             */
-            starting_at: string;
-            /**
-             * This will match contract ending_before value if usage filter is active until the
-             * end of the contract. It will be undefined if the contract is open-ended.
-             */
-            ending_before?: string;
-        }
-        interface UsageStatementSchedule {
-            /**
-             * Contract usage statements follow a selected cadence based on this date.
-             */
-            billing_anchor_date: string;
-            frequency: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'WEEKLY';
-        }
-        interface Credit {
-            id: string;
-            product: Credit.Product;
-            type: 'CREDIT';
-            /**
-             * The schedule that the customer will gain access to the credits.
-             */
-            access_schedule?: Shared.ScheduleDuration;
-            applicable_contract_ids?: Array<string>;
-            applicable_product_ids?: Array<string>;
-            applicable_product_tags?: Array<string>;
-            /**
-             * The current balance of the credit or commit. This balance reflects the amount of
-             * credit or commit that the customer has access to use at this moment - thus,
-             * expired and upcoming credit or commit segments contribute 0 to the balance. The
-             * balance will match the sum of all ledger entries with the exception of the case
-             * where the sum of negative manual ledger entries exceeds the positive amount
-             * remaining on the credit or commit - in that case, the balance will be 0. All
-             * manual ledger entries associated with active credit or commit segments are
-             * included in the balance, including future-dated manual ledger entries.
-             */
-            balance?: number;
-            contract?: Credit.Contract;
-            custom_fields?: {
-                [key: string]: string;
-            };
-            description?: string;
-            /**
-             * Optional configuration for credit hierarchy access control
-             */
-            hierarchy_configuration?: Credit.HierarchyConfiguration;
-            /**
-             * A list of ordered events that impact the balance of a credit. For example, an
-             * invoice deduction or an expiration.
-             */
-            ledger?: Array<Credit.CreditSegmentStartLedgerEntry | Credit.CreditAutomatedInvoiceDeductionLedgerEntry | Credit.CreditExpirationLedgerEntry | Credit.CreditCanceledLedgerEntry | Credit.CreditCreditedLedgerEntry | Credit.CreditManualLedgerEntry | Credit.CreditSeatBasedAdjustmentLedgerEntry>;
-            name?: string;
-            /**
-             * This field's availability is dependent on your client's configuration.
-             */
-            netsuite_sales_order_id?: string;
-            /**
-             * If multiple credits or commits are applicable, the one with the lower priority
-             * will apply first.
-             */
-            priority?: number;
-            /**
-             * This field's availability is dependent on your client's configuration.
-             */
-            salesforce_opportunity_id?: string;
-            /**
-             * List of filters that determine what kind of customer usage draws down a commit
-             * 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?: Array<Credit.Specifier>;
-        }
-        namespace Credit {
-            interface Product {
-                id: string;
-                name: string;
-            }
-            interface Contract {
-                id: string;
-            }
-            /**
-             * Optional configuration for credit hierarchy access control
-             */
-            interface HierarchyConfiguration {
-                child_access: HierarchyConfiguration.CommitHierarchyChildAccessAll | HierarchyConfiguration.CommitHierarchyChildAccessNone | HierarchyConfiguration.CommitHierarchyChildAccessContractIDs;
-            }
-            namespace HierarchyConfiguration {
-                interface CommitHierarchyChildAccessAll {
-                    type: 'ALL';
-                }
-                interface CommitHierarchyChildAccessNone {
-                    type: 'NONE';
-                }
-                interface CommitHierarchyChildAccessContractIDs {
-                    contract_ids: Array<string>;
-                    type: 'CONTRACT_IDS';
-                }
-            }
-            interface CreditSegmentStartLedgerEntry {
-                amount: number;
-                segment_id: string;
-                timestamp: string;
-                type: 'CREDIT_SEGMENT_START';
-            }
-            interface CreditAutomatedInvoiceDeductionLedgerEntry {
-                amount: number;
-                invoice_id: string;
-                segment_id: string;
-                timestamp: string;
-                type: 'CREDIT_AUTOMATED_INVOICE_DEDUCTION';
-                contract_id?: string;
-            }
-            interface CreditExpirationLedgerEntry {
-                amount: number;
-                segment_id: string;
-                timestamp: string;
-                type: 'CREDIT_EXPIRATION';
-            }
-            interface CreditCanceledLedgerEntry {
-                amount: number;
-                invoice_id: string;
-                segment_id: string;
-                timestamp: string;
-                type: 'CREDIT_CANCELED';
-                contract_id?: string;
-            }
-            interface CreditCreditedLedgerEntry {
-                amount: number;
-                invoice_id: string;
-                segment_id: string;
-                timestamp: string;
-                type: 'CREDIT_CREDITED';
-                contract_id?: string;
-            }
-            interface CreditManualLedgerEntry {
-                amount: number;
-                reason: string;
-                timestamp: string;
-                type: 'CREDIT_MANUAL';
-            }
-            interface CreditSeatBasedAdjustmentLedgerEntry {
-                amount: number;
-                segment_id: string;
-                timestamp: string;
-                type: 'CREDIT_SEAT_BASED_ADJUSTMENT';
-            }
-            interface Specifier {
-                presentation_group_values?: {
-                    [key: string]: string;
-                };
-                pricing_group_values?: {
-                    [key: string]: string;
-                };
-                /**
-                 * If provided, the specifier will only apply to the product with the specified ID.
-                 */
-                product_id?: string;
-                /**
-                 * If provided, the specifier will only apply to products with all the specified
-                 * tags.
-                 */
-                product_tags?: Array<string>;
-            }
-        }
-        /**
-         * This field's availability is dependent on your client's configuration.
-         */
-        interface CustomerBillingProviderConfiguration {
-            /**
-             * ID of Customer's billing provider configuration.
-             */
-            id: string;
-            billing_provider: 'aws_marketplace' | 'stripe' | 'netsuite' | 'custom' | 'azure_marketplace' | 'quickbooks_online' | 'workday' | 'gcp_marketplace';
-            delivery_method: 'direct_to_billing_provider' | 'aws_sqs' | 'tackle' | 'aws_sns';
-        }
-        /**
-         * Indicates whether there are more items than the limit for this endpoint. Use the
-         * respective list endpoints to get the full lists.
-         */
-        interface HasMore {
-            /**
-             * Whether there are more commits on this contract than the limit for this
-             * endpoint. Use the /contracts/customerCommits/list endpoint to get the full list
-             * of commits.
-             */
-            commits: boolean;
-            /**
-             * Whether there are more credits on this contract than the limit for this
-             * endpoint. Use the /contracts/customerCredits/list endpoint to get the full list
-             * of credits.
-             */
-            credits: boolean;
-        }
-        interface ParentHierarchyConfiguration {
-            /**
-             * List of contracts that belong to this parent.
-             */
-            children: Array<ParentHierarchyConfiguration.Child>;
-        }
-        namespace ParentHierarchyConfiguration {
-            interface Child {
-                contract_id: string;
-                customer_id: string;
-            }
-        }
-        interface ChildHierarchyConfiguration {
-            /**
-             * The single parent contract/customer for this child.
-             */
-            parent: ChildHierarchyConfiguration.Parent;
-        }
-        namespace ChildHierarchyConfiguration {
-            /**
-             * The single parent contract/customer for this child.
-             */
-            interface Parent {
-                contract_id: string;
-                customer_id: string;
-            }
-        }
-        interface PrepaidBalanceThresholdConfiguration {
-            commit: PrepaidBalanceThresholdConfiguration.Commit;
-            /**
-             * When set to false, the contract will not be evaluated against the
-             * threshold_amount. Toggling to true will result an immediate evaluation,
-             * regardless of prior state.
-             */
-            is_enabled: boolean;
-            payment_gate_config: PrepaidBalanceThresholdConfiguration.PaymentGateConfig;
-            /**
-             * Specify the amount the balance should be recharged to.
-             */
-            recharge_to_amount: number;
-            /**
-             * Specify the threshold amount for the contract. Each time the contract's balance
-             * lowers to this amount, a threshold charge will be initiated.
-             */
-            threshold_amount: number;
-            /**
-             * If provided, the threshold, recharge-to amount, and the resulting threshold
-             * commit amount will be in terms of this credit type instead of the fiat currency.
-             */
-            custom_credit_type_id?: string;
-        }
-        namespace PrepaidBalanceThresholdConfiguration {
-            interface Commit {
-                /**
-                 * The commit product that will be used to generate the line item for commit
-                 * payment.
-                 */
-                product_id: string;
-                /**
-                 * Which products the threshold commit applies to. If applicable_product_ids,
-                 * applicable_product_tags or specifiers are not provided, the commit applies to
-                 * all products.
-                 */
-                applicable_product_ids?: Array<string>;
-                /**
-                 * Which tags the threshold commit applies to. If applicable_product_ids,
-                 * applicable_product_tags or specifiers are not provided, the commit applies to
-                 * all products.
-                 */
-                applicable_product_tags?: Array<string>;
-                description?: string;
-                /**
-                 * Specify the name of the line item for the threshold charge. If left blank, it
-                 * will default to the commit product name.
-                 */
-                name?: string;
-                /**
-                 * List of filters that determine what kind of customer usage draws down a commit
-                 * 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. This field cannot
-                 * be used together with `applicable_product_ids` or `applicable_product_tags`.
-                 * Instead, to target usage by product or product tag, pass those values in the
-                 * body of `specifiers`.
-                 */
-                specifiers?: Array<Commit.Specifier>;
-            }
-            namespace Commit {
-                interface Specifier {
-                    presentation_group_values?: {
-                        [key: string]: string;
-                    };
-                    pricing_group_values?: {
-                        [key: string]: string;
-                    };
-                    /**
-                     * If provided, the specifier will only apply to the product with the specified ID.
-                     */
-                    product_id?: string;
-                    /**
-                     * If provided, the specifier will only apply to products with all the specified
-                     * tags.
-                     */
-                    product_tags?: Array<string>;
-                }
-            }
-            interface PaymentGateConfig {
-                /**
-                 * Gate access to the commit balance based on successful collection of payment.
-                 * Select STRIPE for Metronome to facilitate payment via Stripe. Select EXTERNAL to
-                 * facilitate payment using your own payment integration. Select NONE if you do not
-                 * wish to payment gate the commit balance.
-                 */
-                payment_gate_type: 'NONE' | 'STRIPE' | 'EXTERNAL';
-                /**
-                 * Only applicable if using PRECALCULATED as your tax type.
-                 */
-                precalculated_tax_config?: PaymentGateConfig.PrecalculatedTaxConfig;
-                /**
-                 * Only applicable if using STRIPE as your payment gateway type.
-                 */
-                stripe_config?: PaymentGateConfig.StripeConfig;
-                /**
-                 * Stripe tax is only supported for Stripe payment gateway. Select NONE if you do
-                 * not wish Metronome to calculate tax on your behalf. Leaving this field blank
-                 * will default to NONE.
-                 */
-                tax_type?: 'NONE' | 'STRIPE' | 'ANROK' | 'PRECALCULATED';
-            }
-            namespace PaymentGateConfig {
-                /**
-                 * Only applicable if using PRECALCULATED as your tax type.
-                 */
-                interface PrecalculatedTaxConfig {
-                    /**
-                     * Amount of tax to be applied. This should be in the same currency and
-                     * denomination as the commit's invoice schedule
-                     */
-                    tax_amount: number;
-                    /**
-                     * Name of the tax to be applied. This may be used in an invoice line item
-                     * description.
-                     */
-                    tax_name?: string;
-                }
-                /**
-                 * Only applicable if using STRIPE as your payment gateway type.
-                 */
-                interface StripeConfig {
-                    /**
-                     * If left blank, will default to INVOICE
-                     */
-                    payment_type: 'INVOICE' | 'PAYMENT_INTENT';
-                    /**
-                     * Metadata to be added to the Stripe invoice. Only applicable if using INVOICE as
-                     * your payment type.
-                     */
-                    invoice_metadata?: {
-                        [key: string]: string;
-                    };
-                }
-            }
-        }
-        interface RecurringCommit {
-            id: string;
-            /**
-             * The amount of commit to grant.
-             */
-            access_amount: RecurringCommit.AccessAmount;
-            /**
-             * The amount of time the created commits will be valid for
-             */
-            commit_duration: RecurringCommit.CommitDuration;
-            /**
-             * Will be passed down to the individual commits
-             */
-            priority: number;
-            product: RecurringCommit.Product;
-            /**
-             * Whether the created commits will use the commit rate or list rate
-             */
-            rate_type: 'COMMIT_RATE' | 'LIST_RATE';
-            /**
-             * Determines the start time for the first commit
-             */
-            starting_at: string;
-            /**
-             * Will be passed down to the individual commits
-             */
-            applicable_product_ids?: Array<string>;
-            /**
-             * Will be passed down to the individual commits
-             */
-            applicable_product_tags?: Array<string>;
-            contract?: RecurringCommit.Contract;
-            /**
-             * Will be passed down to the individual commits
-             */
-            description?: string;
-            /**
-             * Determines when the contract will stop creating recurring commits. Optional
-             */
-            ending_before?: string;
-            /**
-             * Optional configuration for recurring credit hierarchy access control
-             */
-            hierarchy_configuration?: RecurringCommit.HierarchyConfiguration;
-            /**
-             * The amount the customer should be billed for the commit. Not required.
-             */
-            invoice_amount?: RecurringCommit.InvoiceAmount;
-            /**
-             * Displayed on invoices. Will be passed through to the individual commits
-             */
-            name?: string;
-            /**
-             * Will be passed down to the individual commits
-             */
-            netsuite_sales_order_id?: string;
-            /**
-             * Determines whether the first and last commit will be prorated. If not provided,
-             * the default is FIRST_AND_LAST (i.e. prorate both the first and last commits).
-             */
-            proration?: 'NONE' | 'FIRST' | 'LAST' | 'FIRST_AND_LAST';
-            /**
-             * 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
-             * be created aligned with the recurring commit's starting_at rather than the usage
-             * invoice dates.
-             */
-            recurrence_frequency?: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'WEEKLY';
-            /**
-             * Will be passed down to the individual commits. This controls how much of an
-             * individual unexpired commit will roll over upon contract transition. Must be
-             * between 0 and 1.
-             */
-            rollover_fraction?: number;
-            /**
-             * List of filters that determine what kind of customer usage draws down a commit
-             * 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?: Array<RecurringCommit.Specifier>;
-            /**
-             * Attach a subscription to the recurring commit/credit.
-             */
-            subscription_config?: RecurringCommit.SubscriptionConfig;
-        }
-        namespace RecurringCommit {
-            /**
-             * The amount of commit to grant.
-             */
-            interface AccessAmount {
-                credit_type_id: string;
-                unit_price: number;
-                quantity?: number;
-            }
-            /**
-             * The amount of time the created commits will be valid for
-             */
-            interface CommitDuration {
-                value: number;
-                unit?: 'PERIODS';
-            }
-            interface Product {
-                id: string;
-                name: string;
-            }
-            interface Contract {
-                id: string;
-            }
-            /**
-             * Optional configuration for recurring credit hierarchy access control
-             */
-            interface HierarchyConfiguration {
-                child_access: HierarchyConfiguration.CommitHierarchyChildAccessAll | HierarchyConfiguration.CommitHierarchyChildAccessNone | HierarchyConfiguration.CommitHierarchyChildAccessContractIDs;
-            }
-            namespace HierarchyConfiguration {
-                interface CommitHierarchyChildAccessAll {
-                    type: 'ALL';
-                }
-                interface CommitHierarchyChildAccessNone {
-                    type: 'NONE';
-                }
-                interface CommitHierarchyChildAccessContractIDs {
-                    contract_ids: Array<string>;
-                    type: 'CONTRACT_IDS';
-                }
-            }
-            /**
-             * The amount the customer should be billed for the commit. Not required.
-             */
-            interface InvoiceAmount {
-                credit_type_id: string;
-                quantity: number;
-                unit_price: number;
-            }
-            interface Specifier {
-                presentation_group_values?: {
-                    [key: string]: string;
-                };
-                pricing_group_values?: {
-                    [key: string]: string;
-                };
-                /**
-                 * If provided, the specifier will only apply to the product with the specified ID.
-                 */
-                product_id?: string;
-                /**
-                 * If provided, the specifier will only apply to products with all the specified
-                 * tags.
-                 */
-                product_tags?: Array<string>;
-            }
-            /**
-             * Attach a subscription to the recurring commit/credit.
-             */
-            interface SubscriptionConfig {
-                allocation: 'INDIVIDUAL' | 'POOLED';
-                apply_seat_increase_config: SubscriptionConfig.ApplySeatIncreaseConfig;
-                subscription_id: string;
-            }
-            namespace SubscriptionConfig {
-                interface ApplySeatIncreaseConfig {
-                    /**
-                     * Indicates whether a mid-period seat increase should be prorated.
-                     */
-                    is_prorated: boolean;
-                }
-            }
-        }
-        interface RecurringCredit {
-            id: string;
-            /**
-             * The amount of commit to grant.
-             */
-            access_amount: RecurringCredit.AccessAmount;
-            /**
-             * The amount of time the created commits will be valid for
-             */
-            commit_duration: RecurringCredit.CommitDuration;
-            /**
-             * Will be passed down to the individual commits
-             */
-            priority: number;
-            product: RecurringCredit.Product;
-            /**
-             * Whether the created commits will use the commit rate or list rate
-             */
-            rate_type: 'COMMIT_RATE' | 'LIST_RATE';
-            /**
-             * Determines the start time for the first commit
-             */
-            starting_at: string;
-            /**
-             * Will be passed down to the individual commits
-             */
-            applicable_product_ids?: Array<string>;
-            /**
-             * Will be passed down to the individual commits
-             */
-            applicable_product_tags?: Array<string>;
-            contract?: RecurringCredit.Contract;
-            /**
-             * Will be passed down to the individual commits
-             */
-            description?: string;
-            /**
-             * Determines when the contract will stop creating recurring commits. Optional
-             */
-            ending_before?: string;
-            /**
-             * Optional configuration for recurring credit hierarchy access control
-             */
-            hierarchy_configuration?: RecurringCredit.HierarchyConfiguration;
-            /**
-             * Displayed on invoices. Will be passed through to the individual commits
-             */
-            name?: string;
-            /**
-             * Will be passed down to the individual commits
-             */
-            netsuite_sales_order_id?: string;
-            /**
-             * Determines whether the first and last commit will be prorated. If not provided,
-             * the default is FIRST_AND_LAST (i.e. prorate both the first and last commits).
-             */
-            proration?: 'NONE' | 'FIRST' | 'LAST' | 'FIRST_AND_LAST';
-            /**
-             * 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
-             * be created aligned with the recurring commit's starting_at rather than the usage
-             * invoice dates.
-             */
-            recurrence_frequency?: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'WEEKLY';
-            /**
-             * Will be passed down to the individual commits. This controls how much of an
-             * individual unexpired commit will roll over upon contract transition. Must be
-             * between 0 and 1.
-             */
-            rollover_fraction?: number;
-            /**
-             * List of filters that determine what kind of customer usage draws down a commit
-             * 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?: Array<RecurringCredit.Specifier>;
-            /**
-             * Attach a subscription to the recurring commit/credit.
-             */
-            subscription_config?: RecurringCredit.SubscriptionConfig;
-        }
-        namespace RecurringCredit {
-            /**
-             * The amount of commit to grant.
-             */
-            interface AccessAmount {
-                credit_type_id: string;
-                unit_price: number;
-                quantity?: number;
-            }
-            /**
-             * The amount of time the created commits will be valid for
-             */
-            interface CommitDuration {
-                value: number;
-                unit?: 'PERIODS';
-            }
-            interface Product {
-                id: string;
-                name: string;
-            }
-            interface Contract {
-                id: string;
-            }
-            /**
-             * Optional configuration for recurring credit hierarchy access control
-             */
-            interface HierarchyConfiguration {
-                child_access: HierarchyConfiguration.CommitHierarchyChildAccessAll | HierarchyConfiguration.CommitHierarchyChildAccessNone | HierarchyConfiguration.CommitHierarchyChildAccessContractIDs;
-            }
-            namespace HierarchyConfiguration {
-                interface CommitHierarchyChildAccessAll {
-                    type: 'ALL';
-                }
-                interface CommitHierarchyChildAccessNone {
-                    type: 'NONE';
-                }
-                interface CommitHierarchyChildAccessContractIDs {
-                    contract_ids: Array<string>;
-                    type: 'CONTRACT_IDS';
-                }
-            }
-            interface Specifier {
-                presentation_group_values?: {
-                    [key: string]: string;
-                };
-                pricing_group_values?: {
-                    [key: string]: string;
-                };
-                /**
-                 * If provided, the specifier will only apply to the product with the specified ID.
-                 */
-                product_id?: string;
-                /**
-                 * If provided, the specifier will only apply to products with all the specified
-                 * tags.
-                 */
-                product_tags?: Array<string>;
-            }
-            /**
-             * Attach a subscription to the recurring commit/credit.
-             */
-            interface SubscriptionConfig {
-                allocation: 'INDIVIDUAL' | 'POOLED';
-                apply_seat_increase_config: SubscriptionConfig.ApplySeatIncreaseConfig;
-                subscription_id: string;
-            }
-            namespace SubscriptionConfig {
-                interface ApplySeatIncreaseConfig {
-                    /**
-                     * Indicates whether a mid-period seat increase should be prorated.
-                     */
-                    is_prorated: boolean;
-                }
-            }
-        }
-        interface ResellerRoyalty {
-            reseller_type: 'AWS' | 'AWS_PRO_SERVICE' | 'GCP' | 'GCP_PRO_SERVICE';
-            segments: Array<ResellerRoyalty.Segment>;
-        }
-        namespace ResellerRoyalty {
-            interface Segment {
-                fraction: number;
-                netsuite_reseller_id: string;
-                reseller_type: 'AWS' | 'AWS_PRO_SERVICE' | 'GCP' | 'GCP_PRO_SERVICE';
-                starting_at: string;
-                applicable_product_ids?: Array<string>;
-                applicable_product_tags?: Array<string>;
-                aws_account_number?: string;
-                aws_offer_id?: string;
-                aws_payer_reference_id?: string;
-                ending_before?: string;
-                gcp_account_id?: string;
-                gcp_offer_id?: string;
-                reseller_contract_value?: number;
-            }
-        }
-        interface SpendThresholdConfiguration {
-            commit: SpendThresholdConfiguration.Commit;
-            /**
-             * When set to false, the contract will not be evaluated against the
-             * threshold_amount. Toggling to true will result an immediate evaluation,
-             * regardless of prior state.
-             */
-            is_enabled: boolean;
-            payment_gate_config: SpendThresholdConfiguration.PaymentGateConfig;
-            /**
-             * Specify the threshold amount for the contract. Each time the contract's usage
-             * hits this amount, a threshold charge will be initiated.
-             */
-            threshold_amount: number;
-        }
-        namespace SpendThresholdConfiguration {
-            interface Commit {
-                /**
-                 * The commit product that will be used to generate the line item for commit
-                 * payment.
-                 */
-                product_id: string;
-                description?: string;
-                /**
-                 * Specify the name of the line item for the threshold charge. If left blank, it
-                 * will default to the commit product name.
-                 */
-                name?: string;
-            }
-            interface PaymentGateConfig {
-                /**
-                 * Gate access to the commit balance based on successful collection of payment.
-                 * Select STRIPE for Metronome to facilitate payment via Stripe. Select EXTERNAL to
-                 * facilitate payment using your own payment integration. Select NONE if you do not
-                 * wish to payment gate the commit balance.
-                 */
-                payment_gate_type: 'NONE' | 'STRIPE' | 'EXTERNAL';
-                /**
-                 * Only applicable if using PRECALCULATED as your tax type.
-                 */
-                precalculated_tax_config?: PaymentGateConfig.PrecalculatedTaxConfig;
-                /**
-                 * Only applicable if using STRIPE as your payment gateway type.
-                 */
-                stripe_config?: PaymentGateConfig.StripeConfig;
-                /**
-                 * Stripe tax is only supported for Stripe payment gateway. Select NONE if you do
-                 * not wish Metronome to calculate tax on your behalf. Leaving this field blank
-                 * will default to NONE.
-                 */
-                tax_type?: 'NONE' | 'STRIPE' | 'ANROK' | 'PRECALCULATED';
-            }
-            namespace PaymentGateConfig {
-                /**
-                 * Only applicable if using PRECALCULATED as your tax type.
-                 */
-                interface PrecalculatedTaxConfig {
-                    /**
-                     * Amount of tax to be applied. This should be in the same currency and
-                     * denomination as the commit's invoice schedule
-                     */
-                    tax_amount: number;
-                    /**
-                     * Name of the tax to be applied. This may be used in an invoice line item
-                     * description.
-                     */
-                    tax_name?: string;
-                }
-                /**
-                 * Only applicable if using STRIPE as your payment gateway type.
-                 */
-                interface StripeConfig {
-                    /**
-                     * If left blank, will default to INVOICE
-                     */
-                    payment_type: 'INVOICE' | 'PAYMENT_INTENT';
-                    /**
-                     * Metadata to be added to the Stripe invoice. Only applicable if using INVOICE as
-                     * your payment type.
-                     */
-                    invoice_metadata?: {
-                        [key: string]: string;
-                    };
-                }
-            }
-        }
-        interface Subscription {
-            collection_schedule: 'ADVANCE' | 'ARREARS';
-            proration: Subscription.Proration;
-            /**
-             * List of quantity schedule items for the subscription. Only includes the current
-             * quantity and future quantity changes.
-             */
-            quantity_schedule: Array<Subscription.QuantitySchedule>;
-            starting_at: string;
-            subscription_rate: Subscription.SubscriptionRate;
-            id?: string;
-            custom_fields?: {
-                [key: string]: string;
-            };
-            description?: string;
-            ending_before?: string;
-            fiat_credit_type_id?: string;
-            name?: string;
-        }
-        namespace Subscription {
-            interface Proration {
-                invoice_behavior: 'BILL_IMMEDIATELY' | 'BILL_ON_NEXT_COLLECTION_DATE';
-                is_prorated: boolean;
-            }
-            interface QuantitySchedule {
-                quantity: number;
-                starting_at: string;
-                ending_before?: string;
-            }
-            interface SubscriptionRate {
-                billing_frequency: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'WEEKLY';
-                product: SubscriptionRate.Product;
-            }
-            namespace SubscriptionRate {
-                interface Product {
-                    id: string;
-                    name: string;
-                }
-            }
-        }
-    }
-}
-export interface ContractListResponse {
-    data: Array<ContractListResponse.Data>;
-}
-export declare namespace ContractListResponse {
-    interface Data {
-        id: string;
-        commits: Array<Data.Commit>;
-        created_at: string;
-        created_by: string;
-        customer_id: string;
-        overrides: Array<Data.Override>;
-        scheduled_charges: Array<Shared.ScheduledCharge>;
-        starting_at: string;
-        transitions: Array<Data.Transition>;
-        usage_filter: Array<Data.UsageFilter>;
-        usage_statement_schedule: Data.UsageStatementSchedule;
-        archived_at?: string;
-        credits?: Array<Data.Credit>;
-        custom_fields?: {
-            [key: string]: string;
-        };
-        /**
-         * This field's availability is dependent on your client's configuration.
-         */
-        customer_billing_provider_configuration?: Data.CustomerBillingProviderConfiguration;
-        /**
-         * This field's availability is dependent on your client's configuration.
-         */
-        discounts?: Array<Shared.Discount>;
-        ending_before?: string;
-        /**
-         * Indicates whether there are more items than the limit for this endpoint. Use the
-         * respective list endpoints to get the full lists.
-         */
-        has_more?: Data.HasMore;
-        /**
-         * Either a **parent** configuration with a list of children or a **child**
-         * configuration with a single parent.
-         */
-        hierarchy_configuration?: Data.ParentHierarchyConfiguration | Data.ChildHierarchyConfiguration;
-        /**
-         * Defaults to LOWEST_MULTIPLIER, which applies the greatest discount to list
-         * prices automatically. EXPLICIT prioritization requires specifying priorities for
-         * each multiplier; the one with the lowest priority value will be prioritized
-         * first.
-         */
-        multiplier_override_prioritization?: 'LOWEST_MULTIPLIER' | 'EXPLICIT';
-        name?: string;
-        net_payment_terms_days?: number;
-        /**
-         * This field's availability is dependent on your client's configuration.
-         */
-        netsuite_sales_order_id?: string;
-        prepaid_balance_threshold_configuration?: Data.PrepaidBalanceThresholdConfiguration;
-        /**
-         * Priority of the contract.
-         */
-        priority?: number;
-        /**
-         * This field's availability is dependent on your client's configuration.
-         */
-        professional_services?: Array<Shared.ProService>;
-        rate_card_id?: string;
-        recurring_commits?: Array<Data.RecurringCommit>;
-        recurring_credits?: Array<Data.RecurringCredit>;
-        /**
-         * This field's availability is dependent on your client's configuration.
-         */
-        reseller_royalties?: Array<Data.ResellerRoyalty>;
-        /**
-         * This field's availability is dependent on your client's configuration.
-         */
-        salesforce_opportunity_id?: string;
-        /**
-         * Determines which scheduled and commit charges to consolidate onto the Contract's
-         * usage invoice. The charge's `timestamp` must match the usage invoice's
-         * `ending_before` date for consolidation to occur. This field cannot be modified
-         * after a Contract has been created. If this field is omitted, charges will appear
-         * on a separate invoice from usage charges.
-         */
-        scheduled_charges_on_usage_invoices?: 'ALL';
-        spend_threshold_configuration?: Data.SpendThresholdConfiguration;
-        /**
-         * List of subscriptions on the contract.
-         */
-        subscriptions?: Array<Data.Subscription>;
-        total_contract_value?: number;
-        /**
-         * Prevents the creation of duplicates. If a request to create a record is made
-         * with a previously used uniqueness key, a new record will not be created and the
-         * request will fail with a 409 error.
-         */
-        uniqueness_key?: string;
-    }
-    namespace Data {
-        interface Commit {
-            id: string;
-            product: Commit.Product;
-            type: 'PREPAID' | 'POSTPAID';
-            /**
-             * The schedule that the customer will gain access to the credits purposed with
-             * this commit.
-             */
-            access_schedule?: Shared.ScheduleDuration;
-            applicable_contract_ids?: Array<string>;
-            applicable_product_ids?: Array<string>;
-            applicable_product_tags?: Array<string>;
-            archived_at?: string;
-            /**
-             * The current balance of the credit or commit. This balance reflects the amount of
-             * credit or commit that the customer has access to use at this moment - thus,
-             * expired and upcoming credit or commit segments contribute 0 to the balance. The
-             * balance will match the sum of all ledger entries with the exception of the case
-             * where the sum of negative manual ledger entries exceeds the positive amount
-             * remaining on the credit or commit - in that case, the balance will be 0. All
-             * manual ledger entries associated with active credit or commit segments are
-             * included in the balance, including future-dated manual ledger entries.
-             */
-            balance?: number;
-            contract?: Commit.Contract;
-            custom_fields?: {
-                [key: string]: string;
-            };
-            description?: string;
-            /**
-             * Optional configuration for commit hierarchy access control
-             */
-            hierarchy_configuration?: Commit.HierarchyConfiguration;
-            /**
-             * The contract that this commit will be billed on.
-             */
-            invoice_contract?: Commit.InvoiceContract;
-            /**
-             * The schedule that the customer will be invoiced for this commit.
-             */
-            invoice_schedule?: Shared.SchedulePointInTime;
-            /**
-             * A list of ordered events that impact the balance of a commit. For example, an
-             * invoice deduction or a rollover.
-             */
-            ledger?: Array<Commit.PrepaidCommitSegmentStartLedgerEntry | Commit.PrepaidCommitAutomatedInvoiceDeductionLedgerEntry | Commit.PrepaidCommitRolloverLedgerEntry | Commit.PrepaidCommitExpirationLedgerEntry | Commit.PrepaidCommitCanceledLedgerEntry | Commit.PrepaidCommitCreditedLedgerEntry | Commit.PrepaidCommitSeatBasedAdjustmentLedgerEntry | Commit.PostpaidCommitInitialBalanceLedgerEntry | Commit.PostpaidCommitAutomatedInvoiceDeductionLedgerEntry | Commit.PostpaidCommitRolloverLedgerEntry | Commit.PostpaidCommitTrueupLedgerEntry | Commit.PrepaidCommitManualLedgerEntry | Commit.PostpaidCommitManualLedgerEntry | Commit.PostpaidCommitExpirationLedgerEntry>;
-            name?: string;
-            /**
-             * This field's availability is dependent on your client's configuration.
-             */
-            netsuite_sales_order_id?: string;
-            /**
-             * If multiple credits or commits are applicable, the one with the lower priority
-             * will apply first.
-             */
-            priority?: number;
-            rate_type?: 'COMMIT_RATE' | 'LIST_RATE';
-            rolled_over_from?: Commit.RolledOverFrom;
-            rollover_fraction?: number;
-            /**
-             * This field's availability is dependent on your client's configuration.
-             */
-            salesforce_opportunity_id?: string;
-            /**
-             * List of filters that determine what kind of customer usage draws down a commit
-             * 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?: Array<Commit.Specifier>;
-        }
-        namespace Commit {
-            interface Product {
-                id: string;
-                name: string;
-            }
-            interface Contract {
-                id: string;
-            }
-            /**
-             * Optional configuration for commit hierarchy access control
-             */
-            interface HierarchyConfiguration {
-                child_access: HierarchyConfiguration.CommitHierarchyChildAccessAll | HierarchyConfiguration.CommitHierarchyChildAccessNone | HierarchyConfiguration.CommitHierarchyChildAccessContractIDs;
-            }
-            namespace HierarchyConfiguration {
-                interface CommitHierarchyChildAccessAll {
-                    type: 'ALL';
-                }
-                interface CommitHierarchyChildAccessNone {
-                    type: 'NONE';
-                }
-                interface CommitHierarchyChildAccessContractIDs {
-                    contract_ids: Array<string>;
-                    type: 'CONTRACT_IDS';
-                }
-            }
-            /**
-             * The contract that this commit will be billed on.
-             */
-            interface InvoiceContract {
-                id: string;
-            }
-            interface PrepaidCommitSegmentStartLedgerEntry {
-                amount: number;
-                segment_id: string;
-                timestamp: string;
-                type: 'PREPAID_COMMIT_SEGMENT_START';
-            }
-            interface PrepaidCommitAutomatedInvoiceDeductionLedgerEntry {
-                amount: number;
-                invoice_id: string;
-                segment_id: string;
-                timestamp: string;
-                type: 'PREPAID_COMMIT_AUTOMATED_INVOICE_DEDUCTION';
-                contract_id?: string;
-            }
-            interface PrepaidCommitRolloverLedgerEntry {
-                amount: number;
-                new_contract_id: string;
-                segment_id: string;
-                timestamp: string;
-                type: 'PREPAID_COMMIT_ROLLOVER';
-            }
-            interface PrepaidCommitExpirationLedgerEntry {
-                amount: number;
-                segment_id: string;
-                timestamp: string;
-                type: 'PREPAID_COMMIT_EXPIRATION';
-            }
-            interface PrepaidCommitCanceledLedgerEntry {
-                amount: number;
-                invoice_id: string;
-                segment_id: string;
-                timestamp: string;
-                type: 'PREPAID_COMMIT_CANCELED';
-                contract_id?: string;
-            }
-            interface PrepaidCommitCreditedLedgerEntry {
-                amount: number;
-                invoice_id: string;
-                segment_id: string;
-                timestamp: string;
-                type: 'PREPAID_COMMIT_CREDITED';
-                contract_id?: string;
-            }
-            interface PrepaidCommitSeatBasedAdjustmentLedgerEntry {
-                amount: number;
-                segment_id: string;
-                timestamp: string;
-                type: 'PREPAID_COMMIT_SEAT_BASED_ADJUSTMENT';
-            }
-            interface PostpaidCommitInitialBalanceLedgerEntry {
-                amount: number;
-                timestamp: string;
-                type: 'POSTPAID_COMMIT_INITIAL_BALANCE';
-            }
-            interface PostpaidCommitAutomatedInvoiceDeductionLedgerEntry {
-                amount: number;
-                invoice_id: string;
-                segment_id: string;
-                timestamp: string;
-                type: 'POSTPAID_COMMIT_AUTOMATED_INVOICE_DEDUCTION';
-                contract_id?: string;
-            }
-            interface PostpaidCommitRolloverLedgerEntry {
-                amount: number;
-                new_contract_id: string;
-                segment_id: string;
-                timestamp: string;
-                type: 'POSTPAID_COMMIT_ROLLOVER';
-            }
-            interface PostpaidCommitTrueupLedgerEntry {
-                amount: number;
-                invoice_id: string;
-                timestamp: string;
-                type: 'POSTPAID_COMMIT_TRUEUP';
-                contract_id?: string;
-            }
-            interface PrepaidCommitManualLedgerEntry {
-                amount: number;
-                reason: string;
-                timestamp: string;
-                type: 'PREPAID_COMMIT_MANUAL';
-            }
-            interface PostpaidCommitManualLedgerEntry {
-                amount: number;
-                reason: string;
-                timestamp: string;
-                type: 'POSTPAID_COMMIT_MANUAL';
-            }
-            interface PostpaidCommitExpirationLedgerEntry {
-                amount: number;
-                timestamp: string;
-                type: 'POSTPAID_COMMIT_EXPIRATION';
-            }
-            interface RolledOverFrom {
-                commit_id: string;
-                contract_id: string;
-            }
-            interface Specifier {
-                presentation_group_values?: {
-                    [key: string]: string;
-                };
-                pricing_group_values?: {
-                    [key: string]: string;
-                };
-                /**
-                 * If provided, the specifier will only apply to the product with the specified ID.
-                 */
-                product_id?: string;
-                /**
-                 * If provided, the specifier will only apply to products with all the specified
-                 * tags.
-                 */
-                product_tags?: Array<string>;
-            }
-        }
-        interface Override {
-            id: string;
-            starting_at: string;
-            applicable_product_tags?: Array<string>;
-            ending_before?: string;
-            entitled?: boolean;
-            is_commit_specific?: boolean;
-            multiplier?: number;
-            override_specifiers?: Array<Override.OverrideSpecifier>;
-            override_tiers?: Array<Override.OverrideTier>;
-            overwrite_rate?: Override.OverwriteRate;
-            priority?: number;
-            product?: Override.Product;
-            target?: 'COMMIT_RATE' | 'LIST_RATE';
-            type?: 'OVERWRITE' | 'MULTIPLIER' | 'TIERED';
-        }
-        namespace Override {
-            interface OverrideSpecifier {
-                billing_frequency?: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'WEEKLY';
-                commit_ids?: Array<string>;
-                presentation_group_values?: {
-                    [key: string]: string | null;
-                };
-                pricing_group_values?: {
-                    [key: string]: string;
-                };
-                product_id?: string;
-                product_tags?: Array<string>;
-                recurring_commit_ids?: Array<string>;
-                recurring_credit_ids?: Array<string>;
-            }
-            interface OverrideTier {
-                multiplier: number;
-                size?: number;
-            }
-            interface OverwriteRate {
-                rate_type: 'FLAT' | 'PERCENTAGE' | 'SUBSCRIPTION' | 'TIERED' | 'CUSTOM';
-                credit_type?: Shared.CreditTypeData;
-                /**
-                 * Only set for CUSTOM rate_type. This field is interpreted by custom rate
-                 * processors.
-                 */
-                custom_rate?: {
-                    [key: string]: unknown;
-                };
-                /**
-                 * Default proration configuration. Only valid for SUBSCRIPTION rate_type. Must be
-                 * set to true.
-                 */
-                is_prorated?: boolean;
-                /**
-                 * Default price. For FLAT rate_type, this must be >=0. For PERCENTAGE rate_type,
-                 * this is a decimal fraction, e.g. use 0.1 for 10%; this must be >=0 and <=1.
-                 */
-                price?: number;
-                /**
-                 * Default quantity. For SUBSCRIPTION rate_type, this must be >=0.
-                 */
-                quantity?: number;
-                /**
-                 * Only set for TIERED rate_type.
-                 */
-                tiers?: Array<Shared.Tier>;
-            }
-            interface Product {
-                id: string;
-                name: string;
-            }
-        }
-        interface Transition {
-            from_contract_id: string;
-            to_contract_id: string;
-            type: 'SUPERSEDE' | 'RENEWAL';
-        }
-        interface UsageFilter {
-            group_key: string;
-            group_values: Array<string>;
-            /**
-             * This will match contract starting_at value if usage filter is active from the
-             * beginning of the contract.
-             */
-            starting_at: string;
-            /**
-             * This will match contract ending_before value if usage filter is active until the
-             * end of the contract. It will be undefined if the contract is open-ended.
-             */
-            ending_before?: string;
-        }
-        interface UsageStatementSchedule {
-            /**
-             * Contract usage statements follow a selected cadence based on this date.
-             */
-            billing_anchor_date: string;
-            frequency: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'WEEKLY';
-        }
-        interface Credit {
-            id: string;
-            product: Credit.Product;
-            type: 'CREDIT';
-            /**
-             * The schedule that the customer will gain access to the credits.
-             */
-            access_schedule?: Shared.ScheduleDuration;
-            applicable_contract_ids?: Array<string>;
-            applicable_product_ids?: Array<string>;
-            applicable_product_tags?: Array<string>;
-            /**
-             * The current balance of the credit or commit. This balance reflects the amount of
-             * credit or commit that the customer has access to use at this moment - thus,
-             * expired and upcoming credit or commit segments contribute 0 to the balance. The
-             * balance will match the sum of all ledger entries with the exception of the case
-             * where the sum of negative manual ledger entries exceeds the positive amount
-             * remaining on the credit or commit - in that case, the balance will be 0. All
-             * manual ledger entries associated with active credit or commit segments are
-             * included in the balance, including future-dated manual ledger entries.
-             */
-            balance?: number;
-            contract?: Credit.Contract;
-            custom_fields?: {
-                [key: string]: string;
-            };
-            description?: string;
-            /**
-             * Optional configuration for credit hierarchy access control
-             */
-            hierarchy_configuration?: Credit.HierarchyConfiguration;
-            /**
-             * A list of ordered events that impact the balance of a credit. For example, an
-             * invoice deduction or an expiration.
-             */
-            ledger?: Array<Credit.CreditSegmentStartLedgerEntry | Credit.CreditAutomatedInvoiceDeductionLedgerEntry | Credit.CreditExpirationLedgerEntry | Credit.CreditCanceledLedgerEntry | Credit.CreditCreditedLedgerEntry | Credit.CreditManualLedgerEntry | Credit.CreditSeatBasedAdjustmentLedgerEntry>;
-            name?: string;
-            /**
-             * This field's availability is dependent on your client's configuration.
-             */
-            netsuite_sales_order_id?: string;
-            /**
-             * If multiple credits or commits are applicable, the one with the lower priority
-             * will apply first.
-             */
-            priority?: number;
-            /**
-             * This field's availability is dependent on your client's configuration.
-             */
-            salesforce_opportunity_id?: string;
-            /**
-             * List of filters that determine what kind of customer usage draws down a commit
-             * 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?: Array<Credit.Specifier>;
-        }
-        namespace Credit {
-            interface Product {
-                id: string;
-                name: string;
-            }
-            interface Contract {
-                id: string;
-            }
-            /**
-             * Optional configuration for credit hierarchy access control
-             */
-            interface HierarchyConfiguration {
-                child_access: HierarchyConfiguration.CommitHierarchyChildAccessAll | HierarchyConfiguration.CommitHierarchyChildAccessNone | HierarchyConfiguration.CommitHierarchyChildAccessContractIDs;
-            }
-            namespace HierarchyConfiguration {
-                interface CommitHierarchyChildAccessAll {
-                    type: 'ALL';
-                }
-                interface CommitHierarchyChildAccessNone {
-                    type: 'NONE';
-                }
-                interface CommitHierarchyChildAccessContractIDs {
-                    contract_ids: Array<string>;
-                    type: 'CONTRACT_IDS';
-                }
-            }
-            interface CreditSegmentStartLedgerEntry {
-                amount: number;
-                segment_id: string;
-                timestamp: string;
-                type: 'CREDIT_SEGMENT_START';
-            }
-            interface CreditAutomatedInvoiceDeductionLedgerEntry {
-                amount: number;
-                invoice_id: string;
-                segment_id: string;
-                timestamp: string;
-                type: 'CREDIT_AUTOMATED_INVOICE_DEDUCTION';
-                contract_id?: string;
-            }
-            interface CreditExpirationLedgerEntry {
-                amount: number;
-                segment_id: string;
-                timestamp: string;
-                type: 'CREDIT_EXPIRATION';
-            }
-            interface CreditCanceledLedgerEntry {
-                amount: number;
-                invoice_id: string;
-                segment_id: string;
-                timestamp: string;
-                type: 'CREDIT_CANCELED';
-                contract_id?: string;
-            }
-            interface CreditCreditedLedgerEntry {
-                amount: number;
-                invoice_id: string;
-                segment_id: string;
-                timestamp: string;
-                type: 'CREDIT_CREDITED';
-                contract_id?: string;
-            }
-            interface CreditManualLedgerEntry {
-                amount: number;
-                reason: string;
-                timestamp: string;
-                type: 'CREDIT_MANUAL';
-            }
-            interface CreditSeatBasedAdjustmentLedgerEntry {
-                amount: number;
-                segment_id: string;
-                timestamp: string;
-                type: 'CREDIT_SEAT_BASED_ADJUSTMENT';
-            }
-            interface Specifier {
-                presentation_group_values?: {
-                    [key: string]: string;
-                };
-                pricing_group_values?: {
-                    [key: string]: string;
-                };
-                /**
-                 * If provided, the specifier will only apply to the product with the specified ID.
-                 */
-                product_id?: string;
-                /**
-                 * If provided, the specifier will only apply to products with all the specified
-                 * tags.
-                 */
-                product_tags?: Array<string>;
-            }
-        }
-        /**
-         * This field's availability is dependent on your client's configuration.
-         */
-        interface CustomerBillingProviderConfiguration {
-            /**
-             * ID of Customer's billing provider configuration.
-             */
-            id: string;
-            billing_provider: 'aws_marketplace' | 'stripe' | 'netsuite' | 'custom' | 'azure_marketplace' | 'quickbooks_online' | 'workday' | 'gcp_marketplace';
-            delivery_method: 'direct_to_billing_provider' | 'aws_sqs' | 'tackle' | 'aws_sns';
-        }
-        /**
-         * Indicates whether there are more items than the limit for this endpoint. Use the
-         * respective list endpoints to get the full lists.
-         */
-        interface HasMore {
-            /**
-             * Whether there are more commits on this contract than the limit for this
-             * endpoint. Use the /contracts/customerCommits/list endpoint to get the full list
-             * of commits.
-             */
-            commits: boolean;
-            /**
-             * Whether there are more credits on this contract than the limit for this
-             * endpoint. Use the /contracts/customerCredits/list endpoint to get the full list
-             * of credits.
-             */
-            credits: boolean;
-        }
-        interface ParentHierarchyConfiguration {
-            /**
-             * List of contracts that belong to this parent.
-             */
-            children: Array<ParentHierarchyConfiguration.Child>;
-        }
-        namespace ParentHierarchyConfiguration {
-            interface Child {
-                contract_id: string;
-                customer_id: string;
-            }
-        }
-        interface ChildHierarchyConfiguration {
-            /**
-             * The single parent contract/customer for this child.
-             */
-            parent: ChildHierarchyConfiguration.Parent;
-        }
-        namespace ChildHierarchyConfiguration {
-            /**
-             * The single parent contract/customer for this child.
-             */
-            interface Parent {
-                contract_id: string;
-                customer_id: string;
-            }
-        }
-        interface PrepaidBalanceThresholdConfiguration {
-            commit: PrepaidBalanceThresholdConfiguration.Commit;
-            /**
-             * When set to false, the contract will not be evaluated against the
-             * threshold_amount. Toggling to true will result an immediate evaluation,
-             * regardless of prior state.
-             */
-            is_enabled: boolean;
-            payment_gate_config: PrepaidBalanceThresholdConfiguration.PaymentGateConfig;
-            /**
-             * Specify the amount the balance should be recharged to.
-             */
-            recharge_to_amount: number;
-            /**
-             * Specify the threshold amount for the contract. Each time the contract's balance
-             * lowers to this amount, a threshold charge will be initiated.
-             */
-            threshold_amount: number;
-            /**
-             * If provided, the threshold, recharge-to amount, and the resulting threshold
-             * commit amount will be in terms of this credit type instead of the fiat currency.
-             */
-            custom_credit_type_id?: string;
-        }
-        namespace PrepaidBalanceThresholdConfiguration {
-            interface Commit {
-                /**
-                 * The commit product that will be used to generate the line item for commit
-                 * payment.
-                 */
-                product_id: string;
-                /**
-                 * Which products the threshold commit applies to. If applicable_product_ids,
-                 * applicable_product_tags or specifiers are not provided, the commit applies to
-                 * all products.
-                 */
-                applicable_product_ids?: Array<string>;
-                /**
-                 * Which tags the threshold commit applies to. If applicable_product_ids,
-                 * applicable_product_tags or specifiers are not provided, the commit applies to
-                 * all products.
-                 */
-                applicable_product_tags?: Array<string>;
-                description?: string;
-                /**
-                 * Specify the name of the line item for the threshold charge. If left blank, it
-                 * will default to the commit product name.
-                 */
-                name?: string;
-                /**
-                 * List of filters that determine what kind of customer usage draws down a commit
-                 * 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. This field cannot
-                 * be used together with `applicable_product_ids` or `applicable_product_tags`.
-                 * Instead, to target usage by product or product tag, pass those values in the
-                 * body of `specifiers`.
-                 */
-                specifiers?: Array<Commit.Specifier>;
-            }
-            namespace Commit {
-                interface Specifier {
-                    presentation_group_values?: {
-                        [key: string]: string;
-                    };
-                    pricing_group_values?: {
-                        [key: string]: string;
-                    };
-                    /**
-                     * If provided, the specifier will only apply to the product with the specified ID.
-                     */
-                    product_id?: string;
-                    /**
-                     * If provided, the specifier will only apply to products with all the specified
-                     * tags.
-                     */
-                    product_tags?: Array<string>;
-                }
-            }
-            interface PaymentGateConfig {
-                /**
-                 * Gate access to the commit balance based on successful collection of payment.
-                 * Select STRIPE for Metronome to facilitate payment via Stripe. Select EXTERNAL to
-                 * facilitate payment using your own payment integration. Select NONE if you do not
-                 * wish to payment gate the commit balance.
-                 */
-                payment_gate_type: 'NONE' | 'STRIPE' | 'EXTERNAL';
-                /**
-                 * Only applicable if using PRECALCULATED as your tax type.
-                 */
-                precalculated_tax_config?: PaymentGateConfig.PrecalculatedTaxConfig;
-                /**
-                 * Only applicable if using STRIPE as your payment gateway type.
-                 */
-                stripe_config?: PaymentGateConfig.StripeConfig;
-                /**
-                 * Stripe tax is only supported for Stripe payment gateway. Select NONE if you do
-                 * not wish Metronome to calculate tax on your behalf. Leaving this field blank
-                 * will default to NONE.
-                 */
-                tax_type?: 'NONE' | 'STRIPE' | 'ANROK' | 'PRECALCULATED';
-            }
-            namespace PaymentGateConfig {
-                /**
-                 * Only applicable if using PRECALCULATED as your tax type.
-                 */
-                interface PrecalculatedTaxConfig {
-                    /**
-                     * Amount of tax to be applied. This should be in the same currency and
-                     * denomination as the commit's invoice schedule
-                     */
-                    tax_amount: number;
-                    /**
-                     * Name of the tax to be applied. This may be used in an invoice line item
-                     * description.
-                     */
-                    tax_name?: string;
-                }
-                /**
-                 * Only applicable if using STRIPE as your payment gateway type.
-                 */
-                interface StripeConfig {
-                    /**
-                     * If left blank, will default to INVOICE
-                     */
-                    payment_type: 'INVOICE' | 'PAYMENT_INTENT';
-                    /**
-                     * Metadata to be added to the Stripe invoice. Only applicable if using INVOICE as
-                     * your payment type.
-                     */
-                    invoice_metadata?: {
-                        [key: string]: string;
-                    };
-                }
-            }
-        }
-        interface RecurringCommit {
-            id: string;
-            /**
-             * The amount of commit to grant.
-             */
-            access_amount: RecurringCommit.AccessAmount;
-            /**
-             * The amount of time the created commits will be valid for
-             */
-            commit_duration: RecurringCommit.CommitDuration;
-            /**
-             * Will be passed down to the individual commits
-             */
-            priority: number;
-            product: RecurringCommit.Product;
-            /**
-             * Whether the created commits will use the commit rate or list rate
-             */
-            rate_type: 'COMMIT_RATE' | 'LIST_RATE';
-            /**
-             * Determines the start time for the first commit
-             */
-            starting_at: string;
-            /**
-             * Will be passed down to the individual commits
-             */
-            applicable_product_ids?: Array<string>;
-            /**
-             * Will be passed down to the individual commits
-             */
-            applicable_product_tags?: Array<string>;
-            contract?: RecurringCommit.Contract;
-            /**
-             * Will be passed down to the individual commits
-             */
-            description?: string;
-            /**
-             * Determines when the contract will stop creating recurring commits. Optional
-             */
-            ending_before?: string;
-            /**
-             * Optional configuration for recurring credit hierarchy access control
-             */
-            hierarchy_configuration?: RecurringCommit.HierarchyConfiguration;
-            /**
-             * The amount the customer should be billed for the commit. Not required.
-             */
-            invoice_amount?: RecurringCommit.InvoiceAmount;
-            /**
-             * Displayed on invoices. Will be passed through to the individual commits
-             */
-            name?: string;
-            /**
-             * Will be passed down to the individual commits
-             */
-            netsuite_sales_order_id?: string;
-            /**
-             * Determines whether the first and last commit will be prorated. If not provided,
-             * the default is FIRST_AND_LAST (i.e. prorate both the first and last commits).
-             */
-            proration?: 'NONE' | 'FIRST' | 'LAST' | 'FIRST_AND_LAST';
-            /**
-             * 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
-             * be created aligned with the recurring commit's starting_at rather than the usage
-             * invoice dates.
-             */
-            recurrence_frequency?: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'WEEKLY';
-            /**
-             * Will be passed down to the individual commits. This controls how much of an
-             * individual unexpired commit will roll over upon contract transition. Must be
-             * between 0 and 1.
-             */
-            rollover_fraction?: number;
-            /**
-             * List of filters that determine what kind of customer usage draws down a commit
-             * 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?: Array<RecurringCommit.Specifier>;
-            /**
-             * Attach a subscription to the recurring commit/credit.
-             */
-            subscription_config?: RecurringCommit.SubscriptionConfig;
-        }
-        namespace RecurringCommit {
-            /**
-             * The amount of commit to grant.
-             */
-            interface AccessAmount {
-                credit_type_id: string;
-                unit_price: number;
-                quantity?: number;
-            }
-            /**
-             * The amount of time the created commits will be valid for
-             */
-            interface CommitDuration {
-                value: number;
-                unit?: 'PERIODS';
-            }
-            interface Product {
-                id: string;
-                name: string;
-            }
-            interface Contract {
-                id: string;
-            }
-            /**
-             * Optional configuration for recurring credit hierarchy access control
-             */
-            interface HierarchyConfiguration {
-                child_access: HierarchyConfiguration.CommitHierarchyChildAccessAll | HierarchyConfiguration.CommitHierarchyChildAccessNone | HierarchyConfiguration.CommitHierarchyChildAccessContractIDs;
-            }
-            namespace HierarchyConfiguration {
-                interface CommitHierarchyChildAccessAll {
-                    type: 'ALL';
-                }
-                interface CommitHierarchyChildAccessNone {
-                    type: 'NONE';
-                }
-                interface CommitHierarchyChildAccessContractIDs {
-                    contract_ids: Array<string>;
-                    type: 'CONTRACT_IDS';
-                }
-            }
-            /**
-             * The amount the customer should be billed for the commit. Not required.
-             */
-            interface InvoiceAmount {
-                credit_type_id: string;
-                quantity: number;
-                unit_price: number;
-            }
-            interface Specifier {
-                presentation_group_values?: {
-                    [key: string]: string;
-                };
-                pricing_group_values?: {
-                    [key: string]: string;
-                };
-                /**
-                 * If provided, the specifier will only apply to the product with the specified ID.
-                 */
-                product_id?: string;
-                /**
-                 * If provided, the specifier will only apply to products with all the specified
-                 * tags.
-                 */
-                product_tags?: Array<string>;
-            }
-            /**
-             * Attach a subscription to the recurring commit/credit.
-             */
-            interface SubscriptionConfig {
-                allocation: 'INDIVIDUAL' | 'POOLED';
-                apply_seat_increase_config: SubscriptionConfig.ApplySeatIncreaseConfig;
-                subscription_id: string;
-            }
-            namespace SubscriptionConfig {
-                interface ApplySeatIncreaseConfig {
-                    /**
-                     * Indicates whether a mid-period seat increase should be prorated.
-                     */
-                    is_prorated: boolean;
-                }
-            }
-        }
-        interface RecurringCredit {
-            id: string;
-            /**
-             * The amount of commit to grant.
-             */
-            access_amount: RecurringCredit.AccessAmount;
-            /**
-             * The amount of time the created commits will be valid for
-             */
-            commit_duration: RecurringCredit.CommitDuration;
-            /**
-             * Will be passed down to the individual commits
-             */
-            priority: number;
-            product: RecurringCredit.Product;
-            /**
-             * Whether the created commits will use the commit rate or list rate
-             */
-            rate_type: 'COMMIT_RATE' | 'LIST_RATE';
-            /**
-             * Determines the start time for the first commit
-             */
-            starting_at: string;
-            /**
-             * Will be passed down to the individual commits
-             */
-            applicable_product_ids?: Array<string>;
-            /**
-             * Will be passed down to the individual commits
-             */
-            applicable_product_tags?: Array<string>;
-            contract?: RecurringCredit.Contract;
-            /**
-             * Will be passed down to the individual commits
-             */
-            description?: string;
-            /**
-             * Determines when the contract will stop creating recurring commits. Optional
-             */
-            ending_before?: string;
-            /**
-             * Optional configuration for recurring credit hierarchy access control
-             */
-            hierarchy_configuration?: RecurringCredit.HierarchyConfiguration;
-            /**
-             * Displayed on invoices. Will be passed through to the individual commits
-             */
-            name?: string;
-            /**
-             * Will be passed down to the individual commits
-             */
-            netsuite_sales_order_id?: string;
-            /**
-             * Determines whether the first and last commit will be prorated. If not provided,
-             * the default is FIRST_AND_LAST (i.e. prorate both the first and last commits).
-             */
-            proration?: 'NONE' | 'FIRST' | 'LAST' | 'FIRST_AND_LAST';
-            /**
-             * 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
-             * be created aligned with the recurring commit's starting_at rather than the usage
-             * invoice dates.
-             */
-            recurrence_frequency?: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'WEEKLY';
-            /**
-             * Will be passed down to the individual commits. This controls how much of an
-             * individual unexpired commit will roll over upon contract transition. Must be
-             * between 0 and 1.
-             */
-            rollover_fraction?: number;
-            /**
-             * List of filters that determine what kind of customer usage draws down a commit
-             * 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?: Array<RecurringCredit.Specifier>;
-            /**
-             * Attach a subscription to the recurring commit/credit.
-             */
-            subscription_config?: RecurringCredit.SubscriptionConfig;
-        }
-        namespace RecurringCredit {
-            /**
-             * The amount of commit to grant.
-             */
-            interface AccessAmount {
-                credit_type_id: string;
-                unit_price: number;
-                quantity?: number;
-            }
-            /**
-             * The amount of time the created commits will be valid for
-             */
-            interface CommitDuration {
-                value: number;
-                unit?: 'PERIODS';
-            }
-            interface Product {
-                id: string;
-                name: string;
-            }
-            interface Contract {
-                id: string;
-            }
-            /**
-             * Optional configuration for recurring credit hierarchy access control
-             */
-            interface HierarchyConfiguration {
-                child_access: HierarchyConfiguration.CommitHierarchyChildAccessAll | HierarchyConfiguration.CommitHierarchyChildAccessNone | HierarchyConfiguration.CommitHierarchyChildAccessContractIDs;
-            }
-            namespace HierarchyConfiguration {
-                interface CommitHierarchyChildAccessAll {
-                    type: 'ALL';
-                }
-                interface CommitHierarchyChildAccessNone {
-                    type: 'NONE';
-                }
-                interface CommitHierarchyChildAccessContractIDs {
-                    contract_ids: Array<string>;
-                    type: 'CONTRACT_IDS';
-                }
-            }
-            interface Specifier {
-                presentation_group_values?: {
-                    [key: string]: string;
-                };
-                pricing_group_values?: {
-                    [key: string]: string;
-                };
-                /**
-                 * If provided, the specifier will only apply to the product with the specified ID.
-                 */
-                product_id?: string;
-                /**
-                 * If provided, the specifier will only apply to products with all the specified
-                 * tags.
-                 */
-                product_tags?: Array<string>;
-            }
-            /**
-             * Attach a subscription to the recurring commit/credit.
-             */
-            interface SubscriptionConfig {
-                allocation: 'INDIVIDUAL' | 'POOLED';
-                apply_seat_increase_config: SubscriptionConfig.ApplySeatIncreaseConfig;
-                subscription_id: string;
-            }
-            namespace SubscriptionConfig {
-                interface ApplySeatIncreaseConfig {
-                    /**
-                     * Indicates whether a mid-period seat increase should be prorated.
-                     */
-                    is_prorated: boolean;
-                }
-            }
-        }
-        interface ResellerRoyalty {
-            reseller_type: 'AWS' | 'AWS_PRO_SERVICE' | 'GCP' | 'GCP_PRO_SERVICE';
-            segments: Array<ResellerRoyalty.Segment>;
-        }
-        namespace ResellerRoyalty {
-            interface Segment {
-                fraction: number;
-                netsuite_reseller_id: string;
-                reseller_type: 'AWS' | 'AWS_PRO_SERVICE' | 'GCP' | 'GCP_PRO_SERVICE';
-                starting_at: string;
-                applicable_product_ids?: Array<string>;
-                applicable_product_tags?: Array<string>;
-                aws_account_number?: string;
-                aws_offer_id?: string;
-                aws_payer_reference_id?: string;
-                ending_before?: string;
-                gcp_account_id?: string;
-                gcp_offer_id?: string;
-                reseller_contract_value?: number;
-            }
-        }
-        interface SpendThresholdConfiguration {
-            commit: SpendThresholdConfiguration.Commit;
-            /**
-             * When set to false, the contract will not be evaluated against the
-             * threshold_amount. Toggling to true will result an immediate evaluation,
-             * regardless of prior state.
-             */
-            is_enabled: boolean;
-            payment_gate_config: SpendThresholdConfiguration.PaymentGateConfig;
-            /**
-             * Specify the threshold amount for the contract. Each time the contract's usage
-             * hits this amount, a threshold charge will be initiated.
-             */
-            threshold_amount: number;
-        }
-        namespace SpendThresholdConfiguration {
-            interface Commit {
-                /**
-                 * The commit product that will be used to generate the line item for commit
-                 * payment.
-                 */
-                product_id: string;
-                description?: string;
-                /**
-                 * Specify the name of the line item for the threshold charge. If left blank, it
-                 * will default to the commit product name.
-                 */
-                name?: string;
-            }
-            interface PaymentGateConfig {
-                /**
-                 * Gate access to the commit balance based on successful collection of payment.
-                 * Select STRIPE for Metronome to facilitate payment via Stripe. Select EXTERNAL to
-                 * facilitate payment using your own payment integration. Select NONE if you do not
-                 * wish to payment gate the commit balance.
-                 */
-                payment_gate_type: 'NONE' | 'STRIPE' | 'EXTERNAL';
-                /**
-                 * Only applicable if using PRECALCULATED as your tax type.
-                 */
-                precalculated_tax_config?: PaymentGateConfig.PrecalculatedTaxConfig;
-                /**
-                 * Only applicable if using STRIPE as your payment gateway type.
-                 */
-                stripe_config?: PaymentGateConfig.StripeConfig;
-                /**
-                 * Stripe tax is only supported for Stripe payment gateway. Select NONE if you do
-                 * not wish Metronome to calculate tax on your behalf. Leaving this field blank
-                 * will default to NONE.
-                 */
-                tax_type?: 'NONE' | 'STRIPE' | 'ANROK' | 'PRECALCULATED';
-            }
-            namespace PaymentGateConfig {
-                /**
-                 * Only applicable if using PRECALCULATED as your tax type.
-                 */
-                interface PrecalculatedTaxConfig {
-                    /**
-                     * Amount of tax to be applied. This should be in the same currency and
-                     * denomination as the commit's invoice schedule
-                     */
-                    tax_amount: number;
-                    /**
-                     * Name of the tax to be applied. This may be used in an invoice line item
-                     * description.
-                     */
-                    tax_name?: string;
-                }
-                /**
-                 * Only applicable if using STRIPE as your payment gateway type.
-                 */
-                interface StripeConfig {
-                    /**
-                     * If left blank, will default to INVOICE
-                     */
-                    payment_type: 'INVOICE' | 'PAYMENT_INTENT';
-                    /**
-                     * Metadata to be added to the Stripe invoice. Only applicable if using INVOICE as
-                     * your payment type.
-                     */
-                    invoice_metadata?: {
-                        [key: string]: string;
-                    };
-                }
-            }
-        }
-        interface Subscription {
-            collection_schedule: 'ADVANCE' | 'ARREARS';
-            proration: Subscription.Proration;
-            /**
-             * List of quantity schedule items for the subscription. Only includes the current
-             * quantity and future quantity changes.
-             */
-            quantity_schedule: Array<Subscription.QuantitySchedule>;
-            starting_at: string;
-            subscription_rate: Subscription.SubscriptionRate;
-            id?: string;
-            custom_fields?: {
-                [key: string]: string;
-            };
-            description?: string;
-            ending_before?: string;
-            fiat_credit_type_id?: string;
-            name?: string;
-        }
-        namespace Subscription {
-            interface Proration {
-                invoice_behavior: 'BILL_IMMEDIATELY' | 'BILL_ON_NEXT_COLLECTION_DATE';
-                is_prorated: boolean;
-            }
-            interface QuantitySchedule {
-                quantity: number;
-                starting_at: string;
-                ending_before?: string;
-            }
-            interface SubscriptionRate {
-                billing_frequency: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'WEEKLY';
-                product: SubscriptionRate.Product;
-            }
-            namespace SubscriptionRate {
-                interface Product {
-                    id: string;
-                    name: string;
-                }
-            }
-        }
-    }
+     * ### Use this endpoint to:
+     *
+     * - Understand what changes were made to a contract, when, and by who
+     *
+     * ### Key response fields:
+     *
+     * - An array of every edit ever made to the contract
+     * - Details on each individual edit - for example showing that in one edit, a user
+     *   added two discounts and incremented a subscription quantity.
+     *
+     * @example
+     * ```ts
+     * const response = await client.v2.contracts.getEditHistory({
+     *   contract_id: 'd7abd0cd-4ae9-4db7-8676-e986a4ebd8dc',
+     *   customer_id: '13117714-3f05-48e5-a6e9-a66093f13b4d',
+     * });
+     * ```
+     */
+    getEditHistory(body: ContractGetEditHistoryParams, options?: RequestOptions): APIPromise<ContractGetEditHistoryResponse>;
+}
+export interface ContractRetrieveResponse {
+    data: Shared.ContractV2;
+}
+export interface ContractListResponse {
+    data: Array<Shared.ContractV2>;
 }
 export interface ContractEditResponse {
     data: Shared.ID;
@@ -2581,23 +234,29 @@ export declare namespace ContractGetEditHistoryResponse {
         add_credits?: Array<Data.AddCredit>;
         add_discounts?: Array<Shared.Discount>;
         add_overrides?: Array<Data.AddOverride>;
-        add_prepaid_balance_threshold_configuration?: Data.AddPrepaidBalanceThresholdConfiguration;
+        add_prepaid_balance_threshold_configuration?: Shared.PrepaidBalanceThresholdConfigurationV2;
         add_pro_services?: Array<Shared.ProService>;
         add_recurring_commits?: Array<Data.AddRecurringCommit>;
         add_recurring_credits?: Array<Data.AddRecurringCredit>;
         add_reseller_royalties?: Array<Data.AddResellerRoyalty>;
         add_scheduled_charges?: Array<Data.AddScheduledCharge>;
-        add_spend_threshold_configuration?: Data.AddSpendThresholdConfiguration;
+        add_spend_threshold_configuration?: Shared.SpendThresholdConfigurationV2;
         /**
          * List of subscriptions on the contract.
          */
-        add_subscriptions?: Array<Data.AddSubscription>;
+        add_subscriptions?: Array<Shared.Subscription>;
         add_usage_filters?: Array<Data.AddUsageFilter>;
         archive_commits?: Array<Data.ArchiveCommit>;
         archive_credits?: Array<Data.ArchiveCredit>;
         archive_scheduled_charges?: Array<Data.ArchiveScheduledCharge>;
         remove_overrides?: Array<Data.RemoveOverride>;
         timestamp?: string;
+        /**
+         * Prevents the creation of duplicates. If a request to create a record is made
+         * with a previously used uniqueness key, a new record will not be created and the
+         * request will fail with a 409 error.
+         */
+        uniqueness_key?: string;
         update_commits?: Array<Data.UpdateCommit>;
         update_contract_end_date?: string;
         /**
@@ -2634,7 +293,7 @@ export declare namespace ContractGetEditHistoryResponse {
             /**
              * Optional configuration for commit hierarchy access control
              */
-            hierarchy_configuration?: AddCommit.HierarchyConfiguration;
+            hierarchy_configuration?: Shared.CommitHierarchyConfiguration;
             /**
              * The schedule that the customer will be invoiced for this commit.
              */
@@ -2663,48 +322,13 @@ export declare namespace ContractGetEditHistoryResponse {
              * Instead, to target usage by product or product tag, pass those values in the
              * body of `specifiers`.
              */
-            specifiers?: Array<AddCommit.Specifier>;
+            specifiers?: Array<Shared.CommitSpecifierInput>;
         }
         namespace AddCommit {
             interface Product {
                 id: string;
                 name: string;
             }
-            /**
-             * Optional configuration for commit hierarchy access control
-             */
-            interface HierarchyConfiguration {
-                child_access: HierarchyConfiguration.CommitHierarchyChildAccessAll | HierarchyConfiguration.CommitHierarchyChildAccessNone | HierarchyConfiguration.CommitHierarchyChildAccessContractIDs;
-            }
-            namespace HierarchyConfiguration {
-                interface CommitHierarchyChildAccessAll {
-                    type: 'ALL';
-                }
-                interface CommitHierarchyChildAccessNone {
-                    type: 'NONE';
-                }
-                interface CommitHierarchyChildAccessContractIDs {
-                    contract_ids: Array<string>;
-                    type: 'CONTRACT_IDS';
-                }
-            }
-            interface Specifier {
-                presentation_group_values?: {
-                    [key: string]: string;
-                };
-                pricing_group_values?: {
-                    [key: string]: string;
-                };
-                /**
-                 * If provided, the specifier will only apply to the product with the specified ID.
-                 */
-                product_id?: string;
-                /**
-                 * If provided, the specifier will only apply to products with all the specified
-                 * tags.
-                 */
-                product_tags?: Array<string>;
-            }
         }
         interface AddCredit {
             id: string;
@@ -2720,7 +344,7 @@ export declare namespace ContractGetEditHistoryResponse {
             /**
              * Optional configuration for recurring credit hierarchy access control
              */
-            hierarchy_configuration?: AddCredit.HierarchyConfiguration;
+            hierarchy_configuration?: Shared.CommitHierarchyConfiguration;
             name?: string;
             /**
              * This field's availability is dependent on your client's configuration.
@@ -2743,48 +367,13 @@ export declare namespace ContractGetEditHistoryResponse {
              * Instead, to target usage by product or product tag, pass those values in the
              * body of `specifiers`.
              */
-            specifiers?: Array<AddCredit.Specifier>;
+            specifiers?: Array<Shared.CommitSpecifierInput>;
         }
         namespace AddCredit {
             interface Product {
                 id: string;
                 name: string;
             }
-            /**
-             * Optional configuration for recurring credit hierarchy access control
-             */
-            interface HierarchyConfiguration {
-                child_access: HierarchyConfiguration.CommitHierarchyChildAccessAll | HierarchyConfiguration.CommitHierarchyChildAccessNone | HierarchyConfiguration.CommitHierarchyChildAccessContractIDs;
-            }
-            namespace HierarchyConfiguration {
-                interface CommitHierarchyChildAccessAll {
-                    type: 'ALL';
-                }
-                interface CommitHierarchyChildAccessNone {
-                    type: 'NONE';
-                }
-                interface CommitHierarchyChildAccessContractIDs {
-                    contract_ids: Array<string>;
-                    type: 'CONTRACT_IDS';
-                }
-            }
-            interface Specifier {
-                presentation_group_values?: {
-                    [key: string]: string;
-                };
-                pricing_group_values?: {
-                    [key: string]: string;
-                };
-                /**
-                 * If provided, the specifier will only apply to the product with the specified ID.
-                 */
-                product_id?: string;
-                /**
-                 * If provided, the specifier will only apply to products with all the specified
-                 * tags.
-                 */
-                product_tags?: Array<string>;
-            }
         }
         interface AddOverride {
             id: string;
@@ -2795,8 +384,8 @@ export declare namespace ContractGetEditHistoryResponse {
             is_commit_specific?: boolean;
             multiplier?: number;
             override_specifiers?: Array<AddOverride.OverrideSpecifier>;
-            override_tiers?: Array<AddOverride.OverrideTier>;
-            overwrite_rate?: AddOverride.OverwriteRate;
+            override_tiers?: Array<Shared.OverrideTier>;
+            overwrite_rate?: Shared.OverwriteRate;
             priority?: number;
             product?: AddOverride.Product;
             target?: 'COMMIT_RATE' | 'LIST_RATE';
@@ -2817,179 +406,11 @@ export declare namespace ContractGetEditHistoryResponse {
                 recurring_commit_ids?: Array<string>;
                 recurring_credit_ids?: Array<string>;
             }
-            interface OverrideTier {
-                multiplier: number;
-                size?: number;
-            }
-            interface OverwriteRate {
-                rate_type: 'FLAT' | 'PERCENTAGE' | 'SUBSCRIPTION' | 'TIERED' | 'CUSTOM';
-                credit_type?: Shared.CreditTypeData;
-                /**
-                 * Only set for CUSTOM rate_type. This field is interpreted by custom rate
-                 * processors.
-                 */
-                custom_rate?: {
-                    [key: string]: unknown;
-                };
-                /**
-                 * Default proration configuration. Only valid for SUBSCRIPTION rate_type. Must be
-                 * set to true.
-                 */
-                is_prorated?: boolean;
-                /**
-                 * Default price. For FLAT rate_type, this must be >=0. For PERCENTAGE rate_type,
-                 * this is a decimal fraction, e.g. use 0.1 for 10%; this must be >=0 and <=1.
-                 */
-                price?: number;
-                /**
-                 * Default quantity. For SUBSCRIPTION rate_type, this must be >=0.
-                 */
-                quantity?: number;
-                /**
-                 * Only set for TIERED rate_type.
-                 */
-                tiers?: Array<Shared.Tier>;
-            }
             interface Product {
                 id: string;
                 name: string;
             }
         }
-        interface AddPrepaidBalanceThresholdConfiguration {
-            commit: AddPrepaidBalanceThresholdConfiguration.Commit;
-            /**
-             * When set to false, the contract will not be evaluated against the
-             * threshold_amount. Toggling to true will result an immediate evaluation,
-             * regardless of prior state.
-             */
-            is_enabled: boolean;
-            payment_gate_config: AddPrepaidBalanceThresholdConfiguration.PaymentGateConfig;
-            /**
-             * Specify the amount the balance should be recharged to.
-             */
-            recharge_to_amount: number;
-            /**
-             * Specify the threshold amount for the contract. Each time the contract's balance
-             * lowers to this amount, a threshold charge will be initiated.
-             */
-            threshold_amount: number;
-            /**
-             * If provided, the threshold, recharge-to amount, and the resulting threshold
-             * commit amount will be in terms of this credit type instead of the fiat currency.
-             */
-            custom_credit_type_id?: string;
-        }
-        namespace AddPrepaidBalanceThresholdConfiguration {
-            interface Commit {
-                /**
-                 * The commit product that will be used to generate the line item for commit
-                 * payment.
-                 */
-                product_id: string;
-                /**
-                 * Which products the threshold commit applies to. If applicable_product_ids,
-                 * applicable_product_tags or specifiers are not provided, the commit applies to
-                 * all products.
-                 */
-                applicable_product_ids?: Array<string>;
-                /**
-                 * Which tags the threshold commit applies to. If applicable_product_ids,
-                 * applicable_product_tags or specifiers are not provided, the commit applies to
-                 * all products.
-                 */
-                applicable_product_tags?: Array<string>;
-                description?: string;
-                /**
-                 * Specify the name of the line item for the threshold charge. If left blank, it
-                 * will default to the commit product name.
-                 */
-                name?: string;
-                /**
-                 * List of filters that determine what kind of customer usage draws down a commit
-                 * 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. This field cannot
-                 * be used together with `applicable_product_ids` or `applicable_product_tags`.
-                 * Instead, to target usage by product or product tag, pass those values in the
-                 * body of `specifiers`.
-                 */
-                specifiers?: Array<Commit.Specifier>;
-            }
-            namespace Commit {
-                interface Specifier {
-                    presentation_group_values?: {
-                        [key: string]: string;
-                    };
-                    pricing_group_values?: {
-                        [key: string]: string;
-                    };
-                    /**
-                     * If provided, the specifier will only apply to the product with the specified ID.
-                     */
-                    product_id?: string;
-                    /**
-                     * If provided, the specifier will only apply to products with all the specified
-                     * tags.
-                     */
-                    product_tags?: Array<string>;
-                }
-            }
-            interface PaymentGateConfig {
-                /**
-                 * Gate access to the commit balance based on successful collection of payment.
-                 * Select STRIPE for Metronome to facilitate payment via Stripe. Select EXTERNAL to
-                 * facilitate payment using your own payment integration. Select NONE if you do not
-                 * wish to payment gate the commit balance.
-                 */
-                payment_gate_type: 'NONE' | 'STRIPE' | 'EXTERNAL';
-                /**
-                 * Only applicable if using PRECALCULATED as your tax type.
-                 */
-                precalculated_tax_config?: PaymentGateConfig.PrecalculatedTaxConfig;
-                /**
-                 * Only applicable if using STRIPE as your payment gateway type.
-                 */
-                stripe_config?: PaymentGateConfig.StripeConfig;
-                /**
-                 * Stripe tax is only supported for Stripe payment gateway. Select NONE if you do
-                 * not wish Metronome to calculate tax on your behalf. Leaving this field blank
-                 * will default to NONE.
-                 */
-                tax_type?: 'NONE' | 'STRIPE' | 'ANROK' | 'PRECALCULATED';
-            }
-            namespace PaymentGateConfig {
-                /**
-                 * Only applicable if using PRECALCULATED as your tax type.
-                 */
-                interface PrecalculatedTaxConfig {
-                    /**
-                     * Amount of tax to be applied. This should be in the same currency and
-                     * denomination as the commit's invoice schedule
-                     */
-                    tax_amount: number;
-                    /**
-                     * Name of the tax to be applied. This may be used in an invoice line item
-                     * description.
-                     */
-                    tax_name?: string;
-                }
-                /**
-                 * Only applicable if using STRIPE as your payment gateway type.
-                 */
-                interface StripeConfig {
-                    /**
-                     * If left blank, will default to INVOICE
-                     */
-                    payment_type: 'INVOICE' | 'PAYMENT_INTENT';
-                    /**
-                     * Metadata to be added to the Stripe invoice. Only applicable if using INVOICE as
-                     * your payment type.
-                     */
-                    invoice_metadata?: {
-                        [key: string]: string;
-                    };
-                }
-            }
-        }
         interface AddRecurringCommit {
             id: string;
             /**
@@ -3033,7 +454,7 @@ export declare namespace ContractGetEditHistoryResponse {
             /**
              * Optional configuration for recurring credit hierarchy access control
              */
-            hierarchy_configuration?: AddRecurringCommit.HierarchyConfiguration;
+            hierarchy_configuration?: Shared.CommitHierarchyConfiguration;
             /**
              * The amount the customer should be billed for the commit. Not required.
              */
@@ -3070,11 +491,11 @@ export declare namespace ContractGetEditHistoryResponse {
              * 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?: Array<AddRecurringCommit.Specifier>;
+            specifiers?: Array<Shared.CommitSpecifier>;
             /**
              * Attach a subscription to the recurring commit/credit.
              */
-            subscription_config?: AddRecurringCommit.SubscriptionConfig;
+            subscription_config?: Shared.RecurringCommitSubscriptionConfig;
         }
         namespace AddRecurringCommit {
             /**
@@ -3099,24 +520,6 @@ export declare namespace ContractGetEditHistoryResponse {
             interface Contract {
                 id: string;
             }
-            /**
-             * Optional configuration for recurring credit hierarchy access control
-             */
-            interface HierarchyConfiguration {
-                child_access: HierarchyConfiguration.CommitHierarchyChildAccessAll | HierarchyConfiguration.CommitHierarchyChildAccessNone | HierarchyConfiguration.CommitHierarchyChildAccessContractIDs;
-            }
-            namespace HierarchyConfiguration {
-                interface CommitHierarchyChildAccessAll {
-                    type: 'ALL';
-                }
-                interface CommitHierarchyChildAccessNone {
-                    type: 'NONE';
-                }
-                interface CommitHierarchyChildAccessContractIDs {
-                    contract_ids: Array<string>;
-                    type: 'CONTRACT_IDS';
-                }
-            }
             /**
              * The amount the customer should be billed for the commit. Not required.
              */
@@ -3125,39 +528,6 @@ export declare namespace ContractGetEditHistoryResponse {
                 quantity: number;
                 unit_price: number;
             }
-            interface Specifier {
-                presentation_group_values?: {
-                    [key: string]: string;
-                };
-                pricing_group_values?: {
-                    [key: string]: string;
-                };
-                /**
-                 * If provided, the specifier will only apply to the product with the specified ID.
-                 */
-                product_id?: string;
-                /**
-                 * If provided, the specifier will only apply to products with all the specified
-                 * tags.
-                 */
-                product_tags?: Array<string>;
-            }
-            /**
-             * Attach a subscription to the recurring commit/credit.
-             */
-            interface SubscriptionConfig {
-                allocation: 'INDIVIDUAL' | 'POOLED';
-                apply_seat_increase_config: SubscriptionConfig.ApplySeatIncreaseConfig;
-                subscription_id: string;
-            }
-            namespace SubscriptionConfig {
-                interface ApplySeatIncreaseConfig {
-                    /**
-                     * Indicates whether a mid-period seat increase should be prorated.
-                     */
-                    is_prorated: boolean;
-                }
-            }
         }
         interface AddRecurringCredit {
             id: string;
@@ -3202,7 +572,7 @@ export declare namespace ContractGetEditHistoryResponse {
             /**
              * Optional configuration for recurring credit hierarchy access control
              */
-            hierarchy_configuration?: AddRecurringCredit.HierarchyConfiguration;
+            hierarchy_configuration?: Shared.CommitHierarchyConfiguration;
             /**
              * Displayed on invoices. Will be passed through to the individual commits
              */
@@ -3235,11 +605,11 @@ export declare namespace ContractGetEditHistoryResponse {
              * 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?: Array<AddRecurringCredit.Specifier>;
+            specifiers?: Array<Shared.CommitSpecifier>;
             /**
              * Attach a subscription to the recurring commit/credit.
              */
-            subscription_config?: AddRecurringCredit.SubscriptionConfig;
+            subscription_config?: Shared.RecurringCommitSubscriptionConfig;
         }
         namespace AddRecurringCredit {
             /**
@@ -3264,57 +634,6 @@ export declare namespace ContractGetEditHistoryResponse {
             interface Contract {
                 id: string;
             }
-            /**
-             * Optional configuration for recurring credit hierarchy access control
-             */
-            interface HierarchyConfiguration {
-                child_access: HierarchyConfiguration.CommitHierarchyChildAccessAll | HierarchyConfiguration.CommitHierarchyChildAccessNone | HierarchyConfiguration.CommitHierarchyChildAccessContractIDs;
-            }
-            namespace HierarchyConfiguration {
-                interface CommitHierarchyChildAccessAll {
-                    type: 'ALL';
-                }
-                interface CommitHierarchyChildAccessNone {
-                    type: 'NONE';
-                }
-                interface CommitHierarchyChildAccessContractIDs {
-                    contract_ids: Array<string>;
-                    type: 'CONTRACT_IDS';
-                }
-            }
-            interface Specifier {
-                presentation_group_values?: {
-                    [key: string]: string;
-                };
-                pricing_group_values?: {
-                    [key: string]: string;
-                };
-                /**
-                 * If provided, the specifier will only apply to the product with the specified ID.
-                 */
-                product_id?: string;
-                /**
-                 * If provided, the specifier will only apply to products with all the specified
-                 * tags.
-                 */
-                product_tags?: Array<string>;
-            }
-            /**
-             * Attach a subscription to the recurring commit/credit.
-             */
-            interface SubscriptionConfig {
-                allocation: 'INDIVIDUAL' | 'POOLED';
-                apply_seat_increase_config: SubscriptionConfig.ApplySeatIncreaseConfig;
-                subscription_id: string;
-            }
-            namespace SubscriptionConfig {
-                interface ApplySeatIncreaseConfig {
-                    /**
-                     * Indicates whether a mid-period seat increase should be prorated.
-                     */
-                    is_prorated: boolean;
-                }
-            }
         }
         interface AddResellerRoyalty {
             reseller_type: 'AWS' | 'AWS_PRO_SERVICE' | 'GCP' | 'GCP_PRO_SERVICE';
@@ -3344,136 +663,10 @@ export declare namespace ContractGetEditHistoryResponse {
              */
             netsuite_sales_order_id?: string;
         }
-        namespace AddScheduledCharge {
-            interface Product {
-                id: string;
-                name: string;
-            }
-        }
-        interface AddSpendThresholdConfiguration {
-            commit: AddSpendThresholdConfiguration.Commit;
-            /**
-             * When set to false, the contract will not be evaluated against the
-             * threshold_amount. Toggling to true will result an immediate evaluation,
-             * regardless of prior state.
-             */
-            is_enabled: boolean;
-            payment_gate_config: AddSpendThresholdConfiguration.PaymentGateConfig;
-            /**
-             * Specify the threshold amount for the contract. Each time the contract's usage
-             * hits this amount, a threshold charge will be initiated.
-             */
-            threshold_amount: number;
-        }
-        namespace AddSpendThresholdConfiguration {
-            interface Commit {
-                /**
-                 * The commit product that will be used to generate the line item for commit
-                 * payment.
-                 */
-                product_id: string;
-                description?: string;
-                /**
-                 * Specify the name of the line item for the threshold charge. If left blank, it
-                 * will default to the commit product name.
-                 */
-                name?: string;
-            }
-            interface PaymentGateConfig {
-                /**
-                 * Gate access to the commit balance based on successful collection of payment.
-                 * Select STRIPE for Metronome to facilitate payment via Stripe. Select EXTERNAL to
-                 * facilitate payment using your own payment integration. Select NONE if you do not
-                 * wish to payment gate the commit balance.
-                 */
-                payment_gate_type: 'NONE' | 'STRIPE' | 'EXTERNAL';
-                /**
-                 * Only applicable if using PRECALCULATED as your tax type.
-                 */
-                precalculated_tax_config?: PaymentGateConfig.PrecalculatedTaxConfig;
-                /**
-                 * Only applicable if using STRIPE as your payment gateway type.
-                 */
-                stripe_config?: PaymentGateConfig.StripeConfig;
-                /**
-                 * Stripe tax is only supported for Stripe payment gateway. Select NONE if you do
-                 * not wish Metronome to calculate tax on your behalf. Leaving this field blank
-                 * will default to NONE.
-                 */
-                tax_type?: 'NONE' | 'STRIPE' | 'ANROK' | 'PRECALCULATED';
-            }
-            namespace PaymentGateConfig {
-                /**
-                 * Only applicable if using PRECALCULATED as your tax type.
-                 */
-                interface PrecalculatedTaxConfig {
-                    /**
-                     * Amount of tax to be applied. This should be in the same currency and
-                     * denomination as the commit's invoice schedule
-                     */
-                    tax_amount: number;
-                    /**
-                     * Name of the tax to be applied. This may be used in an invoice line item
-                     * description.
-                     */
-                    tax_name?: string;
-                }
-                /**
-                 * Only applicable if using STRIPE as your payment gateway type.
-                 */
-                interface StripeConfig {
-                    /**
-                     * If left blank, will default to INVOICE
-                     */
-                    payment_type: 'INVOICE' | 'PAYMENT_INTENT';
-                    /**
-                     * Metadata to be added to the Stripe invoice. Only applicable if using INVOICE as
-                     * your payment type.
-                     */
-                    invoice_metadata?: {
-                        [key: string]: string;
-                    };
-                }
-            }
-        }
-        interface AddSubscription {
-            collection_schedule: 'ADVANCE' | 'ARREARS';
-            proration: AddSubscription.Proration;
-            /**
-             * List of quantity schedule items for the subscription. Only includes the current
-             * quantity and future quantity changes.
-             */
-            quantity_schedule: Array<AddSubscription.QuantitySchedule>;
-            starting_at: string;
-            subscription_rate: AddSubscription.SubscriptionRate;
-            id?: string;
-            custom_fields?: {
-                [key: string]: string;
-            };
-            description?: string;
-            ending_before?: string;
-            fiat_credit_type_id?: string;
-            name?: string;
-        }
-        namespace AddSubscription {
-            interface Proration {
-                invoice_behavior: 'BILL_IMMEDIATELY' | 'BILL_ON_NEXT_COLLECTION_DATE';
-                is_prorated: boolean;
-            }
-            interface QuantitySchedule {
-                quantity: number;
-                starting_at: string;
-                ending_before?: string;
-            }
-            interface SubscriptionRate {
-                billing_frequency: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'WEEKLY';
-                product: SubscriptionRate.Product;
-            }
-            namespace SubscriptionRate {
-                interface Product {
-                    id: string;
-                    name: string;
-                }
+        namespace AddScheduledCharge {
+            interface Product {
+                id: string;
+                name: string;
             }
         }
         interface AddUsageFilter {
@@ -3520,7 +713,7 @@ export declare namespace ContractGetEditHistoryResponse {
             /**
              * Optional configuration for commit hierarchy access control
              */
-            hierarchy_configuration?: UpdateCommit.HierarchyConfiguration;
+            hierarchy_configuration?: Shared.CommitHierarchyConfiguration;
             invoice_schedule?: UpdateCommit.InvoiceSchedule;
             name?: string;
             netsuite_sales_order_id?: string | null;
@@ -3530,6 +723,10 @@ export declare namespace ContractGetEditHistoryResponse {
              */
             priority?: number | null;
             product_id?: string;
+            /**
+             * If set, the commit's rate type was updated to the specified value.
+             */
+            rate_type?: 'COMMIT_RATE' | 'LIST_RATE';
             rollover_fraction?: number | null;
             /**
              * List of filters that determine what kind of customer usage draws down a commit
@@ -3539,7 +736,7 @@ export declare namespace ContractGetEditHistoryResponse {
              * Instead, to target usage by product or product tag, pass those values in the
              * body of `specifiers`.
              */
-            specifiers?: Array<UpdateCommit.Specifier> | null;
+            specifiers?: Array<Shared.CommitSpecifierInput> | null;
         }
         namespace UpdateCommit {
             interface AccessSchedule {
@@ -3575,24 +772,6 @@ export declare namespace ContractGetEditHistoryResponse {
                     starting_at?: string;
                 }
             }
-            /**
-             * Optional configuration for commit hierarchy access control
-             */
-            interface HierarchyConfiguration {
-                child_access: HierarchyConfiguration.CommitHierarchyChildAccessAll | HierarchyConfiguration.CommitHierarchyChildAccessNone | HierarchyConfiguration.CommitHierarchyChildAccessContractIDs;
-            }
-            namespace HierarchyConfiguration {
-                interface CommitHierarchyChildAccessAll {
-                    type: 'ALL';
-                }
-                interface CommitHierarchyChildAccessNone {
-                    type: 'NONE';
-                }
-                interface CommitHierarchyChildAccessContractIDs {
-                    contract_ids: Array<string>;
-                    type: 'CONTRACT_IDS';
-                }
-            }
             interface InvoiceSchedule {
                 add_schedule_items?: Array<InvoiceSchedule.AddScheduleItem>;
                 remove_schedule_items?: Array<InvoiceSchedule.RemoveScheduleItem>;
@@ -3616,23 +795,6 @@ export declare namespace ContractGetEditHistoryResponse {
                     unit_price?: number;
                 }
             }
-            interface Specifier {
-                presentation_group_values?: {
-                    [key: string]: string;
-                };
-                pricing_group_values?: {
-                    [key: string]: string;
-                };
-                /**
-                 * If provided, the specifier will only apply to the product with the specified ID.
-                 */
-                product_id?: string;
-                /**
-                 * If provided, the specifier will only apply to products with all the specified
-                 * tags.
-                 */
-                product_tags?: Array<string>;
-            }
         }
         interface UpdateCredit {
             id: string;
@@ -3640,7 +802,7 @@ export declare namespace ContractGetEditHistoryResponse {
             /**
              * Optional configuration for credit hierarchy access control
              */
-            hierarchy_configuration?: UpdateCredit.HierarchyConfiguration;
+            hierarchy_configuration?: Shared.CommitHierarchyConfiguration;
             name?: string;
             netsuite_sales_order_id?: string | null;
             /**
@@ -3648,6 +810,10 @@ export declare namespace ContractGetEditHistoryResponse {
              * first.
              */
             priority?: number | null;
+            /**
+             * If set, the credit's rate type was updated to the specified value.
+             */
+            rate_type?: 'LIST_RATE' | 'COMMIT_RATE';
             rollover_fraction?: number | null;
         }
         namespace UpdateCredit {
@@ -3684,27 +850,12 @@ export declare namespace ContractGetEditHistoryResponse {
                     starting_at?: string;
                 }
             }
-            /**
-             * Optional configuration for credit hierarchy access control
-             */
-            interface HierarchyConfiguration {
-                child_access: HierarchyConfiguration.CommitHierarchyChildAccessAll | HierarchyConfiguration.CommitHierarchyChildAccessNone | HierarchyConfiguration.CommitHierarchyChildAccessContractIDs;
-            }
-            namespace HierarchyConfiguration {
-                interface CommitHierarchyChildAccessAll {
-                    type: 'ALL';
-                }
-                interface CommitHierarchyChildAccessNone {
-                    type: 'NONE';
-                }
-                interface CommitHierarchyChildAccessContractIDs {
-                    contract_ids: Array<string>;
-                    type: 'CONTRACT_IDS';
-                }
-            }
         }
         interface UpdateDiscount {
             id: string;
+            /**
+             * Custom fields to be added eg. { "key1": "value1", "key2": "value2" }
+             */
             custom_fields?: {
                 [key: string]: string;
             };
@@ -3815,7 +966,7 @@ export declare namespace ContractGetEditHistoryResponse {
              * regardless of prior state.
              */
             is_enabled?: boolean;
-            payment_gate_config?: UpdatePrepaidBalanceThresholdConfiguration.PaymentGateConfig;
+            payment_gate_config?: Shared.PaymentGateConfigV2;
             /**
              * Specify the amount the balance should be recharged to.
              */
@@ -3827,7 +978,7 @@ export declare namespace ContractGetEditHistoryResponse {
             threshold_amount?: number;
         }
         namespace UpdatePrepaidBalanceThresholdConfiguration {
-            interface Commit {
+            interface Commit extends Shared.UpdateBaseThresholdCommit {
                 /**
                  * Which products the threshold commit applies to. If both applicable_product_ids
                  * and applicable_product_tags are not provided, the commit applies to all
@@ -3839,17 +990,6 @@ export declare namespace ContractGetEditHistoryResponse {
                  * applicable_product_tags are not provided, the commit applies to all products.
                  */
                 applicable_product_tags?: Array<string> | null;
-                description?: string;
-                /**
-                 * Specify the name of the line item for the threshold charge. If left blank, it
-                 * will default to the commit product name.
-                 */
-                name?: string;
-                /**
-                 * The commit product that will be used to generate the line item for commit
-                 * payment.
-                 */
-                product_id?: string;
                 /**
                  * List of filters that determine what kind of customer usage draws down a commit
                  * or credit. A customer's usage needs to meet the condition of at least one of the
@@ -3858,82 +998,7 @@ export declare namespace ContractGetEditHistoryResponse {
                  * Instead, to target usage by product or product tag, pass those values in the
                  * body of `specifiers`.
                  */
-                specifiers?: Array<Commit.Specifier> | null;
-            }
-            namespace Commit {
-                interface Specifier {
-                    presentation_group_values?: {
-                        [key: string]: string;
-                    };
-                    pricing_group_values?: {
-                        [key: string]: string;
-                    };
-                    /**
-                     * If provided, the specifier will only apply to the product with the specified ID.
-                     */
-                    product_id?: string;
-                    /**
-                     * If provided, the specifier will only apply to products with all the specified
-                     * tags.
-                     */
-                    product_tags?: Array<string>;
-                }
-            }
-            interface PaymentGateConfig {
-                /**
-                 * Gate access to the commit balance based on successful collection of payment.
-                 * Select STRIPE for Metronome to facilitate payment via Stripe. Select EXTERNAL to
-                 * facilitate payment using your own payment integration. Select NONE if you do not
-                 * wish to payment gate the commit balance.
-                 */
-                payment_gate_type: 'NONE' | 'STRIPE' | 'EXTERNAL';
-                /**
-                 * Only applicable if using PRECALCULATED as your tax type.
-                 */
-                precalculated_tax_config?: PaymentGateConfig.PrecalculatedTaxConfig;
-                /**
-                 * Only applicable if using STRIPE as your payment gateway type.
-                 */
-                stripe_config?: PaymentGateConfig.StripeConfig;
-                /**
-                 * Stripe tax is only supported for Stripe payment gateway. Select NONE if you do
-                 * not wish Metronome to calculate tax on your behalf. Leaving this field blank
-                 * will default to NONE.
-                 */
-                tax_type?: 'NONE' | 'STRIPE' | 'ANROK' | 'PRECALCULATED';
-            }
-            namespace PaymentGateConfig {
-                /**
-                 * Only applicable if using PRECALCULATED as your tax type.
-                 */
-                interface PrecalculatedTaxConfig {
-                    /**
-                     * Amount of tax to be applied. This should be in the same currency and
-                     * denomination as the commit's invoice schedule
-                     */
-                    tax_amount: number;
-                    /**
-                     * Name of the tax to be applied. This may be used in an invoice line item
-                     * description.
-                     */
-                    tax_name?: string;
-                }
-                /**
-                 * Only applicable if using STRIPE as your payment gateway type.
-                 */
-                interface StripeConfig {
-                    /**
-                     * If left blank, will default to INVOICE
-                     */
-                    payment_type: 'INVOICE' | 'PAYMENT_INTENT';
-                    /**
-                     * Metadata to be added to the Stripe invoice. Only applicable if using INVOICE as
-                     * your payment type.
-                     */
-                    invoice_metadata?: {
-                        [key: string]: string;
-                    };
-                }
+                specifiers?: Array<Shared.CommitSpecifierInput> | null;
             }
         }
         interface UpdateRecurringCommit {
@@ -3999,91 +1064,20 @@ export declare namespace ContractGetEditHistoryResponse {
             }
         }
         interface UpdateSpendThresholdConfiguration {
-            commit?: UpdateSpendThresholdConfiguration.Commit;
+            commit?: Shared.UpdateBaseThresholdCommit;
             /**
              * When set to false, the contract will not be evaluated against the
              * threshold_amount. Toggling to true will result an immediate evaluation,
              * regardless of prior state.
              */
             is_enabled?: boolean;
-            payment_gate_config?: UpdateSpendThresholdConfiguration.PaymentGateConfig;
+            payment_gate_config?: Shared.PaymentGateConfigV2;
             /**
              * Specify the threshold amount for the contract. Each time the contract's usage
              * hits this amount, a threshold charge will be initiated.
              */
             threshold_amount?: number;
         }
-        namespace UpdateSpendThresholdConfiguration {
-            interface Commit {
-                description?: string;
-                /**
-                 * Specify the name of the line item for the threshold charge. If left blank, it
-                 * will default to the commit product name.
-                 */
-                name?: string;
-                /**
-                 * The commit product that will be used to generate the line item for commit
-                 * payment.
-                 */
-                product_id?: string;
-            }
-            interface PaymentGateConfig {
-                /**
-                 * Gate access to the commit balance based on successful collection of payment.
-                 * Select STRIPE for Metronome to facilitate payment via Stripe. Select EXTERNAL to
-                 * facilitate payment using your own payment integration. Select NONE if you do not
-                 * wish to payment gate the commit balance.
-                 */
-                payment_gate_type: 'NONE' | 'STRIPE' | 'EXTERNAL';
-                /**
-                 * Only applicable if using PRECALCULATED as your tax type.
-                 */
-                precalculated_tax_config?: PaymentGateConfig.PrecalculatedTaxConfig;
-                /**
-                 * Only applicable if using STRIPE as your payment gateway type.
-                 */
-                stripe_config?: PaymentGateConfig.StripeConfig;
-                /**
-                 * Stripe tax is only supported for Stripe payment gateway. Select NONE if you do
-                 * not wish Metronome to calculate tax on your behalf. Leaving this field blank
-                 * will default to NONE.
-                 */
-                tax_type?: 'NONE' | 'STRIPE' | 'ANROK' | 'PRECALCULATED';
-            }
-            namespace PaymentGateConfig {
-                /**
-                 * Only applicable if using PRECALCULATED as your tax type.
-                 */
-                interface PrecalculatedTaxConfig {
-                    /**
-                     * Amount of tax to be applied. This should be in the same currency and
-                     * denomination as the commit's invoice schedule
-                     */
-                    tax_amount: number;
-                    /**
-                     * Name of the tax to be applied. This may be used in an invoice line item
-                     * description.
-                     */
-                    tax_name?: string;
-                }
-                /**
-                 * Only applicable if using STRIPE as your payment gateway type.
-                 */
-                interface StripeConfig {
-                    /**
-                     * If left blank, will default to INVOICE
-                     */
-                    payment_type: 'INVOICE' | 'PAYMENT_INTENT';
-                    /**
-                     * Metadata to be added to the Stripe invoice. Only applicable if using INVOICE as
-                     * your payment type.
-                     */
-                    invoice_metadata?: {
-                        [key: string]: string;
-                    };
-                }
-            }
-        }
         interface UpdateSubscription {
             id: string;
             ending_before?: string;
@@ -4157,7 +1151,7 @@ export interface ContractEditParams {
     add_credits?: Array<ContractEditParams.AddCredit>;
     add_discounts?: Array<ContractEditParams.AddDiscount>;
     add_overrides?: Array<ContractEditParams.AddOverride>;
-    add_prepaid_balance_threshold_configuration?: ContractEditParams.AddPrepaidBalanceThresholdConfiguration;
+    add_prepaid_balance_threshold_configuration?: Shared.PrepaidBalanceThresholdConfigurationV2;
     /**
      * This field's availability is dependent on your client's configuration.
      */
@@ -4166,7 +1160,7 @@ export interface ContractEditParams {
     add_recurring_credits?: Array<ContractEditParams.AddRecurringCredit>;
     add_reseller_royalties?: Array<ContractEditParams.AddResellerRoyalty>;
     add_scheduled_charges?: Array<ContractEditParams.AddScheduledCharge>;
-    add_spend_threshold_configuration?: ContractEditParams.AddSpendThresholdConfiguration;
+    add_spend_threshold_configuration?: Shared.SpendThresholdConfigurationV2;
     /**
      * Optional list of
      * [subscriptions](https://docs.metronome.com/manage-product-access/create-subscription/)
@@ -4196,6 +1190,10 @@ export interface ContractEditParams {
      * IDs of overrides to remove
      */
     remove_overrides?: Array<ContractEditParams.RemoveOverride>;
+    /**
+     * Optional uniqueness key to prevent duplicate contract edits.
+     */
+    uniqueness_key?: string;
     update_commits?: Array<ContractEditParams.UpdateCommit>;
     /**
      * RFC 3339 timestamp indicating when the contract will end (exclusive).
@@ -4253,6 +1251,9 @@ export declare namespace ContractEditParams {
          * all products.
          */
         applicable_product_tags?: Array<string>;
+        /**
+         * Custom fields to be added eg. { "key1": "value1", "key2": "value2" }
+         */
         custom_fields?: {
             [key: string]: string;
         };
@@ -4263,7 +1264,7 @@ export declare namespace ContractEditParams {
         /**
          * Optional configuration for commit hierarchy access control
          */
-        hierarchy_configuration?: AddCommit.HierarchyConfiguration;
+        hierarchy_configuration?: Shared.CommitHierarchyConfiguration;
         /**
          * Required for "POSTPAID" commits: the true up invoice will be generated at this
          * time and only one schedule item is allowed; the total must match access_schedule
@@ -4301,7 +1302,7 @@ export declare namespace ContractEditParams {
          * Instead, to target usage by product or product tag, pass those values in the
          * body of `specifiers`.
          */
-        specifiers?: Array<AddCommit.Specifier>;
+        specifiers?: Array<Shared.CommitSpecifierInput>;
         /**
          * A temporary ID for the commit that can be used to reference the commit for
          * commit specific overrides.
@@ -4331,24 +1332,6 @@ export declare namespace ContractEditParams {
                 starting_at: string;
             }
         }
-        /**
-         * Optional configuration for commit hierarchy access control
-         */
-        interface HierarchyConfiguration {
-            child_access: HierarchyConfiguration.CommitHierarchyChildAccessAll | HierarchyConfiguration.CommitHierarchyChildAccessNone | HierarchyConfiguration.CommitHierarchyChildAccessContractIDs;
-        }
-        namespace HierarchyConfiguration {
-            interface CommitHierarchyChildAccessAll {
-                type: 'ALL';
-            }
-            interface CommitHierarchyChildAccessNone {
-                type: 'NONE';
-            }
-            interface CommitHierarchyChildAccessContractIDs {
-                contract_ids: Array<string>;
-                type: 'CONTRACT_IDS';
-            }
-        }
         /**
          * Required for "POSTPAID" commits: the true up invoice will be generated at this
          * time and only one schedule item is allowed; the total must match access_schedule
@@ -4507,23 +1490,6 @@ export declare namespace ContractEditParams {
                 on_session_payment?: boolean;
             }
         }
-        interface Specifier {
-            presentation_group_values?: {
-                [key: string]: string;
-            };
-            pricing_group_values?: {
-                [key: string]: string;
-            };
-            /**
-             * If provided, the specifier will only apply to the product with the specified ID.
-             */
-            product_id?: string;
-            /**
-             * If provided, the specifier will only apply to products with all the specified
-             * tags.
-             */
-            product_tags?: Array<string>;
-        }
     }
     interface AddCredit {
         /**
@@ -4541,6 +1507,9 @@ export declare namespace ContractEditParams {
          * applicable_product_tags are not provided, the credit applies to all products.
          */
         applicable_product_tags?: Array<string>;
+        /**
+         * Custom fields to be added eg. { "key1": "value1", "key2": "value2" }
+         */
         custom_fields?: {
             [key: string]: string;
         };
@@ -4551,7 +1520,7 @@ export declare namespace ContractEditParams {
         /**
          * Optional configuration for credit hierarchy access control
          */
-        hierarchy_configuration?: AddCredit.HierarchyConfiguration;
+        hierarchy_configuration?: Shared.CommitHierarchyConfiguration;
         /**
          * displayed on invoices
          */
@@ -4574,7 +1543,7 @@ export declare namespace ContractEditParams {
          * Instead, to target usage by product or product tag, pass those values in the
          * body of `specifiers`.
          */
-        specifiers?: Array<AddCredit.Specifier>;
+        specifiers?: Array<Shared.CommitSpecifierInput>;
     }
     namespace AddCredit {
         /**
@@ -4597,41 +1566,6 @@ export declare namespace ContractEditParams {
                 starting_at: string;
             }
         }
-        /**
-         * Optional configuration for credit hierarchy access control
-         */
-        interface HierarchyConfiguration {
-            child_access: HierarchyConfiguration.CommitHierarchyChildAccessAll | HierarchyConfiguration.CommitHierarchyChildAccessNone | HierarchyConfiguration.CommitHierarchyChildAccessContractIDs;
-        }
-        namespace HierarchyConfiguration {
-            interface CommitHierarchyChildAccessAll {
-                type: 'ALL';
-            }
-            interface CommitHierarchyChildAccessNone {
-                type: 'NONE';
-            }
-            interface CommitHierarchyChildAccessContractIDs {
-                contract_ids: Array<string>;
-                type: 'CONTRACT_IDS';
-            }
-        }
-        interface Specifier {
-            presentation_group_values?: {
-                [key: string]: string;
-            };
-            pricing_group_values?: {
-                [key: string]: string;
-            };
-            /**
-             * If provided, the specifier will only apply to the product with the specified ID.
-             */
-            product_id?: string;
-            /**
-             * If provided, the specifier will only apply to products with all the specified
-             * tags.
-             */
-            product_tags?: Array<string>;
-        }
     }
     interface AddDiscount {
         product_id: string;
@@ -4639,6 +1573,9 @@ export declare namespace ContractEditParams {
          * Must provide either schedule_items or recurring_schedule.
          */
         schedule: AddDiscount.Schedule;
+        /**
+         * Custom fields to be added eg. { "key1": "value1", "key2": "value2" }
+         */
         custom_fields?: {
             [key: string]: string;
         };
@@ -4824,197 +1761,62 @@ export declare namespace ContractEditParams {
             /**
              * If provided, the override will only apply to the product with the specified ID.
              */
-            product_id?: string;
-            /**
-             * If provided, the override will only apply to products with all the specified
-             * tags.
-             */
-            product_tags?: Array<string>;
-            /**
-             * Can only be used for commit specific overrides. Must be used in conjunction with
-             * one of product_id, product_tags, pricing_group_values, or
-             * presentation_group_values. If provided, the override will only apply to commits
-             * created by the specified recurring commit ids.
-             */
-            recurring_commit_ids?: Array<string>;
-            /**
-             * Can only be used for commit specific overrides. Must be used in conjunction with
-             * one of product_id, product_tags, pricing_group_values, or
-             * presentation_group_values. If provided, the override will only apply to commits
-             * created by the specified recurring credit ids.
-             */
-            recurring_credit_ids?: Array<string>;
-        }
-        /**
-         * Required for OVERWRITE type.
-         */
-        interface OverwriteRate {
-            rate_type: 'FLAT' | 'PERCENTAGE' | 'SUBSCRIPTION' | 'TIERED' | 'CUSTOM';
-            credit_type_id?: string;
-            /**
-             * Only set for CUSTOM rate_type. This field is interpreted by custom rate
-             * processors.
-             */
-            custom_rate?: {
-                [key: string]: unknown;
-            };
-            /**
-             * Default proration configuration. Only valid for SUBSCRIPTION rate_type. Must be
-             * set to true.
-             */
-            is_prorated?: boolean;
-            /**
-             * Default price. For FLAT rate_type, this must be >=0. For PERCENTAGE rate_type,
-             * this is a decimal fraction, e.g. use 0.1 for 10%; this must be >=0 and <=1.
-             */
-            price?: number;
-            /**
-             * Default quantity. For SUBSCRIPTION rate_type, this must be >=0.
-             */
-            quantity?: number;
-            /**
-             * Only set for TIERED rate_type.
-             */
-            tiers?: Array<Shared.Tier>;
-        }
-        interface Tier {
-            multiplier: number;
-            size?: number;
-        }
-    }
-    interface AddPrepaidBalanceThresholdConfiguration {
-        commit: AddPrepaidBalanceThresholdConfiguration.Commit;
-        /**
-         * When set to false, the contract will not be evaluated against the
-         * threshold_amount. Toggling to true will result an immediate evaluation,
-         * regardless of prior state.
-         */
-        is_enabled: boolean;
-        payment_gate_config: AddPrepaidBalanceThresholdConfiguration.PaymentGateConfig;
-        /**
-         * Specify the amount the balance should be recharged to.
-         */
-        recharge_to_amount: number;
-        /**
-         * Specify the threshold amount for the contract. Each time the contract's balance
-         * lowers to this amount, a threshold charge will be initiated.
-         */
-        threshold_amount: number;
-        /**
-         * If provided, the threshold, recharge-to amount, and the resulting threshold
-         * commit amount will be in terms of this credit type instead of the fiat currency.
-         */
-        custom_credit_type_id?: string;
-    }
-    namespace AddPrepaidBalanceThresholdConfiguration {
-        interface Commit {
-            /**
-             * The commit product that will be used to generate the line item for commit
-             * payment.
-             */
-            product_id: string;
-            /**
-             * Which products the threshold commit applies to. If applicable_product_ids,
-             * applicable_product_tags or specifiers are not provided, the commit applies to
-             * all products.
-             */
-            applicable_product_ids?: Array<string>;
-            /**
-             * Which tags the threshold commit applies to. If applicable_product_ids,
-             * applicable_product_tags or specifiers are not provided, the commit applies to
-             * all products.
-             */
-            applicable_product_tags?: Array<string>;
-            description?: string;
+            product_id?: string;
             /**
-             * Specify the name of the line item for the threshold charge. If left blank, it
-             * will default to the commit product name.
+             * If provided, the override will only apply to products with all the specified
+             * tags.
              */
-            name?: string;
+            product_tags?: Array<string>;
             /**
-             * List of filters that determine what kind of customer usage draws down a commit
-             * 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. This field cannot
-             * be used together with `applicable_product_ids` or `applicable_product_tags`.
-             * Instead, to target usage by product or product tag, pass those values in the
-             * body of `specifiers`.
+             * Can only be used for commit specific overrides. Must be used in conjunction with
+             * one of product_id, product_tags, pricing_group_values, or
+             * presentation_group_values. If provided, the override will only apply to commits
+             * created by the specified recurring commit ids.
              */
-            specifiers?: Array<Commit.Specifier>;
-        }
-        namespace Commit {
-            interface Specifier {
-                presentation_group_values?: {
-                    [key: string]: string;
-                };
-                pricing_group_values?: {
-                    [key: string]: string;
-                };
-                /**
-                 * If provided, the specifier will only apply to the product with the specified ID.
-                 */
-                product_id?: string;
-                /**
-                 * If provided, the specifier will only apply to products with all the specified
-                 * tags.
-                 */
-                product_tags?: Array<string>;
-            }
-        }
-        interface PaymentGateConfig {
+            recurring_commit_ids?: Array<string>;
             /**
-             * Gate access to the commit balance based on successful collection of payment.
-             * Select STRIPE for Metronome to facilitate payment via Stripe. Select EXTERNAL to
-             * facilitate payment using your own payment integration. Select NONE if you do not
-             * wish to payment gate the commit balance.
+             * Can only be used for commit specific overrides. Must be used in conjunction with
+             * one of product_id, product_tags, pricing_group_values, or
+             * presentation_group_values. If provided, the override will only apply to commits
+             * created by the specified recurring credit ids.
              */
-            payment_gate_type: 'NONE' | 'STRIPE' | 'EXTERNAL';
+            recurring_credit_ids?: Array<string>;
+        }
+        /**
+         * Required for OVERWRITE type.
+         */
+        interface OverwriteRate {
+            rate_type: 'FLAT' | 'PERCENTAGE' | 'SUBSCRIPTION' | 'TIERED' | 'CUSTOM';
+            credit_type_id?: string;
             /**
-             * Only applicable if using PRECALCULATED as your tax type.
+             * Only set for CUSTOM rate_type. This field is interpreted by custom rate
+             * processors.
              */
-            precalculated_tax_config?: PaymentGateConfig.PrecalculatedTaxConfig;
+            custom_rate?: {
+                [key: string]: unknown;
+            };
             /**
-             * Only applicable if using STRIPE as your payment gateway type.
+             * Default proration configuration. Only valid for SUBSCRIPTION rate_type. Must be
+             * set to true.
              */
-            stripe_config?: PaymentGateConfig.StripeConfig;
+            is_prorated?: boolean;
             /**
-             * Stripe tax is only supported for Stripe payment gateway. Select NONE if you do
-             * not wish Metronome to calculate tax on your behalf. Leaving this field blank
-             * will default to NONE.
+             * Default price. For FLAT rate_type, this must be >=0. For PERCENTAGE rate_type,
+             * this is a decimal fraction, e.g. use 0.1 for 10%; this must be >=0 and <=1.
              */
-            tax_type?: 'NONE' | 'STRIPE' | 'ANROK' | 'PRECALCULATED';
-        }
-        namespace PaymentGateConfig {
+            price?: number;
             /**
-             * Only applicable if using PRECALCULATED as your tax type.
+             * Default quantity. For SUBSCRIPTION rate_type, this must be >=0.
              */
-            interface PrecalculatedTaxConfig {
-                /**
-                 * Amount of tax to be applied. This should be in the same currency and
-                 * denomination as the commit's invoice schedule
-                 */
-                tax_amount: number;
-                /**
-                 * Name of the tax to be applied. This may be used in an invoice line item
-                 * description.
-                 */
-                tax_name?: string;
-            }
+            quantity?: number;
             /**
-             * Only applicable if using STRIPE as your payment gateway type.
+             * Only set for TIERED rate_type.
              */
-            interface StripeConfig {
-                /**
-                 * If left blank, will default to INVOICE
-                 */
-                payment_type: 'INVOICE' | 'PAYMENT_INTENT';
-                /**
-                 * Metadata to be added to the Stripe invoice. Only applicable if using INVOICE as
-                 * your payment type.
-                 */
-                invoice_metadata?: {
-                    [key: string]: string;
-                };
-            }
+            tiers?: Array<Shared.Tier>;
+        }
+        interface Tier {
+            multiplier: number;
+            size?: number;
         }
     }
     interface AddProfessionalService {
@@ -5033,6 +1835,9 @@ export declare namespace ContractEditParams {
          * amount and must be specified.
          */
         unit_price: number;
+        /**
+         * Custom fields to be added eg. { "key1": "value1", "key2": "value2" }
+         */
         custom_fields?: {
             [key: string]: string;
         };
@@ -5081,7 +1886,7 @@ export declare namespace ContractEditParams {
         /**
          * Optional configuration for recurring credit hierarchy access control
          */
-        hierarchy_configuration?: AddRecurringCommit.HierarchyConfiguration;
+        hierarchy_configuration?: Shared.CommitHierarchyConfiguration;
         /**
          * The amount the customer should be billed for the commit. Not required.
          */
@@ -5125,7 +1930,7 @@ export declare namespace ContractEditParams {
          * Instead, to target usage by product or product tag, pass those values in the
          * body of `specifiers`.
          */
-        specifiers?: Array<AddRecurringCommit.Specifier>;
+        specifiers?: Array<Shared.CommitSpecifierInput>;
         /**
          * Attach a subscription to the recurring commit/credit.
          */
@@ -5158,24 +1963,6 @@ export declare namespace ContractEditParams {
             value: number;
             unit?: 'PERIODS';
         }
-        /**
-         * Optional configuration for recurring credit hierarchy access control
-         */
-        interface HierarchyConfiguration {
-            child_access: HierarchyConfiguration.CommitHierarchyChildAccessAll | HierarchyConfiguration.CommitHierarchyChildAccessNone | HierarchyConfiguration.CommitHierarchyChildAccessContractIDs;
-        }
-        namespace HierarchyConfiguration {
-            interface CommitHierarchyChildAccessAll {
-                type: 'ALL';
-            }
-            interface CommitHierarchyChildAccessNone {
-                type: 'NONE';
-            }
-            interface CommitHierarchyChildAccessContractIDs {
-                contract_ids: Array<string>;
-                type: 'CONTRACT_IDS';
-            }
-        }
         /**
          * The amount the customer should be billed for the commit. Not required.
          */
@@ -5184,23 +1971,6 @@ export declare namespace ContractEditParams {
             quantity: number;
             unit_price: number;
         }
-        interface Specifier {
-            presentation_group_values?: {
-                [key: string]: string;
-            };
-            pricing_group_values?: {
-                [key: string]: string;
-            };
-            /**
-             * If provided, the specifier will only apply to the product with the specified ID.
-             */
-            product_id?: string;
-            /**
-             * If provided, the specifier will only apply to products with all the specified
-             * tags.
-             */
-            product_tags?: Array<string>;
-        }
         /**
          * Attach a subscription to the recurring commit/credit.
          */
@@ -5213,7 +1983,7 @@ export declare namespace ContractEditParams {
             /**
              * If set to POOLED, allocation added per seat is pooled across the account.
              */
-            allocation?: 'POOLED';
+            allocation?: 'POOLED' | 'INDIVIDUAL';
         }
         namespace SubscriptionConfig {
             interface ApplySeatIncreaseConfig {
@@ -5263,7 +2033,7 @@ export declare namespace ContractEditParams {
         /**
          * Optional configuration for recurring credit hierarchy access control
          */
-        hierarchy_configuration?: AddRecurringCredit.HierarchyConfiguration;
+        hierarchy_configuration?: Shared.CommitHierarchyConfiguration;
         /**
          * displayed on invoices. will be passed through to the individual commits
          */
@@ -5303,7 +2073,7 @@ export declare namespace ContractEditParams {
          * Instead, to target usage by product or product tag, pass those values in the
          * body of `specifiers`.
          */
-        specifiers?: Array<AddRecurringCredit.Specifier>;
+        specifiers?: Array<Shared.CommitSpecifierInput>;
         /**
          * Attach a subscription to the recurring commit/credit.
          */
@@ -5336,41 +2106,6 @@ export declare namespace ContractEditParams {
             value: number;
             unit?: 'PERIODS';
         }
-        /**
-         * Optional configuration for recurring credit hierarchy access control
-         */
-        interface HierarchyConfiguration {
-            child_access: HierarchyConfiguration.CommitHierarchyChildAccessAll | HierarchyConfiguration.CommitHierarchyChildAccessNone | HierarchyConfiguration.CommitHierarchyChildAccessContractIDs;
-        }
-        namespace HierarchyConfiguration {
-            interface CommitHierarchyChildAccessAll {
-                type: 'ALL';
-            }
-            interface CommitHierarchyChildAccessNone {
-                type: 'NONE';
-            }
-            interface CommitHierarchyChildAccessContractIDs {
-                contract_ids: Array<string>;
-                type: 'CONTRACT_IDS';
-            }
-        }
-        interface Specifier {
-            presentation_group_values?: {
-                [key: string]: string;
-            };
-            pricing_group_values?: {
-                [key: string]: string;
-            };
-            /**
-             * If provided, the specifier will only apply to the product with the specified ID.
-             */
-            product_id?: string;
-            /**
-             * If provided, the specifier will only apply to products with all the specified
-             * tags.
-             */
-            product_tags?: Array<string>;
-        }
         /**
          * Attach a subscription to the recurring commit/credit.
          */
@@ -5383,7 +2118,7 @@ export declare namespace ContractEditParams {
             /**
              * If set to POOLED, allocation added per seat is pooled across the account.
              */
-            allocation?: 'POOLED';
+            allocation?: 'POOLED' | 'INDIVIDUAL';
         }
         namespace SubscriptionConfig {
             interface ApplySeatIncreaseConfig {
@@ -5432,6 +2167,9 @@ export declare namespace ContractEditParams {
          * Must provide either schedule_items or recurring_schedule.
          */
         schedule: AddScheduledCharge.Schedule;
+        /**
+         * Custom fields to be added eg. { "key1": "value1", "key2": "value2" }
+         */
         custom_fields?: {
             [key: string]: string;
         };
@@ -5472,156 +2210,72 @@ export declare namespace ContractEditParams {
         namespace Schedule {
             /**
              * Enter the unit price and quantity for the charge or instead only send the
-             * amount. If amount is sent, the unit price is assumed to be the amount and
-             * quantity is inferred to be 1.
-             */
-            interface RecurringSchedule {
-                amount_distribution: 'DIVIDED' | 'DIVIDED_ROUNDED' | 'EACH';
-                /**
-                 * RFC 3339 timestamp (exclusive).
-                 */
-                ending_before: string;
-                frequency: 'MONTHLY' | 'QUARTERLY' | 'SEMI_ANNUAL' | 'ANNUAL' | 'WEEKLY';
-                /**
-                 * RFC 3339 timestamp (inclusive).
-                 */
-                starting_at: string;
-                /**
-                 * Amount for the charge. Can be provided instead of unit_price and quantity. If
-                 * amount is sent, the unit_price is assumed to be the amount and quantity is
-                 * inferred to be 1.
-                 */
-                amount?: number;
-                /**
-                 * Quantity for the charge. Will be multiplied by unit_price to determine the
-                 * amount and must be specified with unit_price. If specified amount cannot be
-                 * provided.
-                 */
-                quantity?: number;
-                /**
-                 * Unit price for the charge. Will be multiplied by quantity to determine the
-                 * amount and must be specified with quantity. If specified amount cannot be
-                 * provided.
-                 */
-                unit_price?: number;
-            }
-            interface ScheduleItem {
-                /**
-                 * timestamp of the scheduled event
-                 */
-                timestamp: string;
-                /**
-                 * Amount for the charge. Can be provided instead of unit_price and quantity. If
-                 * amount is sent, the unit_price is assumed to be the amount and quantity is
-                 * inferred to be 1.
-                 */
-                amount?: number;
-                /**
-                 * Quantity for the charge. Will be multiplied by unit_price to determine the
-                 * amount and must be specified with unit_price. If specified amount cannot be
-                 * provided.
-                 */
-                quantity?: number;
-                /**
-                 * Unit price for the charge. Will be multiplied by quantity to determine the
-                 * amount and must be specified with quantity. If specified amount cannot be
-                 * provided.
-                 */
-                unit_price?: number;
-            }
-        }
-    }
-    interface AddSpendThresholdConfiguration {
-        commit: AddSpendThresholdConfiguration.Commit;
-        /**
-         * When set to false, the contract will not be evaluated against the
-         * threshold_amount. Toggling to true will result an immediate evaluation,
-         * regardless of prior state.
-         */
-        is_enabled: boolean;
-        payment_gate_config: AddSpendThresholdConfiguration.PaymentGateConfig;
-        /**
-         * Specify the threshold amount for the contract. Each time the contract's usage
-         * hits this amount, a threshold charge will be initiated.
-         */
-        threshold_amount: number;
-    }
-    namespace AddSpendThresholdConfiguration {
-        interface Commit {
-            /**
-             * The commit product that will be used to generate the line item for commit
-             * payment.
-             */
-            product_id: string;
-            description?: string;
-            /**
-             * Specify the name of the line item for the threshold charge. If left blank, it
-             * will default to the commit product name.
-             */
-            name?: string;
-        }
-        interface PaymentGateConfig {
-            /**
-             * Gate access to the commit balance based on successful collection of payment.
-             * Select STRIPE for Metronome to facilitate payment via Stripe. Select EXTERNAL to
-             * facilitate payment using your own payment integration. Select NONE if you do not
-             * wish to payment gate the commit balance.
-             */
-            payment_gate_type: 'NONE' | 'STRIPE' | 'EXTERNAL';
-            /**
-             * Only applicable if using PRECALCULATED as your tax type.
-             */
-            precalculated_tax_config?: PaymentGateConfig.PrecalculatedTaxConfig;
-            /**
-             * Only applicable if using STRIPE as your payment gateway type.
-             */
-            stripe_config?: PaymentGateConfig.StripeConfig;
-            /**
-             * Stripe tax is only supported for Stripe payment gateway. Select NONE if you do
-             * not wish Metronome to calculate tax on your behalf. Leaving this field blank
-             * will default to NONE.
-             */
-            tax_type?: 'NONE' | 'STRIPE' | 'ANROK' | 'PRECALCULATED';
-        }
-        namespace PaymentGateConfig {
-            /**
-             * Only applicable if using PRECALCULATED as your tax type.
+             * amount. If amount is sent, the unit price is assumed to be the amount and
+             * quantity is inferred to be 1.
              */
-            interface PrecalculatedTaxConfig {
+            interface RecurringSchedule {
+                amount_distribution: 'DIVIDED' | 'DIVIDED_ROUNDED' | 'EACH';
                 /**
-                 * Amount of tax to be applied. This should be in the same currency and
-                 * denomination as the commit's invoice schedule
+                 * RFC 3339 timestamp (exclusive).
                  */
-                tax_amount: number;
+                ending_before: string;
+                frequency: 'MONTHLY' | 'QUARTERLY' | 'SEMI_ANNUAL' | 'ANNUAL' | 'WEEKLY';
                 /**
-                 * Name of the tax to be applied. This may be used in an invoice line item
-                 * description.
+                 * RFC 3339 timestamp (inclusive).
                  */
-                tax_name?: string;
+                starting_at: string;
+                /**
+                 * Amount for the charge. Can be provided instead of unit_price and quantity. If
+                 * amount is sent, the unit_price is assumed to be the amount and quantity is
+                 * inferred to be 1.
+                 */
+                amount?: number;
+                /**
+                 * Quantity for the charge. Will be multiplied by unit_price to determine the
+                 * amount and must be specified with unit_price. If specified amount cannot be
+                 * provided.
+                 */
+                quantity?: number;
+                /**
+                 * Unit price for the charge. Will be multiplied by quantity to determine the
+                 * amount and must be specified with quantity. If specified amount cannot be
+                 * provided.
+                 */
+                unit_price?: number;
             }
-            /**
-             * Only applicable if using STRIPE as your payment gateway type.
-             */
-            interface StripeConfig {
+            interface ScheduleItem {
                 /**
-                 * If left blank, will default to INVOICE
+                 * timestamp of the scheduled event
                  */
-                payment_type: 'INVOICE' | 'PAYMENT_INTENT';
+                timestamp: string;
                 /**
-                 * Metadata to be added to the Stripe invoice. Only applicable if using INVOICE as
-                 * your payment type.
+                 * Amount for the charge. Can be provided instead of unit_price and quantity. If
+                 * amount is sent, the unit_price is assumed to be the amount and quantity is
+                 * inferred to be 1.
                  */
-                invoice_metadata?: {
-                    [key: string]: string;
-                };
+                amount?: number;
+                /**
+                 * Quantity for the charge. Will be multiplied by unit_price to determine the
+                 * amount and must be specified with unit_price. If specified amount cannot be
+                 * provided.
+                 */
+                quantity?: number;
+                /**
+                 * Unit price for the charge. Will be multiplied by quantity to determine the
+                 * amount and must be specified with quantity. If specified amount cannot be
+                 * provided.
+                 */
+                unit_price?: number;
             }
         }
     }
     interface AddSubscription {
         collection_schedule: 'ADVANCE' | 'ARREARS';
-        initial_quantity: number;
         proration: AddSubscription.Proration;
         subscription_rate: AddSubscription.SubscriptionRate;
+        /**
+         * Custom fields to be added eg. { "key1": "value1", "key2": "value2" }
+         */
         custom_fields?: {
             [key: string]: string;
         };
@@ -5631,7 +2285,19 @@ export declare namespace ContractEditParams {
          * contract end date.
          */
         ending_before?: string;
+        /**
+         * The initial quantity for the subscription. It must be non-negative value.
+         * Required if quantity_management_mode is QUANTITY_ONLY.
+         */
+        initial_quantity?: number;
         name?: string;
+        /**
+         * 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.
+         */
+        quantity_management_mode?: 'SEAT_BASED' | 'QUANTITY_ONLY';
         /**
          * Inclusive start time for the subscription. If not provided, defaults to contract
          * start date
@@ -5700,11 +2366,17 @@ export declare namespace ContractEditParams {
         /**
          * Optional configuration for commit hierarchy access control
          */
-        hierarchy_configuration?: UpdateCommit.HierarchyConfiguration;
+        hierarchy_configuration?: Shared.CommitHierarchyConfiguration;
         invoice_schedule?: UpdateCommit.InvoiceSchedule;
         netsuite_sales_order_id?: string | null;
         priority?: number | null;
         product_id?: string;
+        /**
+         * If provided, updates the commit to use the specified rate type for current and
+         * future invoices. Previously finalized invoices will need to be voided and
+         * regenerated to reflect the rate type change.
+         */
+        rate_type?: 'LIST_RATE' | 'COMMIT_RATE';
         rollover_fraction?: number | null;
     }
     namespace UpdateCommit {
@@ -5729,24 +2401,6 @@ export declare namespace ContractEditParams {
                 starting_at?: string;
             }
         }
-        /**
-         * Optional configuration for commit hierarchy access control
-         */
-        interface HierarchyConfiguration {
-            child_access: HierarchyConfiguration.CommitHierarchyChildAccessAll | HierarchyConfiguration.CommitHierarchyChildAccessNone | HierarchyConfiguration.CommitHierarchyChildAccessContractIDs;
-        }
-        namespace HierarchyConfiguration {
-            interface CommitHierarchyChildAccessAll {
-                type: 'ALL';
-            }
-            interface CommitHierarchyChildAccessNone {
-                type: 'NONE';
-            }
-            interface CommitHierarchyChildAccessContractIDs {
-                contract_ids: Array<string>;
-                type: 'CONTRACT_IDS';
-            }
-        }
         interface InvoiceSchedule {
             add_schedule_items?: Array<InvoiceSchedule.AddScheduleItem>;
             remove_schedule_items?: Array<InvoiceSchedule.RemoveScheduleItem>;
@@ -5789,10 +2443,16 @@ export declare namespace ContractEditParams {
         /**
          * Optional configuration for commit hierarchy access control
          */
-        hierarchy_configuration?: UpdateCredit.HierarchyConfiguration;
+        hierarchy_configuration?: Shared.CommitHierarchyConfiguration;
         netsuite_sales_order_id?: string | null;
         priority?: number | null;
         product_id?: string;
+        /**
+         * If provided, updates the credit to use the specified rate type for current and
+         * future invoices. Previously finalized invoices will need to be voided and
+         * regenerated to reflect the rate type change.
+         */
+        rate_type?: 'LIST_RATE' | 'COMMIT_RATE';
     }
     namespace UpdateCredit {
         interface AccessSchedule {
@@ -5816,24 +2476,6 @@ export declare namespace ContractEditParams {
                 starting_at?: string;
             }
         }
-        /**
-         * Optional configuration for commit hierarchy access control
-         */
-        interface HierarchyConfiguration {
-            child_access: HierarchyConfiguration.CommitHierarchyChildAccessAll | HierarchyConfiguration.CommitHierarchyChildAccessNone | HierarchyConfiguration.CommitHierarchyChildAccessContractIDs;
-        }
-        namespace HierarchyConfiguration {
-            interface CommitHierarchyChildAccessAll {
-                type: 'ALL';
-            }
-            interface CommitHierarchyChildAccessNone {
-                type: 'NONE';
-            }
-            interface CommitHierarchyChildAccessContractIDs {
-                contract_ids: Array<string>;
-                type: 'CONTRACT_IDS';
-            }
-        }
     }
     interface UpdatePrepaidBalanceThresholdConfiguration {
         commit?: UpdatePrepaidBalanceThresholdConfiguration.Commit;
@@ -5848,7 +2490,7 @@ export declare namespace ContractEditParams {
          * regardless of prior state.
          */
         is_enabled?: boolean;
-        payment_gate_config?: UpdatePrepaidBalanceThresholdConfiguration.PaymentGateConfig;
+        payment_gate_config?: Shared.PaymentGateConfigV2;
         /**
          * Specify the amount the balance should be recharged to.
          */
@@ -5860,7 +2502,7 @@ export declare namespace ContractEditParams {
         threshold_amount?: number;
     }
     namespace UpdatePrepaidBalanceThresholdConfiguration {
-        interface Commit {
+        interface Commit extends Shared.UpdateBaseThresholdCommit {
             /**
              * Which products the threshold commit applies to. If both applicable_product_ids
              * and applicable_product_tags are not provided, the commit applies to all
@@ -5872,17 +2514,6 @@ export declare namespace ContractEditParams {
              * applicable_product_tags are not provided, the commit applies to all products.
              */
             applicable_product_tags?: Array<string> | null;
-            description?: string;
-            /**
-             * Specify the name of the line item for the threshold charge. If left blank, it
-             * will default to the commit product name.
-             */
-            name?: string;
-            /**
-             * The commit product that will be used to generate the line item for commit
-             * payment.
-             */
-            product_id?: string;
             /**
              * List of filters that determine what kind of customer usage draws down a commit
              * or credit. A customer's usage needs to meet the condition of at least one of the
@@ -5891,82 +2522,7 @@ export declare namespace ContractEditParams {
              * Instead, to target usage by product or product tag, pass those values in the
              * body of `specifiers`.
              */
-            specifiers?: Array<Commit.Specifier> | null;
-        }
-        namespace Commit {
-            interface Specifier {
-                presentation_group_values?: {
-                    [key: string]: string;
-                };
-                pricing_group_values?: {
-                    [key: string]: string;
-                };
-                /**
-                 * If provided, the specifier will only apply to the product with the specified ID.
-                 */
-                product_id?: string;
-                /**
-                 * If provided, the specifier will only apply to products with all the specified
-                 * tags.
-                 */
-                product_tags?: Array<string>;
-            }
-        }
-        interface PaymentGateConfig {
-            /**
-             * Gate access to the commit balance based on successful collection of payment.
-             * Select STRIPE for Metronome to facilitate payment via Stripe. Select EXTERNAL to
-             * facilitate payment using your own payment integration. Select NONE if you do not
-             * wish to payment gate the commit balance.
-             */
-            payment_gate_type: 'NONE' | 'STRIPE' | 'EXTERNAL';
-            /**
-             * Only applicable if using PRECALCULATED as your tax type.
-             */
-            precalculated_tax_config?: PaymentGateConfig.PrecalculatedTaxConfig;
-            /**
-             * Only applicable if using STRIPE as your payment gateway type.
-             */
-            stripe_config?: PaymentGateConfig.StripeConfig;
-            /**
-             * Stripe tax is only supported for Stripe payment gateway. Select NONE if you do
-             * not wish Metronome to calculate tax on your behalf. Leaving this field blank
-             * will default to NONE.
-             */
-            tax_type?: 'NONE' | 'STRIPE' | 'ANROK' | 'PRECALCULATED';
-        }
-        namespace PaymentGateConfig {
-            /**
-             * Only applicable if using PRECALCULATED as your tax type.
-             */
-            interface PrecalculatedTaxConfig {
-                /**
-                 * Amount of tax to be applied. This should be in the same currency and
-                 * denomination as the commit's invoice schedule
-                 */
-                tax_amount: number;
-                /**
-                 * Name of the tax to be applied. This may be used in an invoice line item
-                 * description.
-                 */
-                tax_name?: string;
-            }
-            /**
-             * Only applicable if using STRIPE as your payment gateway type.
-             */
-            interface StripeConfig {
-                /**
-                 * If left blank, will default to INVOICE
-                 */
-                payment_type: 'INVOICE' | 'PAYMENT_INTENT';
-                /**
-                 * Metadata to be added to the Stripe invoice. Only applicable if using INVOICE as
-                 * your payment type.
-                 */
-                invoice_metadata?: {
-                    [key: string]: string;
-                };
-            }
+            specifiers?: Array<Shared.CommitSpecifierInput> | null;
         }
     }
     interface UpdateRecurringCommit {
@@ -6027,91 +2583,20 @@ export declare namespace ContractEditParams {
         }
     }
     interface UpdateSpendThresholdConfiguration {
-        commit?: UpdateSpendThresholdConfiguration.Commit;
+        commit?: Shared.UpdateBaseThresholdCommit;
         /**
          * When set to false, the contract will not be evaluated against the
          * threshold_amount. Toggling to true will result an immediate evaluation,
          * regardless of prior state.
          */
         is_enabled?: boolean;
-        payment_gate_config?: UpdateSpendThresholdConfiguration.PaymentGateConfig;
+        payment_gate_config?: Shared.PaymentGateConfigV2;
         /**
          * Specify the threshold amount for the contract. Each time the contract's usage
          * hits this amount, a threshold charge will be initiated.
          */
         threshold_amount?: number;
     }
-    namespace UpdateSpendThresholdConfiguration {
-        interface Commit {
-            description?: string;
-            /**
-             * Specify the name of the line item for the threshold charge. If left blank, it
-             * will default to the commit product name.
-             */
-            name?: string;
-            /**
-             * The commit product that will be used to generate the line item for commit
-             * payment.
-             */
-            product_id?: string;
-        }
-        interface PaymentGateConfig {
-            /**
-             * Gate access to the commit balance based on successful collection of payment.
-             * Select STRIPE for Metronome to facilitate payment via Stripe. Select EXTERNAL to
-             * facilitate payment using your own payment integration. Select NONE if you do not
-             * wish to payment gate the commit balance.
-             */
-            payment_gate_type: 'NONE' | 'STRIPE' | 'EXTERNAL';
-            /**
-             * Only applicable if using PRECALCULATED as your tax type.
-             */
-            precalculated_tax_config?: PaymentGateConfig.PrecalculatedTaxConfig;
-            /**
-             * Only applicable if using STRIPE as your payment gateway type.
-             */
-            stripe_config?: PaymentGateConfig.StripeConfig;
-            /**
-             * Stripe tax is only supported for Stripe payment gateway. Select NONE if you do
-             * not wish Metronome to calculate tax on your behalf. Leaving this field blank
-             * will default to NONE.
-             */
-            tax_type?: 'NONE' | 'STRIPE' | 'ANROK' | 'PRECALCULATED';
-        }
-        namespace PaymentGateConfig {
-            /**
-             * Only applicable if using PRECALCULATED as your tax type.
-             */
-            interface PrecalculatedTaxConfig {
-                /**
-                 * Amount of tax to be applied. This should be in the same currency and
-                 * denomination as the commit's invoice schedule
-                 */
-                tax_amount: number;
-                /**
-                 * Name of the tax to be applied. This may be used in an invoice line item
-                 * description.
-                 */
-                tax_name?: string;
-            }
-            /**
-             * Only applicable if using STRIPE as your payment gateway type.
-             */
-            interface StripeConfig {
-                /**
-                 * If left blank, will default to INVOICE
-                 */
-                payment_type: 'INVOICE' | 'PAYMENT_INTENT';
-                /**
-                 * Metadata to be added to the Stripe invoice. Only applicable if using INVOICE as
-                 * your payment type.
-                 */
-                invoice_metadata?: {
-                    [key: string]: string;
-                };
-            }
-        }
-    }
     interface UpdateSubscription {
         subscription_id: string;
         ending_before?: string | null;
@@ -6172,6 +2657,12 @@ export interface ContractEditCommitParams {
      */
     priority?: number | null;
     product_id?: string;
+    /**
+     * If provided, updates the commit to use the specified rate type for current and
+     * future invoices. Previously finalized invoices will need to be voided and
+     * regenerated to reflect the rate type change.
+     */
+    rate_type?: 'LIST_RATE' | 'COMMIT_RATE';
     /**
      * List of filters that determine what kind of customer usage draws down a commit
      * or credit. A customer's usage needs to meet the condition of at least one of the
@@ -6180,7 +2671,7 @@ export interface ContractEditCommitParams {
      * Instead, to target usage by product or product tag, pass those values in the
      * body of `specifiers`.
      */
-    specifiers?: Array<ContractEditCommitParams.Specifier> | null;
+    specifiers?: Array<Shared.CommitSpecifierInput> | null;
 }
 export declare namespace ContractEditCommitParams {
     interface AccessSchedule {
@@ -6227,23 +2718,6 @@ export declare namespace ContractEditCommitParams {
             unit_price?: number;
         }
     }
-    interface Specifier {
-        presentation_group_values?: {
-            [key: string]: string;
-        };
-        pricing_group_values?: {
-            [key: string]: string;
-        };
-        /**
-         * If provided, the specifier will only apply to the product with the specified ID.
-         */
-        product_id?: string;
-        /**
-         * If provided, the specifier will only apply to products with all the specified
-         * tags.
-         */
-        product_tags?: Array<string>;
-    }
 }
 export interface ContractEditCreditParams {
     /**
@@ -6271,6 +2745,12 @@ export interface ContractEditCreditParams {
      */
     priority?: number | null;
     product_id?: string;
+    /**
+     * If provided, updates the credit to use the specified rate type for current and
+     * future invoices. Previously finalized invoices will need to be voided and
+     * regenerated to reflect the rate type change.
+     */
+    rate_type?: 'LIST_RATE' | 'COMMIT_RATE';
     /**
      * List of filters that determine what kind of customer usage draws down a commit
      * or credit. A customer's usage needs to meet the condition of at least one of the
@@ -6279,7 +2759,7 @@ export interface ContractEditCreditParams {
      * Instead, to target usage by product or product tag, pass those values in the
      * body of `specifiers`.
      */
-    specifiers?: Array<ContractEditCreditParams.Specifier> | null;
+    specifiers?: Array<Shared.CommitSpecifierInput> | null;
 }
 export declare namespace ContractEditCreditParams {
     interface AccessSchedule {
@@ -6303,23 +2783,6 @@ export declare namespace ContractEditCreditParams {
             starting_at?: string;
         }
     }
-    interface Specifier {
-        presentation_group_values?: {
-            [key: string]: string;
-        };
-        pricing_group_values?: {
-            [key: string]: string;
-        };
-        /**
-         * If provided, the specifier will only apply to the product with the specified ID.
-         */
-        product_id?: string;
-        /**
-         * If provided, the specifier will only apply to products with all the specified
-         * tags.
-         */
-        product_tags?: Array<string>;
-    }
 }
 export interface ContractGetEditHistoryParams {
     contract_id: string;