@metronome/sdk 0.1.0-beta.9 → 0.2.0

package/resources/v2/contracts.d.ts

@@ -5,28 +5,116 @@ export declare class Contracts extends APIResource {
     /**
      * Get a specific contract. New clients should use this endpoint rather than the v1
      * endpoint.
+     *
+     * @example
+     * ```ts
+     * const contract = await client.v2.contracts.retrieve({
+     *   contract_id: 'd7abd0cd-4ae9-4db7-8676-e986a4ebd8dc',
+     *   customer_id: '13117714-3f05-48e5-a6e9-a66093f13b4d',
+     * });
+     * ```
      */
     retrieve(body: ContractRetrieveParams, options?: Core.RequestOptions): Core.APIPromise<ContractRetrieveResponse>;
     /**
-     * List all contracts for a customer
+     * List all contracts for a customer in chronological order. New clients should use
+     * this endpoint rather than the v1 endpoint.
+     *
+     * @example
+     * ```ts
+     * const contracts = await client.v2.contracts.list({
+     *   customer_id: '13117714-3f05-48e5-a6e9-a66093f13b4d',
+     * });
+     * ```
      */
     list(body: ContractListParams, options?: Core.RequestOptions): Core.APIPromise<ContractListResponse>;
     /**
      * Edit a contract. Contract editing must be enabled to use this endpoint.
+     *
+     * @example
+     * ```ts
+     * const response = await client.v2.contracts.edit({
+     *   contract_id: 'd7abd0cd-4ae9-4db7-8676-e986a4ebd8dc',
+     *   customer_id: '13117714-3f05-48e5-a6e9-a66093f13b4d',
+     *   add_overrides: [
+     *     {
+     *       type: 'MULTIPLIER',
+     *       starting_at: '2024-11-02T00:00:00Z',
+     *       product_id: 'd4fc086c-d8e5-4091-a235-fbba5da4ec14',
+     *       multiplier: 2,
+     *       priority: 100,
+     *     },
+     *   ],
+     *   add_scheduled_charges: [
+     *     {
+     *       product_id: '2e30f074-d04c-412e-a134-851ebfa5ceb2',
+     *       schedule: {
+     *         schedule_items: [
+     *           {
+     *             timestamp: '2020-02-15T00:00:00.000Z',
+     *             unit_price: 1000000,
+     *             quantity: 1,
+     *           },
+     *         ],
+     *       },
+     *     },
+     *   ],
+     * });
+     * ```
      */
     edit(body: ContractEditParams, options?: Core.RequestOptions): Core.APIPromise<ContractEditResponse>;
     /**
      * Edit a customer or contract commit. Contract commits can only be edited using
      * this endpoint if contract editing is enabled.
+     *
+     * @example
+     * ```ts
+     * const response = await client.v2.contracts.editCommit({
+     *   commit_id: '5e7e82cf-ccb7-428c-a96f-a8e4f67af822',
+     *   customer_id: '4c91c473-fc12-445a-9c38-40421d47023f',
+     *   access_schedule: {
+     *     update_schedule_items: [
+     *       {
+     *         id: 'd5edbd32-c744-48cb-9475-a9bca0e6fa39',
+     *         ending_before: '2025-03-12T00:00:00Z',
+     *       },
+     *     ],
+     *   },
+     * });
+     * ```
      */
     editCommit(body: ContractEditCommitParams, options?: Core.RequestOptions): Core.APIPromise<ContractEditCommitResponse>;
     /**
      * Edit a customer or contract credit. Contract credits can only be edited using
      * this endpoint if contract editing is enabled.
+     *
+     * @example
+     * ```ts
+     * const response = await client.v2.contracts.editCredit({
+     *   credit_id: '5e7e82cf-ccb7-428c-a96f-a8e4f67af822',
+     *   customer_id: '4c91c473-fc12-445a-9c38-40421d47023f',
+     *   access_schedule: {
+     *     update_schedule_items: [
+     *       {
+     *         id: 'd5edbd32-c744-48cb-9475-a9bca0e6fa39',
+     *         ending_before: '2025-03-12T00:00:00Z',
+     *       },
+     *     ],
+     *   },
+     * });
+     * ```
      */
     editCredit(body: ContractEditCreditParams, options?: Core.RequestOptions): Core.APIPromise<ContractEditCreditResponse>;
     /**
-     * Get the edit history of a specific contract
+     * Get the edit history of a specific contract. Contract editing must be enabled to
+     * use this endpoint.
+     *
+     * @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>;
 }
@@ -48,7 +136,9 @@ export declare namespace ContractRetrieveResponse {
         usage_statement_schedule: Data.UsageStatementSchedule;
         archived_at?: string;
         credits?: Array<Data.Credit>;
-        custom_fields?: Record<string, string>;
+        custom_fields?: {
+            [key: string]: string;
+        };
         /**
          * This field's availability is dependent on your client's configuration.
          */
@@ -58,6 +148,16 @@ export declare namespace ContractRetrieveResponse {
          */
         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
@@ -71,6 +171,11 @@ export declare namespace ContractRetrieveResponse {
          * 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.
          */
@@ -94,8 +199,11 @@ export declare namespace ContractRetrieveResponse {
          * 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>;
-        threshold_billing_configuration?: Data.ThresholdBillingConfiguration;
         total_contract_value?: number;
         /**
          * Prevents the creation of duplicates. If a request to create a record is made
@@ -117,6 +225,7 @@ export declare namespace ContractRetrieveResponse {
             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,
@@ -129,8 +238,14 @@ export declare namespace ContractRetrieveResponse {
              */
             balance?: number;
             contract?: Commit.Contract;
-            custom_fields?: Record<string, string>;
+            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.
              */
@@ -143,7 +258,7 @@ export declare namespace ContractRetrieveResponse {
              * 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.PostpaidCommitInitialBalanceLedgerEntry | Commit.PostpaidCommitAutomatedInvoiceDeductionLedgerEntry | Commit.PostpaidCommitRolloverLedgerEntry | Commit.PostpaidCommitTrueupLedgerEntry | Commit.PrepaidCommitManualLedgerEntry | Commit.PostpaidCommitManualLedgerEntry | Commit.PostpaidCommitExpirationLedgerEntry>;
+            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.
@@ -161,6 +276,12 @@ export declare namespace ContractRetrieveResponse {
              * 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 {
@@ -170,6 +291,24 @@ export declare namespace ContractRetrieveResponse {
             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.
              */
@@ -188,6 +327,7 @@ export declare namespace ContractRetrieveResponse {
                 segment_id: string;
                 timestamp: string;
                 type: 'PREPAID_COMMIT_AUTOMATED_INVOICE_DEDUCTION';
+                contract_id?: string;
             }
             interface PrepaidCommitRolloverLedgerEntry {
                 amount: number;
@@ -208,6 +348,7 @@ export declare namespace ContractRetrieveResponse {
                 segment_id: string;
                 timestamp: string;
                 type: 'PREPAID_COMMIT_CANCELED';
+                contract_id?: string;
             }
             interface PrepaidCommitCreditedLedgerEntry {
                 amount: number;
@@ -215,6 +356,13 @@ export declare namespace ContractRetrieveResponse {
                 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;
@@ -227,6 +375,7 @@ export declare namespace ContractRetrieveResponse {
                 segment_id: string;
                 timestamp: string;
                 type: 'POSTPAID_COMMIT_AUTOMATED_INVOICE_DEDUCTION';
+                contract_id?: string;
             }
             interface PostpaidCommitRolloverLedgerEntry {
                 amount: number;
@@ -240,6 +389,7 @@ export declare namespace ContractRetrieveResponse {
                 invoice_id: string;
                 timestamp: string;
                 type: 'POSTPAID_COMMIT_TRUEUP';
+                contract_id?: string;
             }
             interface PrepaidCommitManualLedgerEntry {
                 amount: number;
@@ -262,6 +412,23 @@ export declare namespace ContractRetrieveResponse {
                 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;
@@ -281,10 +448,14 @@ export declare namespace ContractRetrieveResponse {
         }
         namespace Override {
             interface OverrideSpecifier {
-                billing_frequency?: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL';
+                billing_frequency?: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'WEEKLY';
                 commit_ids?: Array<string>;
-                presentation_group_values?: Record<string, string | null>;
-                pricing_group_values?: Record<string, 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>;
@@ -301,7 +472,9 @@ export declare namespace ContractRetrieveResponse {
                  * Only set for CUSTOM rate_type. This field is interpreted by custom rate
                  * processors.
                  */
-                custom_rate?: Record<string, unknown>;
+                custom_rate?: {
+                    [key: string]: unknown;
+                };
                 /**
                  * Default proration configuration. Only valid for SUBSCRIPTION rate_type. Must be
                  * set to true.
@@ -350,7 +523,7 @@ export declare namespace ContractRetrieveResponse {
              * Contract usage statements follow a selected cadence based on this date.
              */
             billing_anchor_date: string;
-            frequency: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL';
+            frequency: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'WEEKLY';
         }
         interface Credit {
             id: string;
@@ -375,13 +548,19 @@ export declare namespace ContractRetrieveResponse {
              */
             balance?: number;
             contract?: Credit.Contract;
-            custom_fields?: Record<string, string>;
+            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>;
+            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.
@@ -396,6 +575,12 @@ export declare namespace ContractRetrieveResponse {
              * 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 {
@@ -405,6 +590,24 @@ export declare namespace ContractRetrieveResponse {
             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;
@@ -417,6 +620,7 @@ export declare namespace ContractRetrieveResponse {
                 segment_id: string;
                 timestamp: string;
                 type: 'CREDIT_AUTOMATED_INVOICE_DEDUCTION';
+                contract_id?: string;
             }
             interface CreditExpirationLedgerEntry {
                 amount: number;
@@ -430,6 +634,7 @@ export declare namespace ContractRetrieveResponse {
                 segment_id: string;
                 timestamp: string;
                 type: 'CREDIT_CANCELED';
+                contract_id?: string;
             }
             interface CreditCreditedLedgerEntry {
                 amount: number;
@@ -437,6 +642,7 @@ export declare namespace ContractRetrieveResponse {
                 segment_id: string;
                 timestamp: string;
                 type: 'CREDIT_CREDITED';
+                contract_id?: string;
             }
             interface CreditManualLedgerEntry {
                 amount: number;
@@ -444,14 +650,221 @@ export declare namespace ContractRetrieveResponse {
                 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;
             /**
@@ -492,6 +905,10 @@ export declare namespace ContractRetrieveResponse {
              * 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.
              */
@@ -513,16 +930,26 @@ export declare namespace ContractRetrieveResponse {
              * 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 start_date rather than the usage
+             * be created aligned with the recurring commit's starting_at rather than the usage
              * invoice dates.
              */
-            recurrence_frequency?: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL';
+            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 {
             /**
@@ -530,8 +957,8 @@ export declare namespace ContractRetrieveResponse {
              */
             interface AccessAmount {
                 credit_type_id: string;
-                quantity: number;
                 unit_price: number;
+                quantity?: number;
             }
             /**
              * The amount of time the created commits will be valid for
@@ -547,6 +974,24 @@ export declare namespace ContractRetrieveResponse {
             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.
              */
@@ -555,6 +1000,39 @@ export declare namespace ContractRetrieveResponse {
                 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;
@@ -596,6 +1074,10 @@ export declare namespace ContractRetrieveResponse {
              * 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
              */
@@ -613,16 +1095,26 @@ export declare namespace ContractRetrieveResponse {
              * 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 start_date rather than the usage
+             * be created aligned with the recurring commit's starting_at rather than the usage
              * invoice dates.
              */
-            recurrence_frequency?: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL';
+            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 {
             /**
@@ -630,8 +1122,8 @@ export declare namespace ContractRetrieveResponse {
              */
             interface AccessAmount {
                 credit_type_id: string;
-                quantity: number;
                 unit_price: number;
+                quantity?: number;
             }
             /**
              * The amount of time the created commits will be valid for
@@ -647,6 +1139,57 @@ export declare namespace ContractRetrieveResponse {
             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';
@@ -669,14 +1212,109 @@ export declare namespace ContractRetrieveResponse {
                 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 {
@@ -690,7 +1328,7 @@ export declare namespace ContractRetrieveResponse {
                 ending_before?: string;
             }
             interface SubscriptionRate {
-                billing_frequency: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL';
+                billing_frequency: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'WEEKLY';
                 product: SubscriptionRate.Product;
             }
             namespace SubscriptionRate {
@@ -700,42 +1338,6 @@ export declare namespace ContractRetrieveResponse {
                 }
             }
         }
-        interface ThresholdBillingConfiguration {
-            commit: ThresholdBillingConfiguration.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;
-            /**
-             * 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 ThresholdBillingConfiguration {
-            interface Commit {
-                product_id: string;
-                /**
-                 * Which products the threshold commit applies to. If both applicable_product_ids
-                 * and applicable_product_tags are not provided, the commit applies to all
-                 * products.
-                 */
-                applicable_product_ids?: Array<string>;
-                /**
-                 * Which tags the threshold commit applies to. If both applicable_product_ids and
-                 * applicable_product_tags 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;
-            }
-        }
     }
 }
 export interface ContractListResponse {
@@ -756,7 +1358,9 @@ export declare namespace ContractListResponse {
         usage_statement_schedule: Data.UsageStatementSchedule;
         archived_at?: string;
         credits?: Array<Data.Credit>;
-        custom_fields?: Record<string, string>;
+        custom_fields?: {
+            [key: string]: string;
+        };
         /**
          * This field's availability is dependent on your client's configuration.
          */
@@ -766,6 +1370,16 @@ export declare namespace ContractListResponse {
          */
         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
@@ -779,6 +1393,11 @@ export declare namespace ContractListResponse {
          * 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.
          */
@@ -802,8 +1421,11 @@ export declare namespace ContractListResponse {
          * 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>;
-        threshold_billing_configuration?: Data.ThresholdBillingConfiguration;
         total_contract_value?: number;
         /**
          * Prevents the creation of duplicates. If a request to create a record is made
@@ -825,6 +1447,7 @@ export declare namespace ContractListResponse {
             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,
@@ -837,8 +1460,14 @@ export declare namespace ContractListResponse {
              */
             balance?: number;
             contract?: Commit.Contract;
-            custom_fields?: Record<string, string>;
+            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.
              */
@@ -851,7 +1480,7 @@ export declare namespace ContractListResponse {
              * 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.PostpaidCommitInitialBalanceLedgerEntry | Commit.PostpaidCommitAutomatedInvoiceDeductionLedgerEntry | Commit.PostpaidCommitRolloverLedgerEntry | Commit.PostpaidCommitTrueupLedgerEntry | Commit.PrepaidCommitManualLedgerEntry | Commit.PostpaidCommitManualLedgerEntry | Commit.PostpaidCommitExpirationLedgerEntry>;
+            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.
@@ -869,6 +1498,12 @@ export declare namespace ContractListResponse {
              * 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 {
@@ -878,6 +1513,24 @@ export declare namespace ContractListResponse {
             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.
              */
@@ -896,6 +1549,7 @@ export declare namespace ContractListResponse {
                 segment_id: string;
                 timestamp: string;
                 type: 'PREPAID_COMMIT_AUTOMATED_INVOICE_DEDUCTION';
+                contract_id?: string;
             }
             interface PrepaidCommitRolloverLedgerEntry {
                 amount: number;
@@ -916,6 +1570,7 @@ export declare namespace ContractListResponse {
                 segment_id: string;
                 timestamp: string;
                 type: 'PREPAID_COMMIT_CANCELED';
+                contract_id?: string;
             }
             interface PrepaidCommitCreditedLedgerEntry {
                 amount: number;
@@ -923,6 +1578,13 @@ export declare namespace ContractListResponse {
                 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;
@@ -935,6 +1597,7 @@ export declare namespace ContractListResponse {
                 segment_id: string;
                 timestamp: string;
                 type: 'POSTPAID_COMMIT_AUTOMATED_INVOICE_DEDUCTION';
+                contract_id?: string;
             }
             interface PostpaidCommitRolloverLedgerEntry {
                 amount: number;
@@ -948,6 +1611,7 @@ export declare namespace ContractListResponse {
                 invoice_id: string;
                 timestamp: string;
                 type: 'POSTPAID_COMMIT_TRUEUP';
+                contract_id?: string;
             }
             interface PrepaidCommitManualLedgerEntry {
                 amount: number;
@@ -970,6 +1634,23 @@ export declare namespace ContractListResponse {
                 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;
@@ -989,10 +1670,14 @@ export declare namespace ContractListResponse {
         }
         namespace Override {
             interface OverrideSpecifier {
-                billing_frequency?: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL';
+                billing_frequency?: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'WEEKLY';
                 commit_ids?: Array<string>;
-                presentation_group_values?: Record<string, string | null>;
-                pricing_group_values?: Record<string, 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>;
@@ -1009,7 +1694,9 @@ export declare namespace ContractListResponse {
                  * Only set for CUSTOM rate_type. This field is interpreted by custom rate
                  * processors.
                  */
-                custom_rate?: Record<string, unknown>;
+                custom_rate?: {
+                    [key: string]: unknown;
+                };
                 /**
                  * Default proration configuration. Only valid for SUBSCRIPTION rate_type. Must be
                  * set to true.
@@ -1058,7 +1745,7 @@ export declare namespace ContractListResponse {
              * Contract usage statements follow a selected cadence based on this date.
              */
             billing_anchor_date: string;
-            frequency: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL';
+            frequency: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'WEEKLY';
         }
         interface Credit {
             id: string;
@@ -1083,13 +1770,19 @@ export declare namespace ContractListResponse {
              */
             balance?: number;
             contract?: Credit.Contract;
-            custom_fields?: Record<string, string>;
+            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>;
+            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.
@@ -1104,6 +1797,12 @@ export declare namespace ContractListResponse {
              * 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 {
@@ -1113,6 +1812,24 @@ export declare namespace ContractListResponse {
             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;
@@ -1125,6 +1842,7 @@ export declare namespace ContractListResponse {
                 segment_id: string;
                 timestamp: string;
                 type: 'CREDIT_AUTOMATED_INVOICE_DEDUCTION';
+                contract_id?: string;
             }
             interface CreditExpirationLedgerEntry {
                 amount: number;
@@ -1138,6 +1856,7 @@ export declare namespace ContractListResponse {
                 segment_id: string;
                 timestamp: string;
                 type: 'CREDIT_CANCELED';
+                contract_id?: string;
             }
             interface CreditCreditedLedgerEntry {
                 amount: number;
@@ -1145,6 +1864,7 @@ export declare namespace ContractListResponse {
                 segment_id: string;
                 timestamp: string;
                 type: 'CREDIT_CREDITED';
+                contract_id?: string;
             }
             interface CreditManualLedgerEntry {
                 amount: number;
@@ -1152,14 +1872,221 @@ export declare namespace ContractListResponse {
                 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;
             /**
@@ -1200,6 +2127,10 @@ export declare namespace ContractListResponse {
              * 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.
              */
@@ -1221,16 +2152,26 @@ export declare namespace ContractListResponse {
              * 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 start_date rather than the usage
+             * be created aligned with the recurring commit's starting_at rather than the usage
              * invoice dates.
              */
-            recurrence_frequency?: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL';
+            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 {
             /**
@@ -1238,8 +2179,8 @@ export declare namespace ContractListResponse {
              */
             interface AccessAmount {
                 credit_type_id: string;
-                quantity: number;
                 unit_price: number;
+                quantity?: number;
             }
             /**
              * The amount of time the created commits will be valid for
@@ -1255,6 +2196,24 @@ export declare namespace ContractListResponse {
             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.
              */
@@ -1263,6 +2222,39 @@ export declare namespace ContractListResponse {
                 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;
@@ -1304,6 +2296,10 @@ export declare namespace ContractListResponse {
              * 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
              */
@@ -1321,16 +2317,26 @@ export declare namespace ContractListResponse {
              * 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 start_date rather than the usage
+             * be created aligned with the recurring commit's starting_at rather than the usage
              * invoice dates.
              */
-            recurrence_frequency?: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL';
+            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 {
             /**
@@ -1338,8 +2344,8 @@ export declare namespace ContractListResponse {
              */
             interface AccessAmount {
                 credit_type_id: string;
-                quantity: number;
                 unit_price: number;
+                quantity?: number;
             }
             /**
              * The amount of time the created commits will be valid for
@@ -1355,6 +2361,57 @@ export declare namespace ContractListResponse {
             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';
@@ -1377,72 +2434,131 @@ export declare namespace ContractListResponse {
                 reseller_contract_value?: number;
             }
         }
-        interface Subscription {
-            collection_schedule: 'ADVANCE' | 'ARREARS';
-            proration: Subscription.Proration;
-            quantity_schedule: Array<Subscription.QuantitySchedule>;
-            starting_at: string;
-            subscription_rate: Subscription.SubscriptionRate;
-            description?: string;
-            ending_before?: 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';
-                product: SubscriptionRate.Product;
-            }
-            namespace SubscriptionRate {
-                interface Product {
-                    id: string;
-                    name: string;
-                }
-            }
-        }
-        interface ThresholdBillingConfiguration {
-            commit: ThresholdBillingConfiguration.Commit;
+        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
+             * 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 ThresholdBillingConfiguration {
+        namespace SpendThresholdConfiguration {
             interface Commit {
-                product_id: string;
                 /**
-                 * Which products the threshold commit applies to. If both applicable_product_ids
-                 * and applicable_product_tags are not provided, the commit applies to all
-                 * products.
+                 * The commit product that will be used to generate the line item for commit
+                 * payment.
                  */
-                applicable_product_ids?: Array<string>;
-                /**
-                 * Which tags the threshold commit applies to. If both applicable_product_ids and
-                 * applicable_product_tags are not provided, the commit applies to all products.
-                 */
-                applicable_product_tags?: Array<string>;
-                description?: string;
+                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;
+                }
+            }
         }
     }
 }
@@ -1465,19 +2581,42 @@ 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_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;
+        /**
+         * List of subscriptions on the contract.
+         */
+        add_subscriptions?: Array<Data.AddSubscription>;
         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;
         update_commits?: Array<Data.UpdateCommit>;
         update_contract_end_date?: string;
+        /**
+         * Value to update the contract name to. If not provided, the contract name will
+         * remain unchanged.
+         */
+        update_contract_name?: string | null;
         update_credits?: Array<Data.UpdateCredit>;
         update_discounts?: Array<Data.UpdateDiscount>;
+        update_prepaid_balance_threshold_configuration?: Data.UpdatePrepaidBalanceThresholdConfiguration;
+        update_recurring_commits?: Array<Data.UpdateRecurringCommit>;
+        update_recurring_credits?: Array<Data.UpdateRecurringCredit>;
         update_refund_invoices?: Array<Data.UpdateRefundInvoice>;
         update_scheduled_charges?: Array<Data.UpdateScheduledCharge>;
+        update_spend_threshold_configuration?: Data.UpdateSpendThresholdConfiguration;
+        /**
+         * Optional list of subscriptions to update.
+         */
+        update_subscriptions?: Array<Data.UpdateSubscription>;
     }
     namespace Data {
         interface AddCommit {
@@ -1492,6 +2631,10 @@ export declare namespace ContractGetEditHistoryResponse {
             applicable_product_ids?: Array<string>;
             applicable_product_tags?: Array<string>;
             description?: string;
+            /**
+             * Optional configuration for commit hierarchy access control
+             */
+            hierarchy_configuration?: AddCommit.HierarchyConfiguration;
             /**
              * The schedule that the customer will be invoiced for this commit.
              */
@@ -1512,12 +2655,56 @@ export declare namespace ContractGetEditHistoryResponse {
              * 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. 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<AddCommit.Specifier>;
         }
         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;
@@ -1530,6 +2717,10 @@ export declare namespace ContractGetEditHistoryResponse {
             applicable_product_ids?: Array<string>;
             applicable_product_tags?: Array<string>;
             description?: string;
+            /**
+             * Optional configuration for recurring credit hierarchy access control
+             */
+            hierarchy_configuration?: AddCredit.HierarchyConfiguration;
             name?: string;
             /**
              * This field's availability is dependent on your client's configuration.
@@ -1544,12 +2735,56 @@ export declare namespace ContractGetEditHistoryResponse {
              * 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. 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<AddCredit.Specifier>;
         }
         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;
@@ -1569,10 +2804,14 @@ export declare namespace ContractGetEditHistoryResponse {
         }
         namespace AddOverride {
             interface OverrideSpecifier {
-                billing_frequency?: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL';
+                billing_frequency?: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'WEEKLY';
                 commit_ids?: Array<string>;
-                presentation_group_values?: Record<string, string | null>;
-                pricing_group_values?: Record<string, 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>;
@@ -1589,7 +2828,9 @@ export declare namespace ContractGetEditHistoryResponse {
                  * Only set for CUSTOM rate_type. This field is interpreted by custom rate
                  * processors.
                  */
-                custom_rate?: Record<string, unknown>;
+                custom_rate?: {
+                    [key: string]: unknown;
+                };
                 /**
                  * Default proration configuration. Only valid for SUBSCRIPTION rate_type. Must be
                  * set to true.
@@ -1614,6 +2855,141 @@ export declare namespace ContractGetEditHistoryResponse {
                 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;
             /**
@@ -1654,6 +3030,10 @@ export declare namespace ContractGetEditHistoryResponse {
              * Determines when the contract will stop creating recurring commits. Optional
              */
             ending_before?: string;
+            /**
+             * Optional configuration for recurring credit hierarchy access control
+             */
+            hierarchy_configuration?: AddRecurringCommit.HierarchyConfiguration;
             /**
              * The amount the customer should be billed for the commit. Not required.
              */
@@ -1675,16 +3055,26 @@ export declare namespace ContractGetEditHistoryResponse {
              * 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 start_date rather than the usage
+             * be created aligned with the recurring commit's starting_at rather than the usage
              * invoice dates.
              */
-            recurrence_frequency?: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL';
+            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<AddRecurringCommit.Specifier>;
+            /**
+             * Attach a subscription to the recurring commit/credit.
+             */
+            subscription_config?: AddRecurringCommit.SubscriptionConfig;
         }
         namespace AddRecurringCommit {
             /**
@@ -1692,8 +3082,8 @@ export declare namespace ContractGetEditHistoryResponse {
              */
             interface AccessAmount {
                 credit_type_id: string;
-                quantity: number;
                 unit_price: number;
+                quantity?: number;
             }
             /**
              * The amount of time the created commits will be valid for
@@ -1709,6 +3099,24 @@ 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.
              */
@@ -1717,6 +3125,39 @@ 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;
@@ -1758,6 +3199,10 @@ export declare namespace ContractGetEditHistoryResponse {
              * Determines when the contract will stop creating recurring commits. Optional
              */
             ending_before?: string;
+            /**
+             * Optional configuration for recurring credit hierarchy access control
+             */
+            hierarchy_configuration?: AddRecurringCredit.HierarchyConfiguration;
             /**
              * Displayed on invoices. Will be passed through to the individual commits
              */
@@ -1775,16 +3220,26 @@ export declare namespace ContractGetEditHistoryResponse {
              * 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 start_date rather than the usage
+             * be created aligned with the recurring commit's starting_at rather than the usage
              * invoice dates.
              */
-            recurrence_frequency?: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL';
+            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<AddRecurringCredit.Specifier>;
+            /**
+             * Attach a subscription to the recurring commit/credit.
+             */
+            subscription_config?: AddRecurringCredit.SubscriptionConfig;
         }
         namespace AddRecurringCredit {
             /**
@@ -1792,8 +3247,8 @@ export declare namespace ContractGetEditHistoryResponse {
              */
             interface AccessAmount {
                 credit_type_id: string;
-                quantity: number;
                 unit_price: number;
+                quantity?: number;
             }
             /**
              * The amount of time the created commits will be valid for
@@ -1809,6 +3264,57 @@ 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';
@@ -1844,41 +3350,194 @@ export declare namespace ContractGetEditHistoryResponse {
                 name: string;
             }
         }
-        interface AddUsageFilter {
-            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 UpdateCommit {
-            id: string;
-            access_schedule?: UpdateCommit.AccessSchedule;
+        interface AddSpendThresholdConfiguration {
+            commit: AddSpendThresholdConfiguration.Commit;
             /**
-             * Which products the commit applies to. If both applicable_product_ids and
-             * applicable_product_tags are not provided, the commit applies to all products.
+             * 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.
              */
-            applicable_product_ids?: Array<string> | null;
+            is_enabled: boolean;
+            payment_gate_config: AddSpendThresholdConfiguration.PaymentGateConfig;
             /**
-             * Which tags the commit applies to. If both applicable_product_ids and
-             * applicable_product_tags are not provided, the commit applies to all products.
+             * Specify the threshold amount for the contract. Each time the contract's usage
+             * hits this amount, a threshold charge will be initiated.
              */
-            applicable_product_tags?: Array<string> | null;
-            invoice_schedule?: UpdateCommit.InvoiceSchedule;
-            name?: string;
-            netsuite_sales_order_id?: string | null;
-            product_id?: string;
-            rollover_fraction?: number | null;
+            threshold_amount: number;
         }
-        namespace UpdateCommit {
-            interface AccessSchedule {
+        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;
+                }
+            }
+        }
+        interface AddUsageFilter {
+            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 ArchiveCommit {
+            id: string;
+        }
+        interface ArchiveCredit {
+            id: string;
+        }
+        interface ArchiveScheduledCharge {
+            id: string;
+        }
+        interface RemoveOverride {
+            id: string;
+        }
+        interface UpdateCommit {
+            id: string;
+            access_schedule?: UpdateCommit.AccessSchedule;
+            /**
+             * Which products the 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> | null;
+            /**
+             * Which tags the 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> | null;
+            /**
+             * Optional configuration for commit hierarchy access control
+             */
+            hierarchy_configuration?: UpdateCommit.HierarchyConfiguration;
+            invoice_schedule?: UpdateCommit.InvoiceSchedule;
+            name?: string;
+            netsuite_sales_order_id?: string | null;
+            product_id?: string;
+            rollover_fraction?: number | null;
+            /**
+             * 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<UpdateCommit.Specifier> | null;
+        }
+        namespace UpdateCommit {
+            interface AccessSchedule {
                 add_schedule_items?: Array<AccessSchedule.AddScheduleItem>;
                 remove_schedule_items?: Array<AccessSchedule.RemoveScheduleItem>;
                 update_schedule_items?: Array<AccessSchedule.UpdateScheduleItem>;
@@ -1911,6 +3570,24 @@ 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>;
@@ -1934,10 +3611,31 @@ 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;
             access_schedule?: UpdateCredit.AccessSchedule;
+            /**
+             * Optional configuration for credit hierarchy access control
+             */
+            hierarchy_configuration?: UpdateCredit.HierarchyConfiguration;
             name?: string;
             netsuite_sales_order_id?: string | null;
             rollover_fraction?: number | null;
@@ -1976,10 +3674,30 @@ 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?: Record<string, string>;
+            custom_fields?: {
+                [key: string]: string;
+            };
             name?: string;
             netsuite_sales_order_id?: string;
             /**
@@ -1993,7 +3711,7 @@ export declare namespace ContractGetEditHistoryResponse {
              */
             interface Schedule {
                 /**
-                 * Defaults to USD if not passed. Only USD is supported at this time.
+                 * Defaults to USD (cents) if not passed.
                  */
                 credit_type_id?: string;
                 /**
@@ -2019,7 +3737,7 @@ export declare namespace ContractGetEditHistoryResponse {
                      * RFC 3339 timestamp (exclusive).
                      */
                     ending_before: string;
-                    frequency: 'MONTHLY' | 'QUARTERLY' | 'SEMI_ANNUAL' | 'ANNUAL';
+                    frequency: 'MONTHLY' | 'QUARTERLY' | 'SEMI_ANNUAL' | 'ANNUAL' | 'WEEKLY';
                     /**
                      * RFC 3339 timestamp (inclusive).
                      */
@@ -2069,6 +3787,167 @@ export declare namespace ContractGetEditHistoryResponse {
                 }
             }
         }
+        interface UpdatePrepaidBalanceThresholdConfiguration {
+            commit?: UpdatePrepaidBalanceThresholdConfiguration.Commit;
+            /**
+             * 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 | null;
+            /**
+             * 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?: UpdatePrepaidBalanceThresholdConfiguration.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;
+        }
+        namespace UpdatePrepaidBalanceThresholdConfiguration {
+            interface Commit {
+                /**
+                 * Which products the threshold commit applies to. If both applicable_product_ids
+                 * and applicable_product_tags are not provided, the commit applies to all
+                 * products.
+                 */
+                applicable_product_ids?: Array<string> | null;
+                /**
+                 * Which tags the threshold commit applies to. If both applicable_product_ids and
+                 * 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
+                 * 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> | 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;
+                    };
+                }
+            }
+        }
+        interface UpdateRecurringCommit {
+            id: string;
+            access_amount?: UpdateRecurringCommit.AccessAmount;
+            ending_before?: string;
+            invoice_amount?: UpdateRecurringCommit.InvoiceAmount;
+        }
+        namespace UpdateRecurringCommit {
+            interface AccessAmount {
+                quantity?: number;
+                unit_price?: number;
+            }
+            interface InvoiceAmount {
+                quantity?: number;
+                unit_price?: number;
+            }
+        }
+        interface UpdateRecurringCredit {
+            id: string;
+            access_amount?: UpdateRecurringCredit.AccessAmount;
+            ending_before?: string;
+        }
+        namespace UpdateRecurringCredit {
+            interface AccessAmount {
+                quantity?: number;
+                unit_price?: number;
+            }
+        }
         interface UpdateRefundInvoice {
             date: string;
             invoice_id: string;
@@ -2104,6 +3983,104 @@ export declare namespace ContractGetEditHistoryResponse {
                 }
             }
         }
+        interface UpdateSpendThresholdConfiguration {
+            commit?: UpdateSpendThresholdConfiguration.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?: UpdateSpendThresholdConfiguration.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 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;
+            quantity_updates?: Array<UpdateSubscription.QuantityUpdate>;
+        }
+        namespace UpdateSubscription {
+            interface QuantityUpdate {
+                starting_at: string;
+                quantity?: number;
+                quantity_delta?: number;
+            }
+        }
     }
 }
 export interface ContractRetrieveParams {
@@ -2165,6 +4142,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;
     /**
      * This field's availability is dependent on your client's configuration.
      */
@@ -2173,9 +4151,66 @@ 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;
+    /**
+     * Optional list of
+     * [subscriptions](https://docs.metronome.com/manage-product-access/create-subscription/)
+     * to add to the contract.
+     */
+    add_subscriptions?: Array<ContractEditParams.AddSubscription>;
+    /**
+     * If true, allows setting the contract end date earlier than the end_timestamp of
+     * existing finalized invoices. Finalized invoices will be unchanged; if you want
+     * to incorporate the new end date, you can void and regenerate finalized usage
+     * invoices. Defaults to true.
+     */
+    allow_contract_ending_before_finalized_invoice?: boolean;
+    /**
+     * IDs of commits to archive
+     */
+    archive_commits?: Array<ContractEditParams.ArchiveCommit>;
+    /**
+     * IDs of credits to archive
+     */
+    archive_credits?: Array<ContractEditParams.ArchiveCredit>;
+    /**
+     * IDs of scheduled charges to archive
+     */
+    archive_scheduled_charges?: Array<ContractEditParams.ArchiveScheduledCharge>;
+    /**
+     * IDs of overrides to remove
+     */
+    remove_overrides?: Array<ContractEditParams.RemoveOverride>;
     update_commits?: Array<ContractEditParams.UpdateCommit>;
+    /**
+     * RFC 3339 timestamp indicating when the contract will end (exclusive).
+     */
+    update_contract_end_date?: string | null;
+    /**
+     * Value to update the contract name to. If not provided, the contract name will
+     * remain unchanged.
+     */
+    update_contract_name?: string | null;
     update_credits?: Array<ContractEditParams.UpdateCredit>;
+    update_prepaid_balance_threshold_configuration?: ContractEditParams.UpdatePrepaidBalanceThresholdConfiguration;
+    /**
+     * Edits to these recurring commits will only affect commits whose access schedules
+     * has not started. Expired commits, and commits with an active access schedule
+     * will remain unchanged.
+     */
+    update_recurring_commits?: Array<ContractEditParams.UpdateRecurringCommit>;
+    /**
+     * Edits to these recurring credits will only affect credits whose access schedules
+     * has not started. Expired credits, and credits with an active access schedule
+     * will remain unchanged.
+     */
+    update_recurring_credits?: Array<ContractEditParams.UpdateRecurringCredit>;
     update_scheduled_charges?: Array<ContractEditParams.UpdateScheduledCharge>;
+    update_spend_threshold_configuration?: ContractEditParams.UpdateSpendThresholdConfiguration;
+    /**
+     * Optional list of subscriptions to update.
+     */
+    update_subscriptions?: Array<ContractEditParams.UpdateSubscription>;
 }
 export declare namespace ContractEditParams {
     interface AddCommit {
@@ -2192,20 +4227,28 @@ export declare namespace ContractEditParams {
          */
         amount?: number;
         /**
-         * Which products the commit applies to. If both applicable_product_ids and
-         * applicable_product_tags are not provided, the commit applies to all products.
+         * Which products the 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 commit applies to. If both applicable_product_ids and
-         * applicable_product_tags are not provided, the commit applies to all products.
+         * Which tags the 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>;
-        custom_fields?: Record<string, string>;
+        custom_fields?: {
+            [key: string]: string;
+        };
         /**
          * Used only in UI/API. It is not exposed to end customers.
          */
         description?: string;
+        /**
+         * Optional configuration for commit hierarchy access control
+         */
+        hierarchy_configuration?: AddCommit.HierarchyConfiguration;
         /**
          * 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
@@ -2221,6 +4264,10 @@ export declare namespace ContractEditParams {
          * This field's availability is dependent on your client's configuration.
          */
         netsuite_sales_order_id?: string;
+        /**
+         * optionally payment gate this commit
+         */
+        payment_gate_config?: AddCommit.PaymentGateConfig;
         /**
          * If multiple commits are applicable, the one with the lower priority will apply
          * first.
@@ -2231,6 +4278,15 @@ export declare namespace ContractEditParams {
          * Fraction of unused segments that will be rolled over. 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. 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<AddCommit.Specifier>;
         /**
          * A temporary ID for the commit that can be used to reference the commit for
          * commit specific overrides.
@@ -2260,6 +4316,24 @@ 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
@@ -2268,7 +4342,7 @@ export declare namespace ContractEditParams {
          */
         interface InvoiceSchedule {
             /**
-             * Defaults to USD if not passed. Only USD is supported at this time.
+             * Defaults to USD (cents) if not passed.
              */
             credit_type_id?: string;
             /**
@@ -2294,7 +4368,7 @@ export declare namespace ContractEditParams {
                  * RFC 3339 timestamp (exclusive).
                  */
                 ending_before: string;
-                frequency: 'MONTHLY' | 'QUARTERLY' | 'SEMI_ANNUAL' | 'ANNUAL';
+                frequency: 'MONTHLY' | 'QUARTERLY' | 'SEMI_ANNUAL' | 'ANNUAL' | 'WEEKLY';
                 /**
                  * RFC 3339 timestamp (inclusive).
                  */
@@ -2343,6 +4417,82 @@ export declare namespace ContractEditParams {
                 unit_price?: number;
             }
         }
+        /**
+         * optionally payment gate this commit
+         */
+        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 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 {
         /**
@@ -2360,11 +4510,17 @@ export declare namespace ContractEditParams {
          * applicable_product_tags are not provided, the credit applies to all products.
          */
         applicable_product_tags?: Array<string>;
-        custom_fields?: Record<string, string>;
+        custom_fields?: {
+            [key: string]: string;
+        };
         /**
          * Used only in UI/API. It is not exposed to end customers.
          */
         description?: string;
+        /**
+         * Optional configuration for credit hierarchy access control
+         */
+        hierarchy_configuration?: AddCredit.HierarchyConfiguration;
         /**
          * displayed on invoices
          */
@@ -2379,6 +4535,15 @@ export declare namespace ContractEditParams {
          */
         priority?: number;
         rate_type?: 'COMMIT_RATE' | 'LIST_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
+         * 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<AddCredit.Specifier>;
     }
     namespace AddCredit {
         /**
@@ -2401,6 +4566,41 @@ 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;
@@ -2408,7 +4608,9 @@ export declare namespace ContractEditParams {
          * Must provide either schedule_items or recurring_schedule.
          */
         schedule: AddDiscount.Schedule;
-        custom_fields?: Record<string, string>;
+        custom_fields?: {
+            [key: string]: string;
+        };
         /**
          * displayed on invoices
          */
@@ -2424,7 +4626,7 @@ export declare namespace ContractEditParams {
          */
         interface Schedule {
             /**
-             * Defaults to USD if not passed. Only USD is supported at this time.
+             * Defaults to USD (cents) if not passed.
              */
             credit_type_id?: string;
             /**
@@ -2450,7 +4652,7 @@ export declare namespace ContractEditParams {
                  * RFC 3339 timestamp (exclusive).
                  */
                 ending_before: string;
-                frequency: 'MONTHLY' | 'QUARTERLY' | 'SEMI_ANNUAL' | 'ANNUAL';
+                frequency: 'MONTHLY' | 'QUARTERLY' | 'SEMI_ANNUAL' | 'ANNUAL' | 'WEEKLY';
                 /**
                  * RFC 3339 timestamp (inclusive).
                  */
@@ -2561,6 +4763,7 @@ export declare namespace ContractEditParams {
     }
     namespace AddOverride {
         interface OverrideSpecifier {
+            billing_frequency?: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'WEEKLY';
             /**
              * If provided, the override will only apply to the specified commits. Can only be
              * used for commit specific overrides. If not provided, the override will apply to
@@ -2572,12 +4775,16 @@ export declare namespace ContractEditParams {
              * the specified presentation group values. Can only be used for multiplier
              * overrides.
              */
-            presentation_group_values?: Record<string, string>;
+            presentation_group_values?: {
+                [key: string]: string;
+            };
             /**
              * A map of pricing group names to values. The override will only apply to products
              * with the specified pricing group values.
              */
-            pricing_group_values?: Record<string, string>;
+            pricing_group_values?: {
+                [key: string]: string;
+            };
             /**
              * If provided, the override will only apply to the product with the specified ID.
              */
@@ -2612,7 +4819,9 @@ export declare namespace ContractEditParams {
              * Only set for CUSTOM rate_type. This field is interpreted by custom rate
              * processors.
              */
-            custom_rate?: Record<string, unknown>;
+            custom_rate?: {
+                [key: string]: unknown;
+            };
             /**
              * Default proration configuration. Only valid for SUBSCRIPTION rate_type. Must be
              * set to true.
@@ -2637,6 +4846,141 @@ export declare namespace ContractEditParams {
             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;
+            /**
+             * 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 AddProfessionalService {
         /**
          * Maximum amount for the term.
@@ -2653,7 +4997,9 @@ export declare namespace ContractEditParams {
          * amount and must be specified.
          */
         unit_price: number;
-        custom_fields?: Record<string, string>;
+        custom_fields?: {
+            [key: string]: string;
+        };
         description?: string;
         /**
          * This field's availability is dependent on your client's configuration.
@@ -2666,7 +5012,9 @@ export declare namespace ContractEditParams {
          */
         access_amount: AddRecurringCommit.AccessAmount;
         /**
-         * The amount of time the created commits will be valid for.
+         * Defines the length of the access schedule for each created commit/credit. The
+         * value represents the number of units. Unit defaults to "PERIODS", where the
+         * length of a period is determined by the recurrence_frequency.
          */
         commit_duration: AddRecurringCommit.CommitDuration;
         /**
@@ -2694,6 +5042,10 @@ export declare namespace ContractEditParams {
          * Determines when the contract will stop creating recurring commits. optional
          */
         ending_before?: string;
+        /**
+         * Optional configuration for recurring credit hierarchy access control
+         */
+        hierarchy_configuration?: AddRecurringCommit.HierarchyConfiguration;
         /**
          * The amount the customer should be billed for the commit. Not required.
          */
@@ -2719,16 +5071,29 @@ export declare namespace ContractEditParams {
          * 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 start_date rather than the usage
+         * be created aligned with the recurring commit's starting_at rather than the usage
          * invoice dates.
          */
-        recurrence_frequency?: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL';
+        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. 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<AddRecurringCommit.Specifier>;
+        /**
+         * Attach a subscription to the recurring commit/credit.
+         */
+        subscription_config?: AddRecurringCommit.SubscriptionConfig;
         /**
          * A temporary ID that can be used to reference the recurring commit for commit
          * specific overrides.
@@ -2741,15 +5106,39 @@ export declare namespace ContractEditParams {
          */
         interface AccessAmount {
             credit_type_id: string;
-            quantity: number;
             unit_price: number;
+            /**
+             * This field is currently required. Upcoming recurring commit/credit configuration
+             * options will allow it to be optional.
+             */
+            quantity?: number;
         }
         /**
-         * The amount of time the created commits will be valid for.
+         * Defines the length of the access schedule for each created commit/credit. The
+         * value represents the number of units. Unit defaults to "PERIODS", where the
+         * length of a period is determined by the recurrence_frequency.
          */
         interface CommitDuration {
-            unit: 'PERIODS';
             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.
@@ -2759,6 +5148,45 @@ 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.
+         */
+        interface SubscriptionConfig {
+            apply_seat_increase_config: SubscriptionConfig.ApplySeatIncreaseConfig;
+            /**
+             * ID of the subscription to configure on the recurring commit/credit.
+             */
+            subscription_id: string;
+            /**
+             * If set to POOLED, allocation added per seat is pooled across the account.
+             */
+            allocation?: 'POOLED';
+        }
+        namespace SubscriptionConfig {
+            interface ApplySeatIncreaseConfig {
+                /**
+                 * Indicates whether a mid-period seat increase should be prorated.
+                 */
+                is_prorated: boolean;
+            }
+        }
     }
     interface AddRecurringCredit {
         /**
@@ -2766,7 +5194,9 @@ export declare namespace ContractEditParams {
          */
         access_amount: AddRecurringCredit.AccessAmount;
         /**
-         * The amount of time the created commits will be valid for.
+         * Defines the length of the access schedule for each created commit/credit. The
+         * value represents the number of units. Unit defaults to "PERIODS", where the
+         * length of a period is determined by the recurrence_frequency.
          */
         commit_duration: AddRecurringCredit.CommitDuration;
         /**
@@ -2794,6 +5224,10 @@ export declare namespace ContractEditParams {
          * Determines when the contract will stop creating recurring commits. optional
          */
         ending_before?: string;
+        /**
+         * Optional configuration for recurring credit hierarchy access control
+         */
+        hierarchy_configuration?: AddRecurringCredit.HierarchyConfiguration;
         /**
          * displayed on invoices. will be passed through to the individual commits
          */
@@ -2815,16 +5249,29 @@ export declare namespace ContractEditParams {
          * 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 start_date rather than the usage
+         * be created aligned with the recurring commit's starting_at rather than the usage
          * invoice dates.
          */
-        recurrence_frequency?: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL';
+        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. 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<AddRecurringCredit.Specifier>;
+        /**
+         * Attach a subscription to the recurring commit/credit.
+         */
+        subscription_config?: AddRecurringCredit.SubscriptionConfig;
         /**
          * A temporary ID that can be used to reference the recurring commit for commit
          * specific overrides.
@@ -2837,15 +5284,78 @@ export declare namespace ContractEditParams {
          */
         interface AccessAmount {
             credit_type_id: string;
-            quantity: number;
             unit_price: number;
+            /**
+             * This field is currently required. Upcoming recurring commit/credit configuration
+             * options will allow it to be optional.
+             */
+            quantity?: number;
+        }
+        /**
+         * Defines the length of the access schedule for each created commit/credit. The
+         * value represents the number of units. Unit defaults to "PERIODS", where the
+         * length of a period is determined by the recurrence_frequency.
+         */
+        interface CommitDuration {
+            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>;
         }
         /**
-         * The amount of time the created commits will be valid for.
+         * Attach a subscription to the recurring commit/credit.
          */
-        interface CommitDuration {
-            unit: 'PERIODS';
-            value: number;
+        interface SubscriptionConfig {
+            apply_seat_increase_config: SubscriptionConfig.ApplySeatIncreaseConfig;
+            /**
+             * ID of the subscription to configure on the recurring commit/credit.
+             */
+            subscription_id: string;
+            /**
+             * If set to POOLED, allocation added per seat is pooled across the account.
+             */
+            allocation?: 'POOLED';
+        }
+        namespace SubscriptionConfig {
+            interface ApplySeatIncreaseConfig {
+                /**
+                 * Indicates whether a mid-period seat increase should be prorated.
+                 */
+                is_prorated: boolean;
+            }
         }
     }
     interface AddResellerRoyalty {
@@ -2901,7 +5411,7 @@ export declare namespace ContractEditParams {
          */
         interface Schedule {
             /**
-             * Defaults to USD if not passed. Only USD is supported at this time.
+             * Defaults to USD (cents) if not passed.
              */
             credit_type_id?: string;
             /**
@@ -2927,7 +5437,7 @@ export declare namespace ContractEditParams {
                  * RFC 3339 timestamp (exclusive).
                  */
                 ending_before: string;
-                frequency: 'MONTHLY' | 'QUARTERLY' | 'SEMI_ANNUAL' | 'ANNUAL';
+                frequency: 'MONTHLY' | 'QUARTERLY' | 'SEMI_ANNUAL' | 'ANNUAL' | 'WEEKLY';
                 /**
                  * RFC 3339 timestamp (inclusive).
                  */
@@ -2977,19 +5487,176 @@ export declare namespace ContractEditParams {
             }
         }
     }
+    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';
+        initial_quantity: number;
+        proration: AddSubscription.Proration;
+        subscription_rate: AddSubscription.SubscriptionRate;
+        custom_fields?: {
+            [key: string]: string;
+        };
+        description?: string;
+        /**
+         * Exclusive end time for the subscription. If not provided, subscription inherits
+         * contract end date.
+         */
+        ending_before?: string;
+        name?: string;
+        /**
+         * Inclusive start time for the subscription. If not provided, defaults to contract
+         * start date
+         */
+        starting_at?: string;
+        /**
+         * A temporary ID used to reference the subscription in recurring commit/credit
+         * subscription configs created within the same payload.
+         */
+        temporary_id?: string;
+    }
+    namespace AddSubscription {
+        interface Proration {
+            /**
+             * Indicates how mid-period quantity adjustments are invoiced.
+             * **BILL_IMMEDIATELY**: Only available when collection schedule is `ADVANCE`. The
+             * quantity increase will be billed immediately on the scheduled date.
+             * **BILL_ON_NEXT_COLLECTION_DATE**: The quantity increase will be billed for
+             * in-arrears at the end of the period.
+             */
+            invoice_behavior?: 'BILL_IMMEDIATELY' | 'BILL_ON_NEXT_COLLECTION_DATE';
+            /**
+             * Indicates if the partial period will be prorated or charged a full amount.
+             */
+            is_prorated?: boolean;
+        }
+        interface SubscriptionRate {
+            /**
+             * Frequency to bill subscription with. Together with product_id, must match
+             * existing rate on the rate card.
+             */
+            billing_frequency: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'WEEKLY';
+            /**
+             * Must be subscription type product
+             */
+            product_id: string;
+        }
+    }
+    interface ArchiveCommit {
+        id: string;
+    }
+    interface ArchiveCredit {
+        id: string;
+    }
+    interface ArchiveScheduledCharge {
+        id: string;
+    }
+    interface RemoveOverride {
+        id: string;
+    }
     interface UpdateCommit {
         commit_id: string;
         access_schedule?: UpdateCommit.AccessSchedule;
         /**
-         * Which products the commit applies to. If both applicable_product_ids and
-         * applicable_product_tags are not provided, the commit applies to all products.
+         * Which products the 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> | null;
         /**
-         * Which tags the commit applies to. If both applicable_product_ids and
-         * applicable_product_tags are not provided, the commit applies to all products.
+         * Which tags the 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> | null;
+        /**
+         * Optional configuration for commit hierarchy access control
+         */
+        hierarchy_configuration?: UpdateCommit.HierarchyConfiguration;
         invoice_schedule?: UpdateCommit.InvoiceSchedule;
         netsuite_sales_order_id?: string | null;
         product_id?: string;
@@ -3017,6 +5684,24 @@ 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>;
@@ -3045,15 +5730,21 @@ export declare namespace ContractEditParams {
         credit_id: string;
         access_schedule?: UpdateCredit.AccessSchedule;
         /**
-         * Which products the commit applies to. If both applicable_product_ids and
-         * applicable_product_tags are not provided, the commit applies to all products.
+         * Which products the 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> | null;
         /**
-         * Which tags the commit applies to. If both applicable_product_ids and
-         * applicable_product_tags are not provided, the commit applies to all products.
+         * Which tags the 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> | null;
+        /**
+         * Optional configuration for commit hierarchy access control
+         */
+        hierarchy_configuration?: UpdateCredit.HierarchyConfiguration;
         netsuite_sales_order_id?: string | null;
         product_id?: string;
     }
@@ -3079,6 +5770,185 @@ 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;
+        /**
+         * 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 | null;
+        /**
+         * 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?: UpdatePrepaidBalanceThresholdConfiguration.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;
+    }
+    namespace UpdatePrepaidBalanceThresholdConfiguration {
+        interface Commit {
+            /**
+             * Which products the threshold commit applies to. If both applicable_product_ids
+             * and applicable_product_tags are not provided, the commit applies to all
+             * products.
+             */
+            applicable_product_ids?: Array<string> | null;
+            /**
+             * Which tags the threshold commit applies to. If both applicable_product_ids and
+             * 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
+             * 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> | 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;
+                };
+            }
+        }
+    }
+    interface UpdateRecurringCommit {
+        recurring_commit_id: string;
+        access_amount?: UpdateRecurringCommit.AccessAmount;
+        ending_before?: string | null;
+        invoice_amount?: UpdateRecurringCommit.InvoiceAmount;
+    }
+    namespace UpdateRecurringCommit {
+        interface AccessAmount {
+            quantity?: number;
+            unit_price?: number;
+        }
+        interface InvoiceAmount {
+            quantity?: number;
+            unit_price?: number;
+        }
+    }
+    interface UpdateRecurringCredit {
+        recurring_credit_id: string;
+        access_amount?: UpdateRecurringCredit.AccessAmount;
+        ending_before?: string | null;
+    }
+    namespace UpdateRecurringCredit {
+        interface AccessAmount {
+            quantity?: number;
+            unit_price?: number;
+        }
     }
     interface UpdateScheduledCharge {
         scheduled_charge_id: string;
@@ -3110,6 +5980,118 @@ export declare namespace ContractEditParams {
             }
         }
     }
+    interface UpdateSpendThresholdConfiguration {
+        commit?: UpdateSpendThresholdConfiguration.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?: UpdateSpendThresholdConfiguration.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 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;
+        /**
+         * Quantity changes are applied on the effective date based on the order which they
+         * are sent. For example, if I scheduled the quantity to be 12 on May 21 and then
+         * scheduled a quantity delta change of -1, the result from that day would be 11.
+         */
+        quantity_updates?: Array<UpdateSubscription.QuantityUpdate>;
+    }
+    namespace UpdateSubscription {
+        interface QuantityUpdate {
+            starting_at: string;
+            /**
+             * The new quantity for the subscription. Must be provided if quantity_delta is not
+             * provided. Must be non-negative.
+             */
+            quantity?: number;
+            /**
+             * The delta to add to the subscription's quantity. Must be provided if quantity is
+             * not provided. Can't be zero. It also can't result in a negative quantity on the
+             * subscription.
+             */
+            quantity_delta?: number;
+        }
+    }
 }
 export interface ContractEditCommitParams {
     /**
@@ -3122,13 +6104,15 @@ export interface ContractEditCommitParams {
     customer_id: string;
     access_schedule?: ContractEditCommitParams.AccessSchedule;
     /**
-     * Which products the commit applies to. If both applicable_product_ids and
-     * applicable_product_tags are not provided, the commit applies to all products.
+     * Which products the 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> | null;
     /**
-     * Which tags the commit applies to. If both applicable_product_ids and
-     * applicable_product_tags are not provided, the commit applies to all products.
+     * Which tags the 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> | null;
     /**
@@ -3137,6 +6121,15 @@ export interface ContractEditCommitParams {
     invoice_contract_id?: string;
     invoice_schedule?: ContractEditCommitParams.InvoiceSchedule;
     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
+     * 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<ContractEditCommitParams.Specifier> | null;
 }
 export declare namespace ContractEditCommitParams {
     interface AccessSchedule {
@@ -3183,6 +6176,23 @@ 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 {
     /**
@@ -3205,6 +6215,15 @@ export interface ContractEditCreditParams {
      */
     applicable_product_tags?: Array<string> | null;
     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
+     * 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<ContractEditCreditParams.Specifier> | null;
 }
 export declare namespace ContractEditCreditParams {
     interface AccessSchedule {
@@ -3228,6 +6247,23 @@ 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;