@metronome/sdk 0.1.0-beta.9 → 0.1.0

package/src/resources/v2/contracts.ts

@@ -1,13 +1,21 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { APIResource } from '../../resource';
-import * as Core from '../../core';
-import * as Shared from '../shared';
+import { APIResource } from "../../resource.js";
+import * as Core from "../../core.js";
+import * as Shared from "../shared.js";
 
 export 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,
@@ -17,7 +25,15 @@ export class Contracts extends APIResource {
   }
 
   /**
-   * 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> {
     return this._client.post('/v2/contracts/list', { body, ...options });
@@ -25,6 +41,37 @@ export class Contracts extends APIResource {
 
   /**
    * 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> {
     return this._client.post('/v2/contracts/edit', { body, ...options });
@@ -33,6 +80,22 @@ export class Contracts extends APIResource {
   /**
    * 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,
@@ -44,6 +107,22 @@ export class Contracts extends APIResource {
   /**
    * 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,
@@ -53,7 +132,16 @@ export class Contracts extends APIResource {
   }
 
   /**
-   * 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,
@@ -95,7 +183,7 @@ export namespace ContractRetrieveResponse {
 
     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.
@@ -109,6 +197,18 @@ export namespace ContractRetrieveResponse {
 
     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
@@ -126,6 +226,13 @@ export namespace ContractRetrieveResponse {
      */
     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.
      */
@@ -156,9 +263,12 @@ export namespace ContractRetrieveResponse {
      */
     scheduled_charges_on_usage_invoices?: 'ALL';
 
-    subscriptions?: Array<Data.Subscription>;
+    spend_threshold_configuration?: Data.SpendThresholdConfiguration;
 
-    threshold_billing_configuration?: Data.ThresholdBillingConfiguration;
+    /**
+     * List of subscriptions on the contract.
+     */
+    subscriptions?: Array<Data.Subscription>;
 
     total_contract_value?: number;
 
@@ -190,6 +300,8 @@ export namespace ContractRetrieveResponse {
 
       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,
@@ -204,10 +316,15 @@ export namespace ContractRetrieveResponse {
 
       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.
        */
@@ -229,6 +346,7 @@ export namespace ContractRetrieveResponse {
         | Commit.PrepaidCommitExpirationLedgerEntry
         | Commit.PrepaidCommitCanceledLedgerEntry
         | Commit.PrepaidCommitCreditedLedgerEntry
+        | Commit.PrepaidCommitSeatBasedAdjustmentLedgerEntry
         | Commit.PostpaidCommitInitialBalanceLedgerEntry
         | Commit.PostpaidCommitAutomatedInvoiceDeductionLedgerEntry
         | Commit.PostpaidCommitRolloverLedgerEntry
@@ -261,6 +379,13 @@ export 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>;
     }
 
     export namespace Commit {
@@ -274,6 +399,32 @@ export namespace ContractRetrieveResponse {
         id: string;
       }
 
+      /**
+       * Optional configuration for commit hierarchy access control
+       */
+      export interface HierarchyConfiguration {
+        child_access:
+          | HierarchyConfiguration.CommitHierarchyChildAccessAll
+          | HierarchyConfiguration.CommitHierarchyChildAccessNone
+          | HierarchyConfiguration.CommitHierarchyChildAccessContractIDs;
+      }
+
+      export namespace HierarchyConfiguration {
+        export interface CommitHierarchyChildAccessAll {
+          type: 'ALL';
+        }
+
+        export interface CommitHierarchyChildAccessNone {
+          type: 'NONE';
+        }
+
+        export interface CommitHierarchyChildAccessContractIDs {
+          contract_ids: Array<string>;
+
+          type: 'CONTRACT_IDS';
+        }
+      }
+
       /**
        * The contract that this commit will be billed on.
        */
@@ -349,6 +500,16 @@ export namespace ContractRetrieveResponse {
         type: 'PREPAID_COMMIT_CREDITED';
       }
 
+      export interface PrepaidCommitSeatBasedAdjustmentLedgerEntry {
+        amount: number;
+
+        segment_id: string;
+
+        timestamp: string;
+
+        type: 'PREPAID_COMMIT_SEAT_BASED_ADJUSTMENT';
+      }
+
       export interface PostpaidCommitInitialBalanceLedgerEntry {
         amount: number;
 
@@ -424,6 +585,23 @@ export namespace ContractRetrieveResponse {
 
         contract_id: string;
       }
+
+      export 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 Override {
@@ -458,13 +636,13 @@ export namespace ContractRetrieveResponse {
 
     export namespace Override {
       export interface OverrideSpecifier {
-        billing_frequency?: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL';
+        billing_frequency?: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'WEEKLY';
 
         commit_ids?: Array<string>;
 
-        presentation_group_values?: Record<string, string | null>;
+        presentation_group_values?: { [key: string]: string | null };
 
-        pricing_group_values?: Record<string, string>;
+        pricing_group_values?: { [key: string]: string };
 
         product_id?: string;
 
@@ -490,7 +668,7 @@ export 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
@@ -554,7 +732,7 @@ export namespace ContractRetrieveResponse {
        */
       billing_anchor_date: string;
 
-      frequency: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL';
+      frequency: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'WEEKLY';
     }
 
     export interface Credit {
@@ -589,10 +767,15 @@ export namespace ContractRetrieveResponse {
 
       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.
@@ -604,6 +787,7 @@ export namespace ContractRetrieveResponse {
         | Credit.CreditCanceledLedgerEntry
         | Credit.CreditCreditedLedgerEntry
         | Credit.CreditManualLedgerEntry
+        | Credit.CreditSeatBasedAdjustmentLedgerEntry
       >;
 
       name?: string;
@@ -623,6 +807,13 @@ export 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>;
     }
 
     export namespace Credit {
@@ -636,6 +827,32 @@ export namespace ContractRetrieveResponse {
         id: string;
       }
 
+      /**
+       * Optional configuration for credit hierarchy access control
+       */
+      export interface HierarchyConfiguration {
+        child_access:
+          | HierarchyConfiguration.CommitHierarchyChildAccessAll
+          | HierarchyConfiguration.CommitHierarchyChildAccessNone
+          | HierarchyConfiguration.CommitHierarchyChildAccessContractIDs;
+      }
+
+      export namespace HierarchyConfiguration {
+        export interface CommitHierarchyChildAccessAll {
+          type: 'ALL';
+        }
+
+        export interface CommitHierarchyChildAccessNone {
+          type: 'NONE';
+        }
+
+        export interface CommitHierarchyChildAccessContractIDs {
+          contract_ids: Array<string>;
+
+          type: 'CONTRACT_IDS';
+        }
+      }
+
       export interface CreditSegmentStartLedgerEntry {
         amount: number;
 
@@ -701,6 +918,33 @@ export namespace ContractRetrieveResponse {
 
         type: 'CREDIT_MANUAL';
       }
+
+      export interface CreditSeatBasedAdjustmentLedgerEntry {
+        amount: number;
+
+        segment_id: string;
+
+        timestamp: string;
+
+        type: 'CREDIT_SEAT_BASED_ADJUSTMENT';
+      }
+
+      export 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>;
+      }
     }
 
     /**
@@ -720,6 +964,210 @@ export namespace ContractRetrieveResponse {
       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.
+     */
+    export 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;
+    }
+
+    export interface ParentHierarchyConfiguration {
+      /**
+       * List of contracts that belong to this parent.
+       */
+      children: Array<ParentHierarchyConfiguration.Child>;
+    }
+
+    export namespace ParentHierarchyConfiguration {
+      export interface Child {
+        contract_id: string;
+
+        customer_id: string;
+      }
+    }
+
+    export interface ChildHierarchyConfiguration {
+      /**
+       * The single parent contract/customer for this child.
+       */
+      parent: ChildHierarchyConfiguration.Parent;
+    }
+
+    export namespace ChildHierarchyConfiguration {
+      /**
+       * The single parent contract/customer for this child.
+       */
+      export interface Parent {
+        contract_id: string;
+
+        customer_id: string;
+      }
+    }
+
+    export 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;
+    }
+
+    export namespace PrepaidBalanceThresholdConfiguration {
+      export 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`.
+         */
+        specifiers?: Array<Commit.Specifier>;
+      }
+
+      export namespace Commit {
+        export 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 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';
+      }
+
+      export namespace PaymentGateConfig {
+        /**
+         * Only applicable if using PRECALCULATED as your tax type.
+         */
+        export 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.
+         */
+        export 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 };
+        }
+      }
+    }
+
     export interface RecurringCommit {
       id: string;
 
@@ -772,6 +1220,11 @@ export namespace ContractRetrieveResponse {
        */
       ending_before?: string;
 
+      /**
+       * Optional configuration for recurring commit/credit hierarchy access control
+       */
+      hierarchy_configuration?: RecurringCommit.HierarchyConfiguration;
+
       /**
        * The amount the customer should be billed for the commit. Not required.
        */
@@ -797,10 +1250,10 @@ export 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
@@ -808,6 +1261,13 @@ export namespace ContractRetrieveResponse {
        * 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>;
     }
 
     export namespace RecurringCommit {
@@ -817,9 +1277,9 @@ export namespace ContractRetrieveResponse {
       export interface AccessAmount {
         credit_type_id: string;
 
-        quantity: number;
-
         unit_price: number;
+
+        quantity?: number;
       }
 
       /**
@@ -841,6 +1301,32 @@ export namespace ContractRetrieveResponse {
         id: string;
       }
 
+      /**
+       * Optional configuration for recurring commit/credit hierarchy access control
+       */
+      export interface HierarchyConfiguration {
+        child_access:
+          | HierarchyConfiguration.CommitHierarchyChildAccessAll
+          | HierarchyConfiguration.CommitHierarchyChildAccessNone
+          | HierarchyConfiguration.CommitHierarchyChildAccessContractIDs;
+      }
+
+      export namespace HierarchyConfiguration {
+        export interface CommitHierarchyChildAccessAll {
+          type: 'ALL';
+        }
+
+        export interface CommitHierarchyChildAccessNone {
+          type: 'NONE';
+        }
+
+        export interface CommitHierarchyChildAccessContractIDs {
+          contract_ids: Array<string>;
+
+          type: 'CONTRACT_IDS';
+        }
+      }
+
       /**
        * The amount the customer should be billed for the commit. Not required.
        */
@@ -851,6 +1337,23 @@ export namespace ContractRetrieveResponse {
 
         unit_price: number;
       }
+
+      export 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 RecurringCredit {
@@ -905,6 +1408,11 @@ export namespace ContractRetrieveResponse {
        */
       ending_before?: string;
 
+      /**
+       * Optional configuration for recurring commit/credit hierarchy access control
+       */
+      hierarchy_configuration?: RecurringCredit.HierarchyConfiguration;
+
       /**
        * Displayed on invoices. Will be passed through to the individual commits
        */
@@ -925,10 +1433,10 @@ export 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
@@ -936,6 +1444,13 @@ export namespace ContractRetrieveResponse {
        * 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>;
     }
 
     export namespace RecurringCredit {
@@ -945,9 +1460,9 @@ export namespace ContractRetrieveResponse {
       export interface AccessAmount {
         credit_type_id: string;
 
-        quantity: number;
-
         unit_price: number;
+
+        quantity?: number;
       }
 
       /**
@@ -968,12 +1483,55 @@ export namespace ContractRetrieveResponse {
       export interface Contract {
         id: string;
       }
-    }
 
-    export interface ResellerRoyalty {
-      reseller_type: 'AWS' | 'AWS_PRO_SERVICE' | 'GCP' | 'GCP_PRO_SERVICE';
+      /**
+       * Optional configuration for recurring commit/credit hierarchy access control
+       */
+      export interface HierarchyConfiguration {
+        child_access:
+          | HierarchyConfiguration.CommitHierarchyChildAccessAll
+          | HierarchyConfiguration.CommitHierarchyChildAccessNone
+          | HierarchyConfiguration.CommitHierarchyChildAccessContractIDs;
+      }
 
-      segments: Array<ResellerRoyalty.Segment>;
+      export namespace HierarchyConfiguration {
+        export interface CommitHierarchyChildAccessAll {
+          type: 'ALL';
+        }
+
+        export interface CommitHierarchyChildAccessNone {
+          type: 'NONE';
+        }
+
+        export interface CommitHierarchyChildAccessContractIDs {
+          contract_ids: Array<string>;
+
+          type: 'CONTRACT_IDS';
+        }
+      }
+
+      export 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 ResellerRoyalty {
+      reseller_type: 'AWS' | 'AWS_PRO_SERVICE' | 'GCP' | 'GCP_PRO_SERVICE';
+
+      segments: Array<ResellerRoyalty.Segment>;
     }
 
     export namespace ResellerRoyalty {
@@ -1006,21 +1564,130 @@ export namespace ContractRetrieveResponse {
       }
     }
 
+    export 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;
+    }
+
+    export namespace SpendThresholdConfiguration {
+      export 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;
+      }
+
+      export 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';
+      }
+
+      export namespace PaymentGateConfig {
+        /**
+         * Only applicable if using PRECALCULATED as your tax type.
+         */
+        export 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.
+         */
+        export 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 };
+        }
+      }
+    }
+
     export 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;
     }
 
@@ -1040,7 +1707,7 @@ export namespace ContractRetrieveResponse {
       }
 
       export interface SubscriptionRate {
-        billing_frequency: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL';
+        billing_frequency: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'WEEKLY';
 
         product: SubscriptionRate.Product;
       }
@@ -1053,50 +1720,6 @@ export namespace ContractRetrieveResponse {
         }
       }
     }
-
-    export 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;
-    }
-
-    export namespace ThresholdBillingConfiguration {
-      export 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;
-      }
-    }
   }
 }
 
@@ -1132,7 +1755,7 @@ export namespace ContractListResponse {
 
     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.
@@ -1146,6 +1769,18 @@ export namespace ContractListResponse {
 
     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
@@ -1163,6 +1798,13 @@ export namespace ContractListResponse {
      */
     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.
      */
@@ -1193,9 +1835,12 @@ export namespace ContractListResponse {
      */
     scheduled_charges_on_usage_invoices?: 'ALL';
 
-    subscriptions?: Array<Data.Subscription>;
+    spend_threshold_configuration?: Data.SpendThresholdConfiguration;
 
-    threshold_billing_configuration?: Data.ThresholdBillingConfiguration;
+    /**
+     * List of subscriptions on the contract.
+     */
+    subscriptions?: Array<Data.Subscription>;
 
     total_contract_value?: number;
 
@@ -1227,6 +1872,8 @@ export namespace ContractListResponse {
 
       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,
@@ -1241,10 +1888,15 @@ export namespace ContractListResponse {
 
       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.
        */
@@ -1266,6 +1918,7 @@ export namespace ContractListResponse {
         | Commit.PrepaidCommitExpirationLedgerEntry
         | Commit.PrepaidCommitCanceledLedgerEntry
         | Commit.PrepaidCommitCreditedLedgerEntry
+        | Commit.PrepaidCommitSeatBasedAdjustmentLedgerEntry
         | Commit.PostpaidCommitInitialBalanceLedgerEntry
         | Commit.PostpaidCommitAutomatedInvoiceDeductionLedgerEntry
         | Commit.PostpaidCommitRolloverLedgerEntry
@@ -1298,6 +1951,13 @@ export 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>;
     }
 
     export namespace Commit {
@@ -1311,6 +1971,32 @@ export namespace ContractListResponse {
         id: string;
       }
 
+      /**
+       * Optional configuration for commit hierarchy access control
+       */
+      export interface HierarchyConfiguration {
+        child_access:
+          | HierarchyConfiguration.CommitHierarchyChildAccessAll
+          | HierarchyConfiguration.CommitHierarchyChildAccessNone
+          | HierarchyConfiguration.CommitHierarchyChildAccessContractIDs;
+      }
+
+      export namespace HierarchyConfiguration {
+        export interface CommitHierarchyChildAccessAll {
+          type: 'ALL';
+        }
+
+        export interface CommitHierarchyChildAccessNone {
+          type: 'NONE';
+        }
+
+        export interface CommitHierarchyChildAccessContractIDs {
+          contract_ids: Array<string>;
+
+          type: 'CONTRACT_IDS';
+        }
+      }
+
       /**
        * The contract that this commit will be billed on.
        */
@@ -1386,6 +2072,16 @@ export namespace ContractListResponse {
         type: 'PREPAID_COMMIT_CREDITED';
       }
 
+      export interface PrepaidCommitSeatBasedAdjustmentLedgerEntry {
+        amount: number;
+
+        segment_id: string;
+
+        timestamp: string;
+
+        type: 'PREPAID_COMMIT_SEAT_BASED_ADJUSTMENT';
+      }
+
       export interface PostpaidCommitInitialBalanceLedgerEntry {
         amount: number;
 
@@ -1461,6 +2157,23 @@ export namespace ContractListResponse {
 
         contract_id: string;
       }
+
+      export 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 Override {
@@ -1495,13 +2208,13 @@ export namespace ContractListResponse {
 
     export namespace Override {
       export interface OverrideSpecifier {
-        billing_frequency?: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL';
+        billing_frequency?: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'WEEKLY';
 
         commit_ids?: Array<string>;
 
-        presentation_group_values?: Record<string, string | null>;
+        presentation_group_values?: { [key: string]: string | null };
 
-        pricing_group_values?: Record<string, string>;
+        pricing_group_values?: { [key: string]: string };
 
         product_id?: string;
 
@@ -1527,7 +2240,7 @@ export 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
@@ -1591,7 +2304,7 @@ export namespace ContractListResponse {
        */
       billing_anchor_date: string;
 
-      frequency: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL';
+      frequency: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'WEEKLY';
     }
 
     export interface Credit {
@@ -1626,10 +2339,15 @@ export namespace ContractListResponse {
 
       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.
@@ -1641,6 +2359,7 @@ export namespace ContractListResponse {
         | Credit.CreditCanceledLedgerEntry
         | Credit.CreditCreditedLedgerEntry
         | Credit.CreditManualLedgerEntry
+        | Credit.CreditSeatBasedAdjustmentLedgerEntry
       >;
 
       name?: string;
@@ -1660,6 +2379,13 @@ export 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>;
     }
 
     export namespace Credit {
@@ -1673,6 +2399,32 @@ export namespace ContractListResponse {
         id: string;
       }
 
+      /**
+       * Optional configuration for credit hierarchy access control
+       */
+      export interface HierarchyConfiguration {
+        child_access:
+          | HierarchyConfiguration.CommitHierarchyChildAccessAll
+          | HierarchyConfiguration.CommitHierarchyChildAccessNone
+          | HierarchyConfiguration.CommitHierarchyChildAccessContractIDs;
+      }
+
+      export namespace HierarchyConfiguration {
+        export interface CommitHierarchyChildAccessAll {
+          type: 'ALL';
+        }
+
+        export interface CommitHierarchyChildAccessNone {
+          type: 'NONE';
+        }
+
+        export interface CommitHierarchyChildAccessContractIDs {
+          contract_ids: Array<string>;
+
+          type: 'CONTRACT_IDS';
+        }
+      }
+
       export interface CreditSegmentStartLedgerEntry {
         amount: number;
 
@@ -1738,6 +2490,33 @@ export namespace ContractListResponse {
 
         type: 'CREDIT_MANUAL';
       }
+
+      export interface CreditSeatBasedAdjustmentLedgerEntry {
+        amount: number;
+
+        segment_id: string;
+
+        timestamp: string;
+
+        type: 'CREDIT_SEAT_BASED_ADJUSTMENT';
+      }
+
+      export 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>;
+      }
     }
 
     /**
@@ -1757,43 +2536,247 @@ export namespace ContractListResponse {
       delivery_method: 'direct_to_billing_provider' | 'aws_sqs' | 'tackle' | 'aws_sns';
     }
 
-    export interface RecurringCommit {
-      id: string;
-
+    /**
+     * Indicates whether there are more items than the limit for this endpoint. Use the
+     * respective list endpoints to get the full lists.
+     */
+    export interface HasMore {
       /**
-       * The amount of commit to grant.
+       * 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.
        */
-      access_amount: RecurringCommit.AccessAmount;
+      commits: boolean;
 
       /**
-       * The amount of time the created commits will be valid for
+       * 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.
        */
-      commit_duration: RecurringCommit.CommitDuration;
+      credits: boolean;
+    }
 
+    export interface ParentHierarchyConfiguration {
       /**
-       * Will be passed down to the individual commits
+       * List of contracts that belong to this parent.
        */
-      priority: number;
+      children: Array<ParentHierarchyConfiguration.Child>;
+    }
 
-      product: RecurringCommit.Product;
+    export namespace ParentHierarchyConfiguration {
+      export interface Child {
+        contract_id: string;
 
+        customer_id: string;
+      }
+    }
+
+    export interface ChildHierarchyConfiguration {
       /**
-       * Whether the created commits will use the commit rate or list rate
+       * The single parent contract/customer for this child.
        */
-      rate_type: 'COMMIT_RATE' | 'LIST_RATE';
+      parent: ChildHierarchyConfiguration.Parent;
+    }
 
+    export namespace ChildHierarchyConfiguration {
       /**
-       * Determines the start time for the first commit
+       * The single parent contract/customer for this child.
        */
-      starting_at: string;
+      export interface Parent {
+        contract_id: string;
+
+        customer_id: string;
+      }
+    }
+
+    export interface PrepaidBalanceThresholdConfiguration {
+      commit: PrepaidBalanceThresholdConfiguration.Commit;
 
       /**
-       * Will be passed down to the individual commits
+       * 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>;
+      is_enabled: boolean;
+
+      payment_gate_config: PrepaidBalanceThresholdConfiguration.PaymentGateConfig;
 
       /**
-       * Will be passed down to the individual commits
+       * 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;
+    }
+
+    export namespace PrepaidBalanceThresholdConfiguration {
+      export 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`.
+         */
+        specifiers?: Array<Commit.Specifier>;
+      }
+
+      export namespace Commit {
+        export 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 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';
+      }
+
+      export namespace PaymentGateConfig {
+        /**
+         * Only applicable if using PRECALCULATED as your tax type.
+         */
+        export 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.
+         */
+        export 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 };
+        }
+      }
+    }
+
+    export interface RecurringCommit {
+      id: string;
+
+      /**
+       * The amount of commit to grant.
+       */
+      access_amount: RecurringCommit.AccessAmount;
+
+      /**
+       * The amount of time the created commits will be valid for
+       */
+      commit_duration: RecurringCommit.CommitDuration;
+
+      /**
+       * Will be passed down to the individual commits
+       */
+      priority: number;
+
+      product: RecurringCommit.Product;
+
+      /**
+       * Whether the created commits will use the commit rate or list rate
+       */
+      rate_type: 'COMMIT_RATE' | 'LIST_RATE';
+
+      /**
+       * Determines the start time for the first commit
+       */
+      starting_at: string;
+
+      /**
+       * Will be passed down to the individual commits
+       */
+      applicable_product_ids?: Array<string>;
+
+      /**
+       * Will be passed down to the individual commits
        */
       applicable_product_tags?: Array<string>;
 
@@ -1809,6 +2792,11 @@ export namespace ContractListResponse {
        */
       ending_before?: string;
 
+      /**
+       * Optional configuration for recurring commit/credit hierarchy access control
+       */
+      hierarchy_configuration?: RecurringCommit.HierarchyConfiguration;
+
       /**
        * The amount the customer should be billed for the commit. Not required.
        */
@@ -1834,10 +2822,10 @@ export 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
@@ -1845,6 +2833,13 @@ export namespace ContractListResponse {
        * 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>;
     }
 
     export namespace RecurringCommit {
@@ -1854,9 +2849,9 @@ export namespace ContractListResponse {
       export interface AccessAmount {
         credit_type_id: string;
 
-        quantity: number;
-
         unit_price: number;
+
+        quantity?: number;
       }
 
       /**
@@ -1878,6 +2873,32 @@ export namespace ContractListResponse {
         id: string;
       }
 
+      /**
+       * Optional configuration for recurring commit/credit hierarchy access control
+       */
+      export interface HierarchyConfiguration {
+        child_access:
+          | HierarchyConfiguration.CommitHierarchyChildAccessAll
+          | HierarchyConfiguration.CommitHierarchyChildAccessNone
+          | HierarchyConfiguration.CommitHierarchyChildAccessContractIDs;
+      }
+
+      export namespace HierarchyConfiguration {
+        export interface CommitHierarchyChildAccessAll {
+          type: 'ALL';
+        }
+
+        export interface CommitHierarchyChildAccessNone {
+          type: 'NONE';
+        }
+
+        export interface CommitHierarchyChildAccessContractIDs {
+          contract_ids: Array<string>;
+
+          type: 'CONTRACT_IDS';
+        }
+      }
+
       /**
        * The amount the customer should be billed for the commit. Not required.
        */
@@ -1888,6 +2909,23 @@ export namespace ContractListResponse {
 
         unit_price: number;
       }
+
+      export 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 RecurringCredit {
@@ -1942,6 +2980,11 @@ export namespace ContractListResponse {
        */
       ending_before?: string;
 
+      /**
+       * Optional configuration for recurring commit/credit hierarchy access control
+       */
+      hierarchy_configuration?: RecurringCredit.HierarchyConfiguration;
+
       /**
        * Displayed on invoices. Will be passed through to the individual commits
        */
@@ -1962,10 +3005,10 @@ export 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
@@ -1973,6 +3016,13 @@ export namespace ContractListResponse {
        * 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>;
     }
 
     export namespace RecurringCredit {
@@ -1982,9 +3032,9 @@ export namespace ContractListResponse {
       export interface AccessAmount {
         credit_type_id: string;
 
-        quantity: number;
-
         unit_price: number;
+
+        quantity?: number;
       }
 
       /**
@@ -2005,6 +3055,49 @@ export namespace ContractListResponse {
       export interface Contract {
         id: string;
       }
+
+      /**
+       * Optional configuration for recurring commit/credit hierarchy access control
+       */
+      export interface HierarchyConfiguration {
+        child_access:
+          | HierarchyConfiguration.CommitHierarchyChildAccessAll
+          | HierarchyConfiguration.CommitHierarchyChildAccessNone
+          | HierarchyConfiguration.CommitHierarchyChildAccessContractIDs;
+      }
+
+      export namespace HierarchyConfiguration {
+        export interface CommitHierarchyChildAccessAll {
+          type: 'ALL';
+        }
+
+        export interface CommitHierarchyChildAccessNone {
+          type: 'NONE';
+        }
+
+        export interface CommitHierarchyChildAccessContractIDs {
+          contract_ids: Array<string>;
+
+          type: 'CONTRACT_IDS';
+        }
+      }
+
+      export 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 ResellerRoyalty {
@@ -2043,21 +3136,130 @@ export namespace ContractListResponse {
       }
     }
 
+    export 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;
+    }
+
+    export namespace SpendThresholdConfiguration {
+      export 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;
+      }
+
+      export 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';
+      }
+
+      export namespace PaymentGateConfig {
+        /**
+         * Only applicable if using PRECALCULATED as your tax type.
+         */
+        export 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.
+         */
+        export 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 };
+        }
+      }
+    }
+
     export 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;
     }
 
@@ -2077,7 +3279,7 @@ export namespace ContractListResponse {
       }
 
       export interface SubscriptionRate {
-        billing_frequency: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL';
+        billing_frequency: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'WEEKLY';
 
         product: SubscriptionRate.Product;
       }
@@ -2090,50 +3292,6 @@ export namespace ContractListResponse {
         }
       }
     }
-
-    export 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;
-    }
-
-    export namespace ThresholdBillingConfiguration {
-      export 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;
-      }
-    }
   }
 }
 
@@ -2165,6 +3323,8 @@ export namespace ContractGetEditHistoryResponse {
 
     add_overrides?: Array<Data.AddOverride>;
 
+    add_prepaid_balance_threshold_configuration?: Data.AddPrepaidBalanceThresholdConfiguration;
+
     add_pro_services?: Array<Shared.ProService>;
 
     add_recurring_commits?: Array<Data.AddRecurringCommit>;
@@ -2175,21 +3335,55 @@ export namespace ContractGetEditHistoryResponse {
 
     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>;
   }
 
   export namespace Data {
@@ -2238,6 +3432,14 @@ export 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`.
+       */
+      specifiers?: Array<AddCommit.Specifier>;
     }
 
     export namespace AddCommit {
@@ -2246,6 +3448,23 @@ export namespace ContractGetEditHistoryResponse {
 
         name: string;
       }
+
+      export 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 AddCredit {
@@ -2283,6 +3502,14 @@ export 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`.
+       */
+      specifiers?: Array<AddCredit.Specifier>;
     }
 
     export namespace AddCredit {
@@ -2291,6 +3518,23 @@ export namespace ContractGetEditHistoryResponse {
 
         name: string;
       }
+
+      export 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 AddOverride {
@@ -2325,13 +3569,13 @@ export namespace ContractGetEditHistoryResponse {
 
     export namespace AddOverride {
       export interface OverrideSpecifier {
-        billing_frequency?: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL';
+        billing_frequency?: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'WEEKLY';
 
         commit_ids?: Array<string>;
 
-        presentation_group_values?: Record<string, string | null>;
+        presentation_group_values?: { [key: string]: string | null };
 
-        pricing_group_values?: Record<string, string>;
+        pricing_group_values?: { [key: string]: string };
 
         product_id?: string;
 
@@ -2357,7 +3601,7 @@ export 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
@@ -2389,6 +3633,157 @@ export namespace ContractGetEditHistoryResponse {
       }
     }
 
+    export 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;
+    }
+
+    export namespace AddPrepaidBalanceThresholdConfiguration {
+      export 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`.
+         */
+        specifiers?: Array<Commit.Specifier>;
+      }
+
+      export namespace Commit {
+        export 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 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';
+      }
+
+      export namespace PaymentGateConfig {
+        /**
+         * Only applicable if using PRECALCULATED as your tax type.
+         */
+        export 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.
+         */
+        export 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 };
+        }
+      }
+    }
+
     export interface AddRecurringCommit {
       id: string;
 
@@ -2441,6 +3836,11 @@ export namespace ContractGetEditHistoryResponse {
        */
       ending_before?: string;
 
+      /**
+       * Optional configuration for recurring commit/credit hierarchy access control
+       */
+      hierarchy_configuration?: AddRecurringCommit.HierarchyConfiguration;
+
       /**
        * The amount the customer should be billed for the commit. Not required.
        */
@@ -2466,10 +3866,10 @@ export 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
@@ -2477,6 +3877,13 @@ export namespace ContractGetEditHistoryResponse {
        * 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>;
     }
 
     export namespace AddRecurringCommit {
@@ -2486,9 +3893,9 @@ export namespace ContractGetEditHistoryResponse {
       export interface AccessAmount {
         credit_type_id: string;
 
-        quantity: number;
-
         unit_price: number;
+
+        quantity?: number;
       }
 
       /**
@@ -2510,6 +3917,32 @@ export namespace ContractGetEditHistoryResponse {
         id: string;
       }
 
+      /**
+       * Optional configuration for recurring commit/credit hierarchy access control
+       */
+      export interface HierarchyConfiguration {
+        child_access:
+          | HierarchyConfiguration.CommitHierarchyChildAccessAll
+          | HierarchyConfiguration.CommitHierarchyChildAccessNone
+          | HierarchyConfiguration.CommitHierarchyChildAccessContractIDs;
+      }
+
+      export namespace HierarchyConfiguration {
+        export interface CommitHierarchyChildAccessAll {
+          type: 'ALL';
+        }
+
+        export interface CommitHierarchyChildAccessNone {
+          type: 'NONE';
+        }
+
+        export interface CommitHierarchyChildAccessContractIDs {
+          contract_ids: Array<string>;
+
+          type: 'CONTRACT_IDS';
+        }
+      }
+
       /**
        * The amount the customer should be billed for the commit. Not required.
        */
@@ -2520,6 +3953,23 @@ export namespace ContractGetEditHistoryResponse {
 
         unit_price: number;
       }
+
+      export 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 AddRecurringCredit {
@@ -2574,6 +4024,11 @@ export namespace ContractGetEditHistoryResponse {
        */
       ending_before?: string;
 
+      /**
+       * Optional configuration for recurring commit/credit hierarchy access control
+       */
+      hierarchy_configuration?: AddRecurringCredit.HierarchyConfiguration;
+
       /**
        * Displayed on invoices. Will be passed through to the individual commits
        */
@@ -2594,10 +4049,10 @@ export 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
@@ -2605,6 +4060,13 @@ export namespace ContractGetEditHistoryResponse {
        * 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>;
     }
 
     export namespace AddRecurringCredit {
@@ -2614,9 +4076,9 @@ export namespace ContractGetEditHistoryResponse {
       export interface AccessAmount {
         credit_type_id: string;
 
-        quantity: number;
-
         unit_price: number;
+
+        quantity?: number;
       }
 
       /**
@@ -2625,17 +4087,60 @@ export namespace ContractGetEditHistoryResponse {
       export interface CommitDuration {
         value: number;
 
-        unit?: 'PERIODS';
+        unit?: 'PERIODS';
+      }
+
+      export interface Product {
+        id: string;
+
+        name: string;
+      }
+
+      export interface Contract {
+        id: string;
+      }
+
+      /**
+       * Optional configuration for recurring commit/credit hierarchy access control
+       */
+      export interface HierarchyConfiguration {
+        child_access:
+          | HierarchyConfiguration.CommitHierarchyChildAccessAll
+          | HierarchyConfiguration.CommitHierarchyChildAccessNone
+          | HierarchyConfiguration.CommitHierarchyChildAccessContractIDs;
       }
 
-      export interface Product {
-        id: string;
+      export namespace HierarchyConfiguration {
+        export interface CommitHierarchyChildAccessAll {
+          type: 'ALL';
+        }
 
-        name: string;
+        export interface CommitHierarchyChildAccessNone {
+          type: 'NONE';
+        }
+
+        export interface CommitHierarchyChildAccessContractIDs {
+          contract_ids: Array<string>;
+
+          type: 'CONTRACT_IDS';
+        }
       }
 
-      export interface Contract {
-        id: string;
+      export 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>;
       }
     }
 
@@ -2693,6 +4198,163 @@ export namespace ContractGetEditHistoryResponse {
       }
     }
 
+    export 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;
+    }
+
+    export namespace AddSpendThresholdConfiguration {
+      export 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;
+      }
+
+      export 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';
+      }
+
+      export namespace PaymentGateConfig {
+        /**
+         * Only applicable if using PRECALCULATED as your tax type.
+         */
+        export 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.
+         */
+        export 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 };
+        }
+      }
+    }
+
+    export 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;
+    }
+
+    export namespace AddSubscription {
+      export interface Proration {
+        invoice_behavior: 'BILL_IMMEDIATELY' | 'BILL_ON_NEXT_COLLECTION_DATE';
+
+        is_prorated: boolean;
+      }
+
+      export interface QuantitySchedule {
+        quantity: number;
+
+        starting_at: string;
+
+        ending_before?: string;
+      }
+
+      export interface SubscriptionRate {
+        billing_frequency: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'WEEKLY';
+
+        product: SubscriptionRate.Product;
+      }
+
+      export namespace SubscriptionRate {
+        export interface Product {
+          id: string;
+
+          name: string;
+        }
+      }
+    }
+
     export interface AddUsageFilter {
       group_key: string;
 
@@ -2711,20 +4373,38 @@ export namespace ContractGetEditHistoryResponse {
       ending_before?: string;
     }
 
+    export interface ArchiveCommit {
+      id: string;
+    }
+
+    export interface ArchiveCredit {
+      id: string;
+    }
+
+    export interface ArchiveScheduledCharge {
+      id: string;
+    }
+
+    export interface RemoveOverride {
+      id: string;
+    }
+
     export interface UpdateCommit {
       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;
 
@@ -2737,6 +4417,14 @@ export namespace ContractGetEditHistoryResponse {
       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`.
+       */
+      specifiers?: Array<UpdateCommit.Specifier> | null;
     }
 
     export namespace UpdateCommit {
@@ -2819,6 +4507,23 @@ export namespace ContractGetEditHistoryResponse {
           unit_price?: number;
         }
       }
+
+      export 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 UpdateCredit {
@@ -2882,7 +4587,7 @@ export namespace ContractGetEditHistoryResponse {
     export interface UpdateDiscount {
       id: string;
 
-      custom_fields?: Record<string, string>;
+      custom_fields?: { [key: string]: string };
 
       name?: string;
 
@@ -2931,7 +4636,7 @@ export namespace ContractGetEditHistoryResponse {
            */
           ending_before: string;
 
-          frequency: 'MONTHLY' | 'QUARTERLY' | 'SEMI_ANNUAL' | 'ANNUAL';
+          frequency: 'MONTHLY' | 'QUARTERLY' | 'SEMI_ANNUAL' | 'ANNUAL' | 'WEEKLY';
 
           /**
            * RFC 3339 timestamp (inclusive).
@@ -2967,29 +4672,219 @@ export namespace ContractGetEditHistoryResponse {
           timestamp: string;
 
           /**
-           * Amount for the charge. Can be provided instead of unit_price and quantity. If
-           * amount is sent, the unit_price is assumed to be the amount and quantity is
-           * inferred to be 1.
+           * Amount for the charge. Can be provided instead of unit_price and quantity. If
+           * amount is sent, the unit_price is assumed to be the amount and quantity is
+           * inferred to be 1.
+           */
+          amount?: number;
+
+          /**
+           * Quantity for the charge. Will be multiplied by unit_price to determine the
+           * amount and must be specified with unit_price. If specified amount cannot be
+           * provided.
+           */
+          quantity?: number;
+
+          /**
+           * Unit price for the charge. Will be multiplied by quantity to determine the
+           * amount and must be specified with quantity. If specified amount cannot be
+           * provided.
+           */
+          unit_price?: number;
+        }
+      }
+    }
+
+    export 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;
+    }
+
+    export namespace UpdatePrepaidBalanceThresholdConfiguration {
+      export 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`.
+         */
+        specifiers?: Array<Commit.Specifier> | null;
+      }
+
+      export namespace Commit {
+        export 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 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';
+      }
+
+      export namespace PaymentGateConfig {
+        /**
+         * Only applicable if using PRECALCULATED as your tax type.
+         */
+        export 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.
            */
-          amount?: number;
+          tax_name?: string;
+        }
 
+        /**
+         * Only applicable if using STRIPE as your payment gateway type.
+         */
+        export interface StripeConfig {
           /**
-           * Quantity for the charge. Will be multiplied by unit_price to determine the
-           * amount and must be specified with unit_price. If specified amount cannot be
-           * provided.
+           * If left blank, will default to INVOICE
            */
-          quantity?: number;
+          payment_type: 'INVOICE' | 'PAYMENT_INTENT';
 
           /**
-           * Unit price for the charge. Will be multiplied by quantity to determine the
-           * amount and must be specified with quantity. If specified amount cannot be
-           * provided.
+           * Metadata to be added to the Stripe invoice. Only applicable if using INVOICE as
+           * your payment type.
            */
-          unit_price?: number;
+          invoice_metadata?: { [key: string]: string };
         }
       }
     }
 
+    export interface UpdateRecurringCommit {
+      id: string;
+
+      access_amount?: UpdateRecurringCommit.AccessAmount;
+
+      ending_before?: string;
+
+      invoice_amount?: UpdateRecurringCommit.InvoiceAmount;
+    }
+
+    export namespace UpdateRecurringCommit {
+      export interface AccessAmount {
+        quantity?: number;
+
+        unit_price?: number;
+      }
+
+      export interface InvoiceAmount {
+        quantity?: number;
+
+        unit_price?: number;
+      }
+    }
+
+    export interface UpdateRecurringCredit {
+      id: string;
+
+      access_amount?: UpdateRecurringCredit.AccessAmount;
+
+      ending_before?: string;
+    }
+
+    export namespace UpdateRecurringCredit {
+      export interface AccessAmount {
+        quantity?: number;
+
+        unit_price?: number;
+      }
+    }
+
     export interface UpdateRefundInvoice {
       date: string;
 
@@ -3043,6 +4938,123 @@ export namespace ContractGetEditHistoryResponse {
         }
       }
     }
+
+    export 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;
+    }
+
+    export namespace UpdateSpendThresholdConfiguration {
+      export 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;
+      }
+
+      export 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';
+      }
+
+      export namespace PaymentGateConfig {
+        /**
+         * Only applicable if using PRECALCULATED as your tax type.
+         */
+        export 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.
+         */
+        export 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 };
+        }
+      }
+    }
+
+    export interface UpdateSubscription {
+      id: string;
+
+      ending_before?: string;
+
+      quantity_updates?: Array<UpdateSubscription.QuantityUpdate>;
+    }
+
+    export namespace UpdateSubscription {
+      export interface QuantityUpdate {
+        starting_at: string;
+
+        quantity?: number;
+
+        quantity_delta?: number;
+      }
+    }
   }
 }
 
@@ -3122,6 +5134,8 @@ export interface ContractEditParams {
 
   add_overrides?: Array<ContractEditParams.AddOverride>;
 
+  add_prepaid_balance_threshold_configuration?: ContractEditParams.AddPrepaidBalanceThresholdConfiguration;
+
   /**
    * This field's availability is dependent on your client's configuration.
    */
@@ -3135,11 +5149,82 @@ export interface ContractEditParams {
 
   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 namespace ContractEditParams {
@@ -3161,24 +5246,31 @@ export 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
@@ -3197,6 +5289,11 @@ export namespace ContractEditParams {
      */
     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.
@@ -3210,6 +5307,14 @@ export namespace ContractEditParams {
      */
     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`.
+     */
+    specifiers?: Array<AddCommit.Specifier>;
+
     /**
      * A temporary ID for the commit that can be used to reference the commit for
      * commit specific overrides.
@@ -3245,6 +5350,32 @@ export namespace ContractEditParams {
       }
     }
 
+    /**
+     * Optional configuration for commit hierarchy access control
+     */
+    export interface HierarchyConfiguration {
+      child_access:
+        | HierarchyConfiguration.CommitHierarchyChildAccessAll
+        | HierarchyConfiguration.CommitHierarchyChildAccessNone
+        | HierarchyConfiguration.CommitHierarchyChildAccessContractIDs;
+    }
+
+    export namespace HierarchyConfiguration {
+      export interface CommitHierarchyChildAccessAll {
+        type: 'ALL';
+      }
+
+      export interface CommitHierarchyChildAccessNone {
+        type: 'NONE';
+      }
+
+      export 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
@@ -3284,7 +5415,7 @@ export namespace ContractEditParams {
          */
         ending_before: string;
 
-        frequency: 'MONTHLY' | 'QUARTERLY' | 'SEMI_ANNUAL' | 'ANNUAL';
+        frequency: 'MONTHLY' | 'QUARTERLY' | 'SEMI_ANNUAL' | 'ANNUAL' | 'WEEKLY';
 
         /**
          * RFC 3339 timestamp (inclusive).
@@ -3341,6 +5472,88 @@ export namespace ContractEditParams {
         unit_price?: number;
       }
     }
+
+    /**
+     * optionally payment gate this commit
+     */
+    export 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';
+    }
+
+    export namespace PaymentGateConfig {
+      /**
+       * Only applicable if using PRECALCULATED as your tax type.
+       */
+      export 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.
+       */
+      export 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 };
+      }
+    }
+
+    export 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 AddCredit {
@@ -3363,13 +5576,18 @@ export namespace ContractEditParams {
      */
     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
      */
@@ -3387,6 +5605,14 @@ export 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`.
+     */
+    specifiers?: Array<AddCredit.Specifier>;
   }
 
   export namespace AddCredit {
@@ -3408,11 +5634,54 @@ export namespace ContractEditParams {
          */
         ending_before: string;
 
-        /**
-         * RFC 3339 timestamp (inclusive)
-         */
-        starting_at: string;
-      }
+        /**
+         * RFC 3339 timestamp (inclusive)
+         */
+        starting_at: string;
+      }
+    }
+
+    /**
+     * Optional configuration for credit hierarchy access control
+     */
+    export interface HierarchyConfiguration {
+      child_access:
+        | HierarchyConfiguration.CommitHierarchyChildAccessAll
+        | HierarchyConfiguration.CommitHierarchyChildAccessNone
+        | HierarchyConfiguration.CommitHierarchyChildAccessContractIDs;
+    }
+
+    export namespace HierarchyConfiguration {
+      export interface CommitHierarchyChildAccessAll {
+        type: 'ALL';
+      }
+
+      export interface CommitHierarchyChildAccessNone {
+        type: 'NONE';
+      }
+
+      export interface CommitHierarchyChildAccessContractIDs {
+        contract_ids: Array<string>;
+
+        type: 'CONTRACT_IDS';
+      }
+    }
+
+    export 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>;
     }
   }
 
@@ -3424,7 +5693,7 @@ export namespace ContractEditParams {
      */
     schedule: AddDiscount.Schedule;
 
-    custom_fields?: Record<string, string>;
+    custom_fields?: { [key: string]: string };
 
     /**
      * displayed on invoices
@@ -3474,7 +5743,7 @@ export namespace ContractEditParams {
          */
         ending_before: string;
 
-        frequency: 'MONTHLY' | 'QUARTERLY' | 'SEMI_ANNUAL' | 'ANNUAL';
+        frequency: 'MONTHLY' | 'QUARTERLY' | 'SEMI_ANNUAL' | 'ANNUAL' | 'WEEKLY';
 
         /**
          * RFC 3339 timestamp (inclusive).
@@ -3607,6 +5876,8 @@ export namespace ContractEditParams {
 
   export namespace AddOverride {
     export 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
@@ -3619,13 +5890,13 @@ export 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.
@@ -3667,7 +5938,7 @@ export 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
@@ -3699,6 +5970,157 @@ export namespace ContractEditParams {
     }
   }
 
+  export 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;
+  }
+
+  export namespace AddPrepaidBalanceThresholdConfiguration {
+    export 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`.
+       */
+      specifiers?: Array<Commit.Specifier>;
+    }
+
+    export namespace Commit {
+      export 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 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';
+    }
+
+    export namespace PaymentGateConfig {
+      /**
+       * Only applicable if using PRECALCULATED as your tax type.
+       */
+      export 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.
+       */
+      export 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 };
+      }
+    }
+  }
+
   export interface AddProfessionalService {
     /**
      * Maximum amount for the term.
@@ -3719,7 +6141,7 @@ export namespace ContractEditParams {
      */
     unit_price: number;
 
-    custom_fields?: Record<string, string>;
+    custom_fields?: { [key: string]: string };
 
     description?: string;
 
@@ -3736,7 +6158,9 @@ export 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;
 
@@ -3772,6 +6196,11 @@ export namespace ContractEditParams {
      */
     ending_before?: string;
 
+    /**
+     * Optional configuration for recurring commit/credit hierarchy access control
+     */
+    hierarchy_configuration?: AddRecurringCommit.HierarchyConfiguration;
+
     /**
      * The amount the customer should be billed for the commit. Not required.
      */
@@ -3802,10 +6231,10 @@ export 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
@@ -3814,6 +6243,14 @@ export namespace ContractEditParams {
      */
     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`.
+     */
+    specifiers?: Array<AddRecurringCommit.Specifier>;
+
     /**
      * A temporary ID that can be used to reference the recurring commit for commit
      * specific overrides.
@@ -3828,18 +6265,50 @@ export namespace ContractEditParams {
     export 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.
      */
     export interface CommitDuration {
-      unit: 'PERIODS';
-
       value: number;
+
+      unit?: 'PERIODS';
+    }
+
+    /**
+     * Optional configuration for recurring commit/credit hierarchy access control
+     */
+    export interface HierarchyConfiguration {
+      child_access:
+        | HierarchyConfiguration.CommitHierarchyChildAccessAll
+        | HierarchyConfiguration.CommitHierarchyChildAccessNone
+        | HierarchyConfiguration.CommitHierarchyChildAccessContractIDs;
+    }
+
+    export namespace HierarchyConfiguration {
+      export interface CommitHierarchyChildAccessAll {
+        type: 'ALL';
+      }
+
+      export interface CommitHierarchyChildAccessNone {
+        type: 'NONE';
+      }
+
+      export interface CommitHierarchyChildAccessContractIDs {
+        contract_ids: Array<string>;
+
+        type: 'CONTRACT_IDS';
+      }
     }
 
     /**
@@ -3852,6 +6321,23 @@ export namespace ContractEditParams {
 
       unit_price: number;
     }
+
+    export 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 AddRecurringCredit {
@@ -3861,7 +6347,9 @@ export 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;
 
@@ -3897,6 +6385,11 @@ export namespace ContractEditParams {
      */
     ending_before?: string;
 
+    /**
+     * Optional configuration for recurring commit/credit hierarchy access control
+     */
+    hierarchy_configuration?: AddRecurringCredit.HierarchyConfiguration;
+
     /**
      * displayed on invoices. will be passed through to the individual commits
      */
@@ -3922,10 +6415,10 @@ export 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
@@ -3934,6 +6427,14 @@ export namespace ContractEditParams {
      */
     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`.
+     */
+    specifiers?: Array<AddRecurringCredit.Specifier>;
+
     /**
      * A temporary ID that can be used to reference the recurring commit for commit
      * specific overrides.
@@ -3948,18 +6449,67 @@ export namespace ContractEditParams {
     export 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.
      */
     export interface CommitDuration {
-      unit: 'PERIODS';
-
       value: number;
+
+      unit?: 'PERIODS';
+    }
+
+    /**
+     * Optional configuration for recurring commit/credit hierarchy access control
+     */
+    export interface HierarchyConfiguration {
+      child_access:
+        | HierarchyConfiguration.CommitHierarchyChildAccessAll
+        | HierarchyConfiguration.CommitHierarchyChildAccessNone
+        | HierarchyConfiguration.CommitHierarchyChildAccessContractIDs;
+    }
+
+    export namespace HierarchyConfiguration {
+      export interface CommitHierarchyChildAccessAll {
+        type: 'ALL';
+      }
+
+      export interface CommitHierarchyChildAccessNone {
+        type: 'NONE';
+      }
+
+      export interface CommitHierarchyChildAccessContractIDs {
+        contract_ids: Array<string>;
+
+        type: 'CONTRACT_IDS';
+      }
+    }
+
+    export 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>;
     }
   }
 
@@ -4066,7 +6616,7 @@ export namespace ContractEditParams {
          */
         ending_before: string;
 
-        frequency: 'MONTHLY' | 'QUARTERLY' | 'SEMI_ANNUAL' | 'ANNUAL';
+        frequency: 'MONTHLY' | 'QUARTERLY' | 'SEMI_ANNUAL' | 'ANNUAL' | 'WEEKLY';
 
         /**
          * RFC 3339 timestamp (inclusive).
@@ -4125,23 +6675,203 @@ export namespace ContractEditParams {
     }
   }
 
+  export 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;
+  }
+
+  export namespace AddSpendThresholdConfiguration {
+    export 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;
+    }
+
+    export 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';
+    }
+
+    export namespace PaymentGateConfig {
+      /**
+       * Only applicable if using PRECALCULATED as your tax type.
+       */
+      export 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.
+       */
+      export 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 };
+      }
+    }
+  }
+
+  export 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;
+  }
+
+  export namespace AddSubscription {
+    export interface Proration {
+      /**
+       * Indicates how mid-period quantity adjustments are invoiced. If BILL_IMMEDIATELY
+       * is selected, the quantity increase will be billed on the scheduled date. If
+       * BILL_ON_NEXT_COLLECTION_DATE is selected, 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;
+    }
+
+    export 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;
+    }
+  }
+
+  export interface ArchiveCommit {
+    id: string;
+  }
+
+  export interface ArchiveCredit {
+    id: string;
+  }
+
+  export interface ArchiveScheduledCharge {
+    id: string;
+  }
+
+  export interface RemoveOverride {
+    id: string;
+  }
+
   export 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;
@@ -4184,6 +6914,32 @@ export namespace ContractEditParams {
       }
     }
 
+    /**
+     * Optional configuration for commit hierarchy access control
+     */
+    export interface HierarchyConfiguration {
+      child_access:
+        | HierarchyConfiguration.CommitHierarchyChildAccessAll
+        | HierarchyConfiguration.CommitHierarchyChildAccessNone
+        | HierarchyConfiguration.CommitHierarchyChildAccessContractIDs;
+    }
+
+    export namespace HierarchyConfiguration {
+      export interface CommitHierarchyChildAccessAll {
+        type: 'ALL';
+      }
+
+      export interface CommitHierarchyChildAccessNone {
+        type: 'NONE';
+      }
+
+      export interface CommitHierarchyChildAccessContractIDs {
+        contract_ids: Array<string>;
+
+        type: 'CONTRACT_IDS';
+      }
+    }
+
     export interface InvoiceSchedule {
       add_schedule_items?: Array<InvoiceSchedule.AddScheduleItem>;
 
@@ -4227,17 +6983,24 @@ export namespace ContractEditParams {
     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;
@@ -4275,6 +7038,222 @@ export namespace ContractEditParams {
         starting_at?: string;
       }
     }
+
+    /**
+     * Optional configuration for commit hierarchy access control
+     */
+    export interface HierarchyConfiguration {
+      child_access:
+        | HierarchyConfiguration.CommitHierarchyChildAccessAll
+        | HierarchyConfiguration.CommitHierarchyChildAccessNone
+        | HierarchyConfiguration.CommitHierarchyChildAccessContractIDs;
+    }
+
+    export namespace HierarchyConfiguration {
+      export interface CommitHierarchyChildAccessAll {
+        type: 'ALL';
+      }
+
+      export interface CommitHierarchyChildAccessNone {
+        type: 'NONE';
+      }
+
+      export interface CommitHierarchyChildAccessContractIDs {
+        contract_ids: Array<string>;
+
+        type: 'CONTRACT_IDS';
+      }
+    }
+  }
+
+  export 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;
+  }
+
+  export namespace UpdatePrepaidBalanceThresholdConfiguration {
+    export 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`.
+       */
+      specifiers?: Array<Commit.Specifier> | null;
+    }
+
+    export namespace Commit {
+      export 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 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';
+    }
+
+    export namespace PaymentGateConfig {
+      /**
+       * Only applicable if using PRECALCULATED as your tax type.
+       */
+      export 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.
+       */
+      export 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 };
+      }
+    }
+  }
+
+  export interface UpdateRecurringCommit {
+    recurring_commit_id: string;
+
+    access_amount?: UpdateRecurringCommit.AccessAmount;
+
+    ending_before?: string | null;
+
+    invoice_amount?: UpdateRecurringCommit.InvoiceAmount;
+  }
+
+  export namespace UpdateRecurringCommit {
+    export interface AccessAmount {
+      quantity?: number;
+
+      unit_price?: number;
+    }
+
+    export interface InvoiceAmount {
+      quantity?: number;
+
+      unit_price?: number;
+    }
+  }
+
+  export interface UpdateRecurringCredit {
+    recurring_credit_id: string;
+
+    access_amount?: UpdateRecurringCredit.AccessAmount;
+
+    ending_before?: string | null;
+  }
+
+  export namespace UpdateRecurringCredit {
+    export interface AccessAmount {
+      quantity?: number;
+
+      unit_price?: number;
+    }
   }
 
   export interface UpdateScheduledCharge {
@@ -4322,6 +7301,137 @@ export namespace ContractEditParams {
       }
     }
   }
+
+  export 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;
+  }
+
+  export namespace UpdateSpendThresholdConfiguration {
+    export 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;
+    }
+
+    export 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';
+    }
+
+    export namespace PaymentGateConfig {
+      /**
+       * Only applicable if using PRECALCULATED as your tax type.
+       */
+      export 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.
+       */
+      export 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 };
+      }
+    }
+  }
+
+  export 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>;
+  }
+
+  export namespace UpdateSubscription {
+    export 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 {
@@ -4338,14 +7448,16 @@ export interface ContractEditCommitParams {
   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;
 
@@ -4357,6 +7469,14 @@ export interface ContractEditCommitParams {
   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`.
+   */
+  specifiers?: Array<ContractEditCommitParams.Specifier> | null;
 }
 
 export namespace ContractEditCommitParams {
@@ -4427,6 +7547,23 @@ export namespace ContractEditCommitParams {
       unit_price?: number;
     }
   }
+
+  export 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 {
@@ -4455,6 +7592,14 @@ 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`.
+   */
+  specifiers?: Array<ContractEditCreditParams.Specifier> | null;
 }
 
 export namespace ContractEditCreditParams {
@@ -4489,6 +7634,23 @@ export namespace ContractEditCreditParams {
       starting_at?: string;
     }
   }
+
+  export 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 {