autumn-js 1.2.37 → 1.2.39

package/dist/backend/{routeTypes-M8hsq6U-.d.mts → routeTypes-CIqS7yVo.d.mts}

@@ -6181,6 +6181,17 @@ declare const CreateEntityLimitTypeResponse: {
  * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
  */
 type CreateEntityLimitTypeResponse = OpenEnum<typeof CreateEntityLimitTypeResponse>;
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+declare const CreateEntitySpendLimitSource: {
+    readonly Customer: "customer";
+    readonly Plan: "plan";
+};
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+type CreateEntitySpendLimitSource = OpenEnum<typeof CreateEntitySpendLimitSource>;
 type CreateEntitySpendLimitResponse = {
     /**
      * Optional feature ID this spend limit applies to.
@@ -6202,6 +6213,10 @@ type CreateEntitySpendLimitResponse = {
      * When true, overage for this feature is not posted to Stripe. Usage tracking and balance resets still behave normally.
      */
     skipOverageBilling?: boolean | undefined;
+    /**
+     * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+     */
+    source?: CreateEntitySpendLimitSource | undefined;
 };
 /**
  * Interval for the cap, aligned to the customer's billing cycle.
@@ -6224,6 +6239,17 @@ type CreateEntityFilterResponse = {
         [k: string]: any;
     };
 };
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+declare const CreateEntityUsageLimitSource: {
+    readonly Customer: "customer";
+    readonly Plan: "plan";
+};
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+type CreateEntityUsageLimitSource = OpenEnum<typeof CreateEntityUsageLimitSource>;
 type CreateEntityUsageLimitResponse = {
     /**
      * The feature this usage limit applies to.
@@ -6249,6 +6275,10 @@ type CreateEntityUsageLimitResponse = {
      * Current usage already consumed in the active interval. Response-only; not stored on billing controls.
      */
     usage?: number | undefined;
+    /**
+     * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+     */
+    source?: CreateEntityUsageLimitSource | undefined;
 };
 /**
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
@@ -6263,6 +6293,17 @@ declare const CreateEntityThresholdTypeResponse: {
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
  */
 type CreateEntityThresholdTypeResponse = OpenEnum<typeof CreateEntityThresholdTypeResponse>;
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+declare const CreateEntityUsageAlertSource: {
+    readonly Customer: "customer";
+    readonly Plan: "plan";
+};
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+type CreateEntityUsageAlertSource = OpenEnum<typeof CreateEntityUsageAlertSource>;
 type CreateEntityUsageAlertResponse = {
     /**
      * The feature ID this alert applies to.
@@ -6284,7 +6325,22 @@ type CreateEntityUsageAlertResponse = {
      * Optional user-defined label to distinguish multiple alerts on the same feature.
      */
     name?: string | undefined;
+    /**
+     * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+     */
+    source?: CreateEntityUsageAlertSource | undefined;
 };
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+declare const CreateEntityOverageAllowedSource: {
+    readonly Customer: "customer";
+    readonly Plan: "plan";
+};
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+type CreateEntityOverageAllowedSource = OpenEnum<typeof CreateEntityOverageAllowedSource>;
 type CreateEntityOverageAllowedResponse = {
     /**
      * The feature ID this overage allowed control applies to.
@@ -6294,6 +6350,10 @@ type CreateEntityOverageAllowedResponse = {
      * Whether overage is allowed for this feature.
      */
     enabled: boolean;
+    /**
+     * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+     */
+    source?: CreateEntityOverageAllowedSource | undefined;
 };
 /**
  * Billing controls for the entity.
@@ -9444,18 +9504,45 @@ declare const CustomerEnv: {
  * The environment this customer was created in.
  */
 type CustomerEnv = OpenEnum<typeof CustomerEnv>;
+/**
+ * The time interval for the purchase limit window.
+ */
 declare const CustomerPurchaseLimitInterval2: {
     readonly Hour: "hour";
     readonly Day: "day";
     readonly Week: "week";
     readonly Month: "month";
 };
+/**
+ * The time interval for the purchase limit window.
+ */
 type CustomerPurchaseLimitInterval2 = OpenEnum<typeof CustomerPurchaseLimitInterval2>;
 type CustomerPurchaseLimit2 = {
+    /**
+     * The time interval for the purchase limit window.
+     */
+    interval: CustomerPurchaseLimitInterval2;
+    /**
+     * Number of intervals in the purchase limit window.
+     */
+    intervalCount: number;
+    /**
+     * Maximum number of auto top-ups allowed within the interval.
+     */
+    limit: number;
+};
+declare const CustomerPurchaseLimitInterval1: {
+    readonly Hour: "hour";
+    readonly Day: "day";
+    readonly Week: "week";
+    readonly Month: "month";
+};
+type CustomerPurchaseLimitInterval1 = OpenEnum<typeof CustomerPurchaseLimitInterval1>;
+type CustomerPurchaseLimit1 = {
     /**
      * The time interval for the purchase limit window. Null when no purchase limit is configured.
      */
-    interval: CustomerPurchaseLimitInterval2 | null;
+    interval: CustomerPurchaseLimitInterval1 | null;
     /**
      * Number of intervals in the purchase limit window. Null when no purchase limit is configured.
      */
@@ -9474,32 +9561,16 @@ type CustomerPurchaseLimit2 = {
     nextResetAt: number;
 };
 /**
- * The time interval for the purchase limit window.
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
  */
-declare const CustomerPurchaseLimitInterval1: {
-    readonly Hour: "hour";
-    readonly Day: "day";
-    readonly Week: "week";
-    readonly Month: "month";
+declare const AutoTopupSource: {
+    readonly Customer: "customer";
+    readonly Plan: "plan";
 };
 /**
- * The time interval for the purchase limit window.
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
  */
-type CustomerPurchaseLimitInterval1 = OpenEnum<typeof CustomerPurchaseLimitInterval1>;
-type CustomerPurchaseLimit1 = {
-    /**
-     * The time interval for the purchase limit window.
-     */
-    interval: CustomerPurchaseLimitInterval1;
-    /**
-     * Number of intervals in the purchase limit window.
-     */
-    intervalCount: number;
-    /**
-     * Maximum number of auto top-ups allowed within the interval.
-     */
-    limit: number;
-};
+type AutoTopupSource = OpenEnum<typeof AutoTopupSource>;
 type CustomerAutoTopup = {
     /**
      * The ID of the feature (credit balance) to auto top-up.
@@ -9520,11 +9591,15 @@ type CustomerAutoTopup = {
     /**
      * Optional rate limit to cap how often auto top-ups occur. Expand billing_controls.auto_topups.purchase_limit for a count of top ups and the next_reset_at.
      */
-    purchaseLimit?: CustomerPurchaseLimit2 | CustomerPurchaseLimit1 | undefined;
+    purchaseLimit?: CustomerPurchaseLimit1 | CustomerPurchaseLimit2 | undefined;
     /**
      * When true, auto top-up creates a send_invoice invoice instead of auto-charging.
      */
     invoiceMode?: boolean | undefined;
+    /**
+     * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+     */
+    source?: AutoTopupSource | undefined;
 };
 /**
  * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
@@ -9537,6 +9612,17 @@ declare const CustomerLimitType: {
  * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
  */
 type CustomerLimitType = OpenEnum<typeof CustomerLimitType>;
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+declare const SpendLimitSource: {
+    readonly Customer: "customer";
+    readonly Plan: "plan";
+};
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+type SpendLimitSource = OpenEnum<typeof SpendLimitSource>;
 type CustomerSpendLimit = {
     /**
      * Optional feature ID this spend limit applies to.
@@ -9558,6 +9644,10 @@ type CustomerSpendLimit = {
      * When true, overage for this feature is not posted to Stripe. Usage tracking and balance resets still behave normally.
      */
     skipOverageBilling?: boolean | undefined;
+    /**
+     * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+     */
+    source?: SpendLimitSource | undefined;
 };
 /**
  * Interval for the cap, aligned to the customer's billing cycle.
@@ -9580,6 +9670,17 @@ type CustomerFilter = {
         [k: string]: any;
     };
 };
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+declare const UsageLimitSource: {
+    readonly Customer: "customer";
+    readonly Plan: "plan";
+};
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+type UsageLimitSource = OpenEnum<typeof UsageLimitSource>;
 type CustomerUsageLimit = {
     /**
      * The feature this usage limit applies to.
@@ -9605,6 +9706,10 @@ type CustomerUsageLimit = {
      * Current usage already consumed in the active interval. Response-only; not stored on billing controls.
      */
     usage?: number | undefined;
+    /**
+     * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+     */
+    source?: UsageLimitSource | undefined;
 };
 /**
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
@@ -9619,6 +9724,17 @@ declare const CustomerThresholdType: {
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
  */
 type CustomerThresholdType = OpenEnum<typeof CustomerThresholdType>;
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+declare const UsageAlertSource: {
+    readonly Customer: "customer";
+    readonly Plan: "plan";
+};
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+type UsageAlertSource = OpenEnum<typeof UsageAlertSource>;
 type CustomerUsageAlert = {
     /**
      * The feature ID this alert applies to.
@@ -9640,7 +9756,22 @@ type CustomerUsageAlert = {
      * Optional user-defined label to distinguish multiple alerts on the same feature.
      */
     name?: string | undefined;
+    /**
+     * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+     */
+    source?: UsageAlertSource | undefined;
+};
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+declare const OverageAllowedSource: {
+    readonly Customer: "customer";
+    readonly Plan: "plan";
 };
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+type OverageAllowedSource = OpenEnum<typeof OverageAllowedSource>;
 type CustomerOverageAllowed = {
     /**
      * The feature ID this overage allowed control applies to.
@@ -9650,6 +9781,10 @@ type CustomerOverageAllowed = {
      * Whether overage is allowed for this feature.
      */
     enabled: boolean;
+    /**
+     * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+     */
+    source?: OverageAllowedSource | undefined;
 };
 /**
  * Billing controls for the customer (auto top-ups, etc.)
@@ -10425,18 +10560,45 @@ declare const GetCustomerEnv: {
  * The environment this customer was created in.
  */
 type GetCustomerEnv = OpenEnum<typeof GetCustomerEnv>;
+/**
+ * The time interval for the purchase limit window.
+ */
 declare const GetCustomerPurchaseLimitInterval2: {
     readonly Hour: "hour";
     readonly Day: "day";
     readonly Week: "week";
     readonly Month: "month";
 };
+/**
+ * The time interval for the purchase limit window.
+ */
 type GetCustomerPurchaseLimitInterval2 = OpenEnum<typeof GetCustomerPurchaseLimitInterval2>;
 type GetCustomerPurchaseLimit2 = {
+    /**
+     * The time interval for the purchase limit window.
+     */
+    interval: GetCustomerPurchaseLimitInterval2;
+    /**
+     * Number of intervals in the purchase limit window.
+     */
+    intervalCount: number;
+    /**
+     * Maximum number of auto top-ups allowed within the interval.
+     */
+    limit: number;
+};
+declare const GetCustomerPurchaseLimitInterval1: {
+    readonly Hour: "hour";
+    readonly Day: "day";
+    readonly Week: "week";
+    readonly Month: "month";
+};
+type GetCustomerPurchaseLimitInterval1 = OpenEnum<typeof GetCustomerPurchaseLimitInterval1>;
+type GetCustomerPurchaseLimit1 = {
     /**
      * The time interval for the purchase limit window. Null when no purchase limit is configured.
      */
-    interval: GetCustomerPurchaseLimitInterval2 | null;
+    interval: GetCustomerPurchaseLimitInterval1 | null;
     /**
      * Number of intervals in the purchase limit window. Null when no purchase limit is configured.
      */
@@ -10455,32 +10617,16 @@ type GetCustomerPurchaseLimit2 = {
     nextResetAt: number;
 };
 /**
- * The time interval for the purchase limit window.
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
  */
-declare const GetCustomerPurchaseLimitInterval1: {
-    readonly Hour: "hour";
-    readonly Day: "day";
-    readonly Week: "week";
-    readonly Month: "month";
+declare const GetCustomerAutoTopupSource: {
+    readonly Customer: "customer";
+    readonly Plan: "plan";
 };
 /**
- * The time interval for the purchase limit window.
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
  */
-type GetCustomerPurchaseLimitInterval1 = OpenEnum<typeof GetCustomerPurchaseLimitInterval1>;
-type GetCustomerPurchaseLimit1 = {
-    /**
-     * The time interval for the purchase limit window.
-     */
-    interval: GetCustomerPurchaseLimitInterval1;
-    /**
-     * Number of intervals in the purchase limit window.
-     */
-    intervalCount: number;
-    /**
-     * Maximum number of auto top-ups allowed within the interval.
-     */
-    limit: number;
-};
+type GetCustomerAutoTopupSource = OpenEnum<typeof GetCustomerAutoTopupSource>;
 type GetCustomerAutoTopup = {
     /**
      * The ID of the feature (credit balance) to auto top-up.
@@ -10501,11 +10647,15 @@ type GetCustomerAutoTopup = {
     /**
      * Optional rate limit to cap how often auto top-ups occur. Expand billing_controls.auto_topups.purchase_limit for a count of top ups and the next_reset_at.
      */
-    purchaseLimit?: GetCustomerPurchaseLimit2 | GetCustomerPurchaseLimit1 | undefined;
+    purchaseLimit?: GetCustomerPurchaseLimit1 | GetCustomerPurchaseLimit2 | undefined;
     /**
      * When true, auto top-up creates a send_invoice invoice instead of auto-charging.
      */
     invoiceMode?: boolean | undefined;
+    /**
+     * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+     */
+    source?: GetCustomerAutoTopupSource | undefined;
 };
 /**
  * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
@@ -10518,6 +10668,17 @@ declare const GetCustomerLimitType: {
  * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
  */
 type GetCustomerLimitType = OpenEnum<typeof GetCustomerLimitType>;
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+declare const GetCustomerSpendLimitSource: {
+    readonly Customer: "customer";
+    readonly Plan: "plan";
+};
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+type GetCustomerSpendLimitSource = OpenEnum<typeof GetCustomerSpendLimitSource>;
 type GetCustomerSpendLimit = {
     /**
      * Optional feature ID this spend limit applies to.
@@ -10539,6 +10700,10 @@ type GetCustomerSpendLimit = {
      * When true, overage for this feature is not posted to Stripe. Usage tracking and balance resets still behave normally.
      */
     skipOverageBilling?: boolean | undefined;
+    /**
+     * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+     */
+    source?: GetCustomerSpendLimitSource | undefined;
 };
 /**
  * Interval for the cap, aligned to the customer's billing cycle.
@@ -10561,6 +10726,17 @@ type GetCustomerFilter = {
         [k: string]: any;
     };
 };
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+declare const GetCustomerUsageLimitSource: {
+    readonly Customer: "customer";
+    readonly Plan: "plan";
+};
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+type GetCustomerUsageLimitSource = OpenEnum<typeof GetCustomerUsageLimitSource>;
 type GetCustomerUsageLimit = {
     /**
      * The feature this usage limit applies to.
@@ -10586,6 +10762,10 @@ type GetCustomerUsageLimit = {
      * Current usage already consumed in the active interval. Response-only; not stored on billing controls.
      */
     usage?: number | undefined;
+    /**
+     * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+     */
+    source?: GetCustomerUsageLimitSource | undefined;
 };
 /**
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
@@ -10600,6 +10780,17 @@ declare const GetCustomerThresholdType: {
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
  */
 type GetCustomerThresholdType = OpenEnum<typeof GetCustomerThresholdType>;
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+declare const GetCustomerUsageAlertSource: {
+    readonly Customer: "customer";
+    readonly Plan: "plan";
+};
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+type GetCustomerUsageAlertSource = OpenEnum<typeof GetCustomerUsageAlertSource>;
 type GetCustomerUsageAlert = {
     /**
      * The feature ID this alert applies to.
@@ -10621,7 +10812,22 @@ type GetCustomerUsageAlert = {
      * Optional user-defined label to distinguish multiple alerts on the same feature.
      */
     name?: string | undefined;
+    /**
+     * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+     */
+    source?: GetCustomerUsageAlertSource | undefined;
+};
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+declare const GetCustomerOverageAllowedSource: {
+    readonly Customer: "customer";
+    readonly Plan: "plan";
 };
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+type GetCustomerOverageAllowedSource = OpenEnum<typeof GetCustomerOverageAllowedSource>;
 type GetCustomerOverageAllowed = {
     /**
      * The feature ID this overage allowed control applies to.
@@ -10631,6 +10837,10 @@ type GetCustomerOverageAllowed = {
      * Whether overage is allowed for this feature.
      */
     enabled: boolean;
+    /**
+     * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+     */
+    source?: GetCustomerOverageAllowedSource | undefined;
 };
 /**
  * Billing controls for the customer (auto top-ups, etc.)
@@ -11494,6 +11704,17 @@ declare const GetEntityLimitType: {
  * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
  */
 type GetEntityLimitType = OpenEnum<typeof GetEntityLimitType>;
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+declare const GetEntitySpendLimitSource: {
+    readonly Customer: "customer";
+    readonly Plan: "plan";
+};
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+type GetEntitySpendLimitSource = OpenEnum<typeof GetEntitySpendLimitSource>;
 type GetEntitySpendLimit = {
     /**
      * Optional feature ID this spend limit applies to.
@@ -11515,6 +11736,10 @@ type GetEntitySpendLimit = {
      * When true, overage for this feature is not posted to Stripe. Usage tracking and balance resets still behave normally.
      */
     skipOverageBilling?: boolean | undefined;
+    /**
+     * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+     */
+    source?: GetEntitySpendLimitSource | undefined;
 };
 /**
  * Interval for the cap, aligned to the customer's billing cycle.
@@ -11537,6 +11762,17 @@ type GetEntityFilter = {
         [k: string]: any;
     };
 };
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+declare const GetEntityUsageLimitSource: {
+    readonly Customer: "customer";
+    readonly Plan: "plan";
+};
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+type GetEntityUsageLimitSource = OpenEnum<typeof GetEntityUsageLimitSource>;
 type GetEntityUsageLimit = {
     /**
      * The feature this usage limit applies to.
@@ -11562,6 +11798,10 @@ type GetEntityUsageLimit = {
      * Current usage already consumed in the active interval. Response-only; not stored on billing controls.
      */
     usage?: number | undefined;
+    /**
+     * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+     */
+    source?: GetEntityUsageLimitSource | undefined;
 };
 /**
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
@@ -11576,6 +11816,17 @@ declare const GetEntityThresholdType: {
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
  */
 type GetEntityThresholdType = OpenEnum<typeof GetEntityThresholdType>;
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+declare const GetEntityUsageAlertSource: {
+    readonly Customer: "customer";
+    readonly Plan: "plan";
+};
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+type GetEntityUsageAlertSource = OpenEnum<typeof GetEntityUsageAlertSource>;
 type GetEntityUsageAlert = {
     /**
      * The feature ID this alert applies to.
@@ -11597,7 +11848,22 @@ type GetEntityUsageAlert = {
      * Optional user-defined label to distinguish multiple alerts on the same feature.
      */
     name?: string | undefined;
+    /**
+     * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+     */
+    source?: GetEntityUsageAlertSource | undefined;
+};
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+declare const GetEntityOverageAllowedSource: {
+    readonly Customer: "customer";
+    readonly Plan: "plan";
 };
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+type GetEntityOverageAllowedSource = OpenEnum<typeof GetEntityOverageAllowedSource>;
 type GetEntityOverageAllowed = {
     /**
      * The feature ID this overage allowed control applies to.
@@ -11607,6 +11873,10 @@ type GetEntityOverageAllowed = {
      * Whether overage is allowed for this feature.
      */
     enabled: boolean;
+    /**
+     * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+     */
+    source?: GetEntityOverageAllowedSource | undefined;
 };
 /**
  * Billing controls for the entity.
@@ -13524,18 +13794,45 @@ declare const ListCustomersEnv: {
  * The environment this customer was created in.
  */
 type ListCustomersEnv = OpenEnum<typeof ListCustomersEnv>;
+/**
+ * The time interval for the purchase limit window.
+ */
 declare const ListCustomersPurchaseLimitInterval2: {
     readonly Hour: "hour";
     readonly Day: "day";
     readonly Week: "week";
     readonly Month: "month";
 };
+/**
+ * The time interval for the purchase limit window.
+ */
 type ListCustomersPurchaseLimitInterval2 = OpenEnum<typeof ListCustomersPurchaseLimitInterval2>;
 type ListCustomersPurchaseLimit2 = {
+    /**
+     * The time interval for the purchase limit window.
+     */
+    interval: ListCustomersPurchaseLimitInterval2;
+    /**
+     * Number of intervals in the purchase limit window.
+     */
+    intervalCount: number;
+    /**
+     * Maximum number of auto top-ups allowed within the interval.
+     */
+    limit: number;
+};
+declare const ListCustomersPurchaseLimitInterval1: {
+    readonly Hour: "hour";
+    readonly Day: "day";
+    readonly Week: "week";
+    readonly Month: "month";
+};
+type ListCustomersPurchaseLimitInterval1 = OpenEnum<typeof ListCustomersPurchaseLimitInterval1>;
+type ListCustomersPurchaseLimit1 = {
     /**
      * The time interval for the purchase limit window. Null when no purchase limit is configured.
      */
-    interval: ListCustomersPurchaseLimitInterval2 | null;
+    interval: ListCustomersPurchaseLimitInterval1 | null;
     /**
      * Number of intervals in the purchase limit window. Null when no purchase limit is configured.
      */
@@ -13554,32 +13851,16 @@ type ListCustomersPurchaseLimit2 = {
     nextResetAt: number;
 };
 /**
- * The time interval for the purchase limit window.
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
  */
-declare const ListCustomersPurchaseLimitInterval1: {
-    readonly Hour: "hour";
-    readonly Day: "day";
-    readonly Week: "week";
-    readonly Month: "month";
+declare const ListCustomersAutoTopupSource: {
+    readonly Customer: "customer";
+    readonly Plan: "plan";
 };
 /**
- * The time interval for the purchase limit window.
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
  */
-type ListCustomersPurchaseLimitInterval1 = OpenEnum<typeof ListCustomersPurchaseLimitInterval1>;
-type ListCustomersPurchaseLimit1 = {
-    /**
-     * The time interval for the purchase limit window.
-     */
-    interval: ListCustomersPurchaseLimitInterval1;
-    /**
-     * Number of intervals in the purchase limit window.
-     */
-    intervalCount: number;
-    /**
-     * Maximum number of auto top-ups allowed within the interval.
-     */
-    limit: number;
-};
+type ListCustomersAutoTopupSource = OpenEnum<typeof ListCustomersAutoTopupSource>;
 type ListCustomersAutoTopup = {
     /**
      * The ID of the feature (credit balance) to auto top-up.
@@ -13600,11 +13881,15 @@ type ListCustomersAutoTopup = {
     /**
      * Optional rate limit to cap how often auto top-ups occur. Expand billing_controls.auto_topups.purchase_limit for a count of top ups and the next_reset_at.
      */
-    purchaseLimit?: ListCustomersPurchaseLimit2 | ListCustomersPurchaseLimit1 | undefined;
+    purchaseLimit?: ListCustomersPurchaseLimit1 | ListCustomersPurchaseLimit2 | undefined;
     /**
      * When true, auto top-up creates a send_invoice invoice instead of auto-charging.
      */
     invoiceMode?: boolean | undefined;
+    /**
+     * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+     */
+    source?: ListCustomersAutoTopupSource | undefined;
 };
 /**
  * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
@@ -13617,6 +13902,17 @@ declare const ListCustomersLimitType: {
  * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
  */
 type ListCustomersLimitType = OpenEnum<typeof ListCustomersLimitType>;
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+declare const ListCustomersSpendLimitSource: {
+    readonly Customer: "customer";
+    readonly Plan: "plan";
+};
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+type ListCustomersSpendLimitSource = OpenEnum<typeof ListCustomersSpendLimitSource>;
 type ListCustomersSpendLimit = {
     /**
      * Optional feature ID this spend limit applies to.
@@ -13638,6 +13934,10 @@ type ListCustomersSpendLimit = {
      * When true, overage for this feature is not posted to Stripe. Usage tracking and balance resets still behave normally.
      */
     skipOverageBilling?: boolean | undefined;
+    /**
+     * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+     */
+    source?: ListCustomersSpendLimitSource | undefined;
 };
 /**
  * Interval for the cap, aligned to the customer's billing cycle.
@@ -13660,6 +13960,17 @@ type ListCustomersFilter = {
         [k: string]: any;
     };
 };
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+declare const ListCustomersUsageLimitSource: {
+    readonly Customer: "customer";
+    readonly Plan: "plan";
+};
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+type ListCustomersUsageLimitSource = OpenEnum<typeof ListCustomersUsageLimitSource>;
 type ListCustomersUsageLimit = {
     /**
      * The feature this usage limit applies to.
@@ -13685,6 +13996,10 @@ type ListCustomersUsageLimit = {
      * Current usage already consumed in the active interval. Response-only; not stored on billing controls.
      */
     usage?: number | undefined;
+    /**
+     * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+     */
+    source?: ListCustomersUsageLimitSource | undefined;
 };
 /**
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
@@ -13699,6 +14014,17 @@ declare const ListCustomersThresholdType: {
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
  */
 type ListCustomersThresholdType = OpenEnum<typeof ListCustomersThresholdType>;
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+declare const ListCustomersUsageAlertSource: {
+    readonly Customer: "customer";
+    readonly Plan: "plan";
+};
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+type ListCustomersUsageAlertSource = OpenEnum<typeof ListCustomersUsageAlertSource>;
 type ListCustomersUsageAlert = {
     /**
      * The feature ID this alert applies to.
@@ -13720,7 +14046,22 @@ type ListCustomersUsageAlert = {
      * Optional user-defined label to distinguish multiple alerts on the same feature.
      */
     name?: string | undefined;
+    /**
+     * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+     */
+    source?: ListCustomersUsageAlertSource | undefined;
+};
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+declare const ListCustomersOverageAllowedSource: {
+    readonly Customer: "customer";
+    readonly Plan: "plan";
 };
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+type ListCustomersOverageAllowedSource = OpenEnum<typeof ListCustomersOverageAllowedSource>;
 type ListCustomersOverageAllowed = {
     /**
      * The feature ID this overage allowed control applies to.
@@ -13730,6 +14071,10 @@ type ListCustomersOverageAllowed = {
      * Whether overage is allowed for this feature.
      */
     enabled: boolean;
+    /**
+     * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+     */
+    source?: ListCustomersOverageAllowedSource | undefined;
 };
 /**
  * Billing controls for the customer (auto top-ups, etc.)
@@ -14444,6 +14789,17 @@ declare const ListEntitiesLimitType: {
  * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
  */
 type ListEntitiesLimitType = OpenEnum<typeof ListEntitiesLimitType>;
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+declare const ListEntitiesSpendLimitSource: {
+    readonly Customer: "customer";
+    readonly Plan: "plan";
+};
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+type ListEntitiesSpendLimitSource = OpenEnum<typeof ListEntitiesSpendLimitSource>;
 type ListEntitiesSpendLimit = {
     /**
      * Optional feature ID this spend limit applies to.
@@ -14465,6 +14821,10 @@ type ListEntitiesSpendLimit = {
      * When true, overage for this feature is not posted to Stripe. Usage tracking and balance resets still behave normally.
      */
     skipOverageBilling?: boolean | undefined;
+    /**
+     * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+     */
+    source?: ListEntitiesSpendLimitSource | undefined;
 };
 /**
  * Interval for the cap, aligned to the customer's billing cycle.
@@ -14487,6 +14847,17 @@ type ListEntitiesFilter = {
         [k: string]: any;
     };
 };
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+declare const ListEntitiesUsageLimitSource: {
+    readonly Customer: "customer";
+    readonly Plan: "plan";
+};
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+type ListEntitiesUsageLimitSource = OpenEnum<typeof ListEntitiesUsageLimitSource>;
 type ListEntitiesUsageLimit = {
     /**
      * The feature this usage limit applies to.
@@ -14512,6 +14883,10 @@ type ListEntitiesUsageLimit = {
      * Current usage already consumed in the active interval. Response-only; not stored on billing controls.
      */
     usage?: number | undefined;
+    /**
+     * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+     */
+    source?: ListEntitiesUsageLimitSource | undefined;
 };
 /**
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
@@ -14526,6 +14901,17 @@ declare const ListEntitiesThresholdType: {
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
  */
 type ListEntitiesThresholdType = OpenEnum<typeof ListEntitiesThresholdType>;
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+declare const ListEntitiesUsageAlertSource: {
+    readonly Customer: "customer";
+    readonly Plan: "plan";
+};
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+type ListEntitiesUsageAlertSource = OpenEnum<typeof ListEntitiesUsageAlertSource>;
 type ListEntitiesUsageAlert = {
     /**
      * The feature ID this alert applies to.
@@ -14547,7 +14933,22 @@ type ListEntitiesUsageAlert = {
      * Optional user-defined label to distinguish multiple alerts on the same feature.
      */
     name?: string | undefined;
+    /**
+     * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+     */
+    source?: ListEntitiesUsageAlertSource | undefined;
+};
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+declare const ListEntitiesOverageAllowedSource: {
+    readonly Customer: "customer";
+    readonly Plan: "plan";
 };
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+type ListEntitiesOverageAllowedSource = OpenEnum<typeof ListEntitiesOverageAllowedSource>;
 type ListEntitiesOverageAllowed = {
     /**
      * The feature ID this overage allowed control applies to.
@@ -14557,6 +14958,10 @@ type ListEntitiesOverageAllowed = {
      * Whether overage is allowed for this feature.
      */
     enabled: boolean;
+    /**
+     * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+     */
+    source?: ListEntitiesOverageAllowedSource | undefined;
 };
 /**
  * Billing controls for the entity.
@@ -17057,6 +17462,142 @@ type MultiAttachResponse = {
     requiredAction?: MultiAttachRequiredAction | undefined;
 };
 
+/**
+ * Action to perform for cancellation. 'cancel_immediately' cancels now with prorated refund, 'cancel_end_of_cycle' cancels at period end, 'uncancel' reverses a pending cancellation.
+ */
+declare const MultiUpdateCancelAction: {
+    readonly CancelImmediately: "cancel_immediately";
+    readonly CancelEndOfCycle: "cancel_end_of_cycle";
+    readonly Uncancel: "uncancel";
+};
+/**
+ * Action to perform for cancellation. 'cancel_immediately' cancels now with prorated refund, 'cancel_end_of_cycle' cancels at period end, 'uncancel' reverses a pending cancellation.
+ */
+type MultiUpdateCancelAction = ClosedEnum<typeof MultiUpdateCancelAction>;
+/**
+ * How to handle proration for this update. 'prorate_immediately' charges/credits prorated amounts now, 'none' skips creating any charges.
+ */
+declare const MultiUpdateProrationBehavior: {
+    readonly ProrateImmediately: "prorate_immediately";
+    readonly None: "none";
+};
+/**
+ * How to handle proration for this update. 'prorate_immediately' charges/credits prorated amounts now, 'none' skips creating any charges.
+ */
+type MultiUpdateProrationBehavior = ClosedEnum<typeof MultiUpdateProrationBehavior>;
+type MultiUpdateUpdate = {
+    /**
+     * The ID of the plan to update. Optional if subscription_id is provided.
+     */
+    planId?: string | undefined;
+    /**
+     * A unique ID to identify the subscription to update. Useful when a customer has multiple products with the same plan.
+     */
+    subscriptionId?: string | undefined;
+    /**
+     * The ID of the entity this update targets. Overrides the top-level entity_id for this update.
+     */
+    entityId?: string | undefined;
+    /**
+     * Action to perform for cancellation. 'cancel_immediately' cancels now with prorated refund, 'cancel_end_of_cycle' cancels at period end, 'uncancel' reverses a pending cancellation.
+     */
+    cancelAction: MultiUpdateCancelAction;
+    /**
+     * How to handle proration for this update. 'prorate_immediately' charges/credits prorated amounts now, 'none' skips creating any charges.
+     */
+    prorationBehavior?: MultiUpdateProrationBehavior | undefined;
+};
+type MultiUpdateParams = {
+    /**
+     * The ID of the customer to update plans for.
+     */
+    customerId: string;
+    /**
+     * The ID of the entity to update plans for. Individual updates can override this with their own entity_id.
+     */
+    entityId?: string | undefined;
+    /**
+     * The list of plan updates to apply to the customer.
+     */
+    updates: Array<MultiUpdateUpdate>;
+};
+/**
+ * Invoice details if an invoice was created. Only present when a charge was made.
+ */
+type MultiUpdateInvoice = {
+    /**
+     * The status of the invoice (e.g., 'paid', 'open', 'draft').
+     */
+    status: string | null;
+    /**
+     * The Stripe invoice ID.
+     */
+    stripeId: string;
+    /**
+     * The total amount of the invoice in cents.
+     */
+    total: number;
+    /**
+     * The three-letter ISO currency code (e.g., 'usd').
+     */
+    currency: string;
+    /**
+     * URL to the hosted invoice page where the customer can view and pay the invoice.
+     */
+    hostedInvoiceUrl: string | null;
+};
+/**
+ * The type of action required to complete the payment.
+ */
+declare const MultiUpdateCode: {
+    readonly ThreedsRequired: "3ds_required";
+    readonly PaymentMethodRequired: "payment_method_required";
+    readonly PaymentFailed: "payment_failed";
+    readonly PaymentProcessing: "payment_processing";
+};
+/**
+ * The type of action required to complete the payment.
+ */
+type MultiUpdateCode = OpenEnum<typeof MultiUpdateCode>;
+/**
+ * Details about any action required to complete the payment. Present when the payment could not be processed automatically.
+ */
+type MultiUpdateRequiredAction = {
+    /**
+     * The type of action required to complete the payment.
+     */
+    code: MultiUpdateCode;
+    /**
+     * A human-readable explanation of why this action is required.
+     */
+    reason: string;
+};
+/**
+ * OK
+ */
+type MultiUpdateResponse = {
+    /**
+     * The ID of the customer.
+     */
+    customerId: string;
+    /**
+     * The ID of the entity, if the plan was attached to an entity.
+     */
+    entityId?: string | undefined;
+    /**
+     * Invoice details if an invoice was created. Only present when a charge was made.
+     */
+    invoice?: MultiUpdateInvoice | undefined;
+    /**
+     * URL to redirect the customer to complete payment. Null if no payment action is required.
+     */
+    paymentUrl: string | null;
+    /**
+     * Details about any action required to complete the payment. Present when the payment could not be processed automatically.
+     */
+    requiredAction?: MultiUpdateRequiredAction | undefined;
+};
+
 type OpenCustomerPortalParams = {
     /**
      * The ID of the customer to open the billing portal for.
@@ -19019,22 +19560,426 @@ type PreviewMultiAttachParams = {
     /**
      * Controls when to return a checkout URL. 'always' returns a URL even if payment succeeds, 'if_required' only when payment action is needed, 'never' disables redirects.
      */
-    redirectMode?: PreviewMultiAttachRedirectMode | undefined;
+    redirectMode?: PreviewMultiAttachRedirectMode | undefined;
+    /**
+     * Only applicable when the customer has an existing Stripe subscription. If true, creates a new separate subscription instead of merging into the existing one.
+     */
+    newBillingSubscription?: boolean | undefined;
+    /**
+     * If true, the cusProducts are activated immediately even when payment is pending via Stripe checkout.
+     */
+    enablePlanImmediately?: boolean | undefined;
+    /**
+     * Customer details to set when creating a customer
+     */
+    customerData?: CustomerData | undefined;
+    entityData?: PreviewMultiAttachEntityData | undefined;
+};
+type PreviewMultiAttachDiscount = {
+    amountOff: number;
+    percentOff?: number | undefined;
+    rewardId?: string | undefined;
+    rewardName?: string | undefined;
+};
+/**
+ * The period of time that this line item is being charged for.
+ */
+type PreviewMultiAttachLineItemPeriod = {
+    /**
+     * The start of the period in milliseconds since the Unix epoch.
+     */
+    start: number;
+    /**
+     * The end of the period in milliseconds since the Unix epoch.
+     */
+    end: number;
+};
+type PreviewMultiAttachLineItem = {
+    /**
+     * The name of the line item to display to the customer if you're building a UI. It will either be the plan name or the feature name.
+     */
+    displayName: string;
+    /**
+     * A detailed description of the line item.
+     */
+    description: string;
+    /**
+     * The amount in cents before discounts and tax for this line item.
+     */
+    subtotal: number;
+    /**
+     * The final amount in cents after discounts and tax for this line item.
+     */
+    total: number;
+    /**
+     * List of discounts applied to this line item.
+     */
+    discounts?: Array<PreviewMultiAttachDiscount> | undefined;
+    /**
+     * The ID of the plan that this line item belongs to.
+     */
+    planId: string;
+    /**
+     * The ID of the feature that this line item belongs to.
+     */
+    featureId: string | null;
+    /**
+     * The period of time that this line item is being charged for.
+     */
+    period?: PreviewMultiAttachLineItemPeriod | undefined;
+    /**
+     * The quantity of the line item.
+     */
+    quantity: number;
+};
+type PreviewMultiAttachNextCycleDiscount = {
+    amountOff: number;
+    percentOff?: number | undefined;
+    rewardId?: string | undefined;
+    rewardName?: string | undefined;
+};
+/**
+ * The period of time that this line item is being charged for.
+ */
+type PreviewMultiAttachNextCycleLineItemPeriod = {
+    /**
+     * The start of the period in milliseconds since the Unix epoch.
+     */
+    start: number;
+    /**
+     * The end of the period in milliseconds since the Unix epoch.
+     */
+    end: number;
+};
+type PreviewMultiAttachNextCycleLineItem = {
+    /**
+     * The name of the line item to display to the customer if you're building a UI. It will either be the plan name or the feature name.
+     */
+    displayName: string;
+    /**
+     * A detailed description of the line item.
+     */
+    description: string;
+    /**
+     * The amount in cents before discounts and tax for this line item.
+     */
+    subtotal: number;
+    /**
+     * The final amount in cents after discounts and tax for this line item.
+     */
+    total: number;
+    /**
+     * List of discounts applied to this line item.
+     */
+    discounts?: Array<PreviewMultiAttachNextCycleDiscount> | undefined;
+    /**
+     * The ID of the plan that this line item belongs to.
+     */
+    planId: string;
+    /**
+     * The ID of the feature that this line item belongs to.
+     */
+    featureId: string | null;
+    /**
+     * The period of time that this line item is being charged for.
+     */
+    period?: PreviewMultiAttachNextCycleLineItemPeriod | undefined;
+    /**
+     * The quantity of the line item.
+     */
+    quantity: number;
+};
+/**
+ * The period of time that this line item is being charged for.
+ */
+type PreviewMultiAttachUsageLineItemPeriod = {
+    /**
+     * The start of the period in milliseconds since the Unix epoch.
+     */
+    start: number;
+    /**
+     * The end of the period in milliseconds since the Unix epoch.
+     */
+    end: number;
+};
+type PreviewMultiAttachUsageLineItem = {
+    /**
+     * The name of the line item to display to the customer if you're building a UI. It will either be the plan name or the feature name.
+     */
+    displayName: string;
+    /**
+     * The ID of the plan that this line item belongs to.
+     */
+    planId: string;
+    /**
+     * The ID of the feature that this line item belongs to.
+     */
+    featureId: string | null;
+    /**
+     * The period of time that this line item is being charged for.
+     */
+    period?: PreviewMultiAttachUsageLineItemPeriod | undefined;
+};
+/**
+ * Preview of the next billing cycle, if applicable. This shows what the customer will be charged in subsequent cycles.
+ */
+type PreviewMultiAttachNextCycle = {
+    /**
+     * Unix timestamp (milliseconds) when the next billing cycle starts.
+     */
+    startsAt: number;
+    /**
+     * The total amount in cents before discounts and tax for the next cycle.
+     */
+    subtotal: number;
+    /**
+     * The final amount in cents after discounts and tax for the next cycle.
+     */
+    total: number;
+    /**
+     * List of line items for the next billing cycle.
+     */
+    lineItems: Array<PreviewMultiAttachNextCycleLineItem>;
+    /**
+     * List of line items for usage-based features in the next cycle.
+     */
+    usageLineItems: Array<PreviewMultiAttachUsageLineItem>;
+};
+type PreviewMultiAttachIncomingFeatureQuantity = {
+    /**
+     * The ID of the adjustable feature included in this change.
+     */
+    featureId: string;
+    /**
+     * The quantity that will apply for this feature in the change.
+     */
+    quantity: number;
+};
+type PreviewMultiAttachIncoming = {
+    /**
+     * The ID of the plan affected by this preview change.
+     */
+    planId: string;
+    plan?: Plan | undefined;
+    /**
+     * The feature quantity selections associated with this plan change.
+     */
+    featureQuantities: Array<PreviewMultiAttachIncomingFeatureQuantity>;
+    /**
+     * When this change takes effect, in milliseconds since the Unix epoch, or null if it applies immediately.
+     */
+    effectiveAt: number | null;
+    /**
+     * When this plan was canceled, in milliseconds since the Unix epoch, or null if it is not canceled.
+     */
+    canceledAt: number | null;
+    /**
+     * When this plan expires, in milliseconds since the Unix epoch, or null if it does not expire.
+     */
+    expiresAt: number | null;
+};
+type PreviewMultiAttachOutgoingFeatureQuantity = {
+    /**
+     * The ID of the adjustable feature included in this change.
+     */
+    featureId: string;
+    /**
+     * The quantity that will apply for this feature in the change.
+     */
+    quantity: number;
+};
+type PreviewMultiAttachOutgoing = {
+    /**
+     * The ID of the plan affected by this preview change.
+     */
+    planId: string;
+    plan?: Plan | undefined;
+    /**
+     * The feature quantity selections associated with this plan change.
+     */
+    featureQuantities: Array<PreviewMultiAttachOutgoingFeatureQuantity>;
+    /**
+     * When this change takes effect, in milliseconds since the Unix epoch, or null if it applies immediately.
+     */
+    effectiveAt: number | null;
+    /**
+     * When this plan was canceled, in milliseconds since the Unix epoch, or null if it is not canceled.
+     */
+    canceledAt: number | null;
+    /**
+     * When this plan expires, in milliseconds since the Unix epoch, or null if it does not expire.
+     */
+    expiresAt: number | null;
+};
+declare const PreviewMultiAttachCheckoutType: {
+    readonly StripeCheckout: "stripe_checkout";
+    readonly AutumnCheckout: "autumn_checkout";
+};
+type PreviewMultiAttachCheckoutType = OpenEnum<typeof PreviewMultiAttachCheckoutType>;
+/**
+ * Calculation status ('complete' when Stripe Tax succeeds or 'incomplete' when Stripe Tax returned 0 or errored).
+ */
+declare const PreviewMultiAttachStatus: {
+    readonly Complete: "complete";
+    readonly Incomplete: "incomplete";
+};
+/**
+ * Calculation status ('complete' when Stripe Tax succeeds or 'incomplete' when Stripe Tax returned 0 or errored).
+ */
+type PreviewMultiAttachStatus = OpenEnum<typeof PreviewMultiAttachStatus>;
+/**
+ * Tax preview for the immediate charge. Contact us to enable the tax flag on your organisation. Shows only with flag enabled, a Stripe customer exists and has a location.
+ */
+type PreviewMultiAttachTax = {
+    /**
+     * Total tax amount in major currency units.
+     */
+    total: number;
+    /**
+     * Tax included in line item subtotals.
+     */
+    amountInclusive: number;
+    /**
+     * Tax added on top of subtotals.
+     */
+    amountExclusive: number;
+    /**
+     * Three-letter currency code.
+     */
+    currency: string;
+    /**
+     * Calculation status ('complete' when Stripe Tax succeeds or 'incomplete' when Stripe Tax returned 0 or errored).
+     */
+    status: PreviewMultiAttachStatus;
+};
+/**
+ * Stripe customer invoice credits preview.
+ */
+type PreviewMultiAttachInvoiceCredits = {
+    /**
+     * Stripe customer credit balance available, expressed as a positive number in major currency units.
+     */
+    balance: number;
+    /**
+     * Three-letter currency code.
+     */
+    currency: string;
+};
+/**
+ * OK
+ */
+type PreviewMultiAttachResponse = {
+    /**
+     * The ID of the customer.
+     */
+    customerId: string;
+    lineItems: Array<PreviewMultiAttachLineItem>;
+    /**
+     * The total amount in cents before discounts and tax for the current billing period.
+     */
+    subtotal: number;
+    /**
+     * The final amount in cents after discounts and tax for the current billing period.
+     */
+    total: number;
+    /**
+     * The three-letter ISO currency code (e.g., 'usd').
+     */
+    currency: string;
+    /**
+     * Preview of the next billing cycle, if applicable. This shows what the customer will be charged in subsequent cycles.
+     */
+    nextCycle?: PreviewMultiAttachNextCycle | undefined;
+    /**
+     * Expand the response with additional data.
+     */
+    expand?: Array<string> | undefined;
+    /**
+     * Products or subscription changes being added or updated.
+     */
+    incoming: Array<PreviewMultiAttachIncoming>;
+    /**
+     * Products or subscription changes being removed or ended.
+     */
+    outgoing: Array<PreviewMultiAttachOutgoing>;
+    /**
+     * Whether the customer will be redirected to a checkout page if attach is called.
+     */
+    redirectToCheckout: boolean;
+    /**
+     * The type of checkout that will be used if the customer is redirected to a checkout page.
+     */
+    checkoutType: PreviewMultiAttachCheckoutType | null;
+    /**
+     * Tax preview for the immediate charge. Contact us to enable the tax flag on your organisation. Shows only with flag enabled, a Stripe customer exists and has a location.
+     */
+    tax?: PreviewMultiAttachTax | undefined;
+    /**
+     * Stripe customer invoice credits preview.
+     */
+    invoiceCredits?: PreviewMultiAttachInvoiceCredits | undefined;
+};
+
+/**
+ * Action to perform for cancellation. 'cancel_immediately' cancels now with prorated refund, 'cancel_end_of_cycle' cancels at period end, 'uncancel' reverses a pending cancellation.
+ */
+declare const PreviewMultiUpdateCancelAction: {
+    readonly CancelImmediately: "cancel_immediately";
+    readonly CancelEndOfCycle: "cancel_end_of_cycle";
+    readonly Uncancel: "uncancel";
+};
+/**
+ * Action to perform for cancellation. 'cancel_immediately' cancels now with prorated refund, 'cancel_end_of_cycle' cancels at period end, 'uncancel' reverses a pending cancellation.
+ */
+type PreviewMultiUpdateCancelAction = ClosedEnum<typeof PreviewMultiUpdateCancelAction>;
+/**
+ * How to handle proration for this update. 'prorate_immediately' charges/credits prorated amounts now, 'none' skips creating any charges.
+ */
+declare const PreviewMultiUpdateProrationBehavior: {
+    readonly ProrateImmediately: "prorate_immediately";
+    readonly None: "none";
+};
+/**
+ * How to handle proration for this update. 'prorate_immediately' charges/credits prorated amounts now, 'none' skips creating any charges.
+ */
+type PreviewMultiUpdateProrationBehavior = ClosedEnum<typeof PreviewMultiUpdateProrationBehavior>;
+type PreviewMultiUpdateUpdate = {
+    /**
+     * The ID of the plan to update. Optional if subscription_id is provided.
+     */
+    planId?: string | undefined;
+    /**
+     * A unique ID to identify the subscription to update. Useful when a customer has multiple products with the same plan.
+     */
+    subscriptionId?: string | undefined;
+    /**
+     * The ID of the entity this update targets. Overrides the top-level entity_id for this update.
+     */
+    entityId?: string | undefined;
+    /**
+     * Action to perform for cancellation. 'cancel_immediately' cancels now with prorated refund, 'cancel_end_of_cycle' cancels at period end, 'uncancel' reverses a pending cancellation.
+     */
+    cancelAction: PreviewMultiUpdateCancelAction;
+    /**
+     * How to handle proration for this update. 'prorate_immediately' charges/credits prorated amounts now, 'none' skips creating any charges.
+     */
+    prorationBehavior?: PreviewMultiUpdateProrationBehavior | undefined;
+};
+type PreviewMultiUpdateParams = {
     /**
-     * Only applicable when the customer has an existing Stripe subscription. If true, creates a new separate subscription instead of merging into the existing one.
+     * The ID of the customer to update plans for.
      */
-    newBillingSubscription?: boolean | undefined;
+    customerId: string;
     /**
-     * If true, the cusProducts are activated immediately even when payment is pending via Stripe checkout.
+     * The ID of the entity to update plans for. Individual updates can override this with their own entity_id.
      */
-    enablePlanImmediately?: boolean | undefined;
+    entityId?: string | undefined;
     /**
-     * Customer details to set when creating a customer
+     * The list of plan updates to apply to the customer.
      */
-    customerData?: CustomerData | undefined;
-    entityData?: PreviewMultiAttachEntityData | undefined;
+    updates: Array<PreviewMultiUpdateUpdate>;
 };
-type PreviewMultiAttachDiscount = {
+type PreviewMultiUpdateDiscount = {
     amountOff: number;
     percentOff?: number | undefined;
     rewardId?: string | undefined;
@@ -19043,7 +19988,7 @@ type PreviewMultiAttachDiscount = {
 /**
  * The period of time that this line item is being charged for.
  */
-type PreviewMultiAttachLineItemPeriod = {
+type PreviewMultiUpdateLineItemPeriod = {
     /**
      * The start of the period in milliseconds since the Unix epoch.
      */
@@ -19053,7 +19998,7 @@ type PreviewMultiAttachLineItemPeriod = {
      */
     end: number;
 };
-type PreviewMultiAttachLineItem = {
+type PreviewMultiUpdateLineItem = {
     /**
      * The name of the line item to display to the customer if you're building a UI. It will either be the plan name or the feature name.
      */
@@ -19073,7 +20018,7 @@ type PreviewMultiAttachLineItem = {
     /**
      * List of discounts applied to this line item.
      */
-    discounts?: Array<PreviewMultiAttachDiscount> | undefined;
+    discounts?: Array<PreviewMultiUpdateDiscount> | undefined;
     /**
      * The ID of the plan that this line item belongs to.
      */
@@ -19085,13 +20030,13 @@ type PreviewMultiAttachLineItem = {
     /**
      * The period of time that this line item is being charged for.
      */
-    period?: PreviewMultiAttachLineItemPeriod | undefined;
+    period?: PreviewMultiUpdateLineItemPeriod | undefined;
     /**
      * The quantity of the line item.
      */
     quantity: number;
 };
-type PreviewMultiAttachNextCycleDiscount = {
+type PreviewMultiUpdateNextCycleDiscount = {
     amountOff: number;
     percentOff?: number | undefined;
     rewardId?: string | undefined;
@@ -19100,7 +20045,7 @@ type PreviewMultiAttachNextCycleDiscount = {
 /**
  * The period of time that this line item is being charged for.
  */
-type PreviewMultiAttachNextCycleLineItemPeriod = {
+type PreviewMultiUpdateNextCycleLineItemPeriod = {
     /**
      * The start of the period in milliseconds since the Unix epoch.
      */
@@ -19110,7 +20055,7 @@ type PreviewMultiAttachNextCycleLineItemPeriod = {
      */
     end: number;
 };
-type PreviewMultiAttachNextCycleLineItem = {
+type PreviewMultiUpdateNextCycleLineItem = {
     /**
      * The name of the line item to display to the customer if you're building a UI. It will either be the plan name or the feature name.
      */
@@ -19130,7 +20075,7 @@ type PreviewMultiAttachNextCycleLineItem = {
     /**
      * List of discounts applied to this line item.
      */
-    discounts?: Array<PreviewMultiAttachNextCycleDiscount> | undefined;
+    discounts?: Array<PreviewMultiUpdateNextCycleDiscount> | undefined;
     /**
      * The ID of the plan that this line item belongs to.
      */
@@ -19142,7 +20087,7 @@ type PreviewMultiAttachNextCycleLineItem = {
     /**
      * The period of time that this line item is being charged for.
      */
-    period?: PreviewMultiAttachNextCycleLineItemPeriod | undefined;
+    period?: PreviewMultiUpdateNextCycleLineItemPeriod | undefined;
     /**
      * The quantity of the line item.
      */
@@ -19151,7 +20096,7 @@ type PreviewMultiAttachNextCycleLineItem = {
 /**
  * The period of time that this line item is being charged for.
  */
-type PreviewMultiAttachUsageLineItemPeriod = {
+type PreviewMultiUpdateUsageLineItemPeriod = {
     /**
      * The start of the period in milliseconds since the Unix epoch.
      */
@@ -19161,7 +20106,7 @@ type PreviewMultiAttachUsageLineItemPeriod = {
      */
     end: number;
 };
-type PreviewMultiAttachUsageLineItem = {
+type PreviewMultiUpdateUsageLineItem = {
     /**
      * The name of the line item to display to the customer if you're building a UI. It will either be the plan name or the feature name.
      */
@@ -19177,12 +20122,12 @@ type PreviewMultiAttachUsageLineItem = {
     /**
      * The period of time that this line item is being charged for.
      */
-    period?: PreviewMultiAttachUsageLineItemPeriod | undefined;
+    period?: PreviewMultiUpdateUsageLineItemPeriod | undefined;
 };
 /**
  * Preview of the next billing cycle, if applicable. This shows what the customer will be charged in subsequent cycles.
  */
-type PreviewMultiAttachNextCycle = {
+type PreviewMultiUpdateNextCycle = {
     /**
      * Unix timestamp (milliseconds) when the next billing cycle starts.
      */
@@ -19198,13 +20143,13 @@ type PreviewMultiAttachNextCycle = {
     /**
      * List of line items for the next billing cycle.
      */
-    lineItems: Array<PreviewMultiAttachNextCycleLineItem>;
+    lineItems: Array<PreviewMultiUpdateNextCycleLineItem>;
     /**
      * List of line items for usage-based features in the next cycle.
      */
-    usageLineItems: Array<PreviewMultiAttachUsageLineItem>;
+    usageLineItems: Array<PreviewMultiUpdateUsageLineItem>;
 };
-type PreviewMultiAttachIncomingFeatureQuantity = {
+type PreviewMultiUpdateIncomingFeatureQuantity = {
     /**
      * The ID of the adjustable feature included in this change.
      */
@@ -19214,7 +20159,7 @@ type PreviewMultiAttachIncomingFeatureQuantity = {
      */
     quantity: number;
 };
-type PreviewMultiAttachIncoming = {
+type PreviewMultiUpdateIncoming = {
     /**
      * The ID of the plan affected by this preview change.
      */
@@ -19223,7 +20168,7 @@ type PreviewMultiAttachIncoming = {
     /**
      * The feature quantity selections associated with this plan change.
      */
-    featureQuantities: Array<PreviewMultiAttachIncomingFeatureQuantity>;
+    featureQuantities: Array<PreviewMultiUpdateIncomingFeatureQuantity>;
     /**
      * When this change takes effect, in milliseconds since the Unix epoch, or null if it applies immediately.
      */
@@ -19237,7 +20182,7 @@ type PreviewMultiAttachIncoming = {
      */
     expiresAt: number | null;
 };
-type PreviewMultiAttachOutgoingFeatureQuantity = {
+type PreviewMultiUpdateOutgoingFeatureQuantity = {
     /**
      * The ID of the adjustable feature included in this change.
      */
@@ -19247,7 +20192,7 @@ type PreviewMultiAttachOutgoingFeatureQuantity = {
      */
     quantity: number;
 };
-type PreviewMultiAttachOutgoing = {
+type PreviewMultiUpdateOutgoing = {
     /**
      * The ID of the plan affected by this preview change.
      */
@@ -19256,7 +20201,7 @@ type PreviewMultiAttachOutgoing = {
     /**
      * The feature quantity selections associated with this plan change.
      */
-    featureQuantities: Array<PreviewMultiAttachOutgoingFeatureQuantity>;
+    featureQuantities: Array<PreviewMultiUpdateOutgoingFeatureQuantity>;
     /**
      * When this change takes effect, in milliseconds since the Unix epoch, or null if it applies immediately.
      */
@@ -19270,69 +20215,15 @@ type PreviewMultiAttachOutgoing = {
      */
     expiresAt: number | null;
 };
-declare const PreviewMultiAttachCheckoutType: {
-    readonly StripeCheckout: "stripe_checkout";
-    readonly AutumnCheckout: "autumn_checkout";
-};
-type PreviewMultiAttachCheckoutType = OpenEnum<typeof PreviewMultiAttachCheckoutType>;
-/**
- * Calculation status ('complete' when Stripe Tax succeeds or 'incomplete' when Stripe Tax returned 0 or errored).
- */
-declare const PreviewMultiAttachStatus: {
-    readonly Complete: "complete";
-    readonly Incomplete: "incomplete";
-};
-/**
- * Calculation status ('complete' when Stripe Tax succeeds or 'incomplete' when Stripe Tax returned 0 or errored).
- */
-type PreviewMultiAttachStatus = OpenEnum<typeof PreviewMultiAttachStatus>;
-/**
- * Tax preview for the immediate charge. Contact us to enable the tax flag on your organisation. Shows only with flag enabled, a Stripe customer exists and has a location.
- */
-type PreviewMultiAttachTax = {
-    /**
-     * Total tax amount in major currency units.
-     */
-    total: number;
-    /**
-     * Tax included in line item subtotals.
-     */
-    amountInclusive: number;
-    /**
-     * Tax added on top of subtotals.
-     */
-    amountExclusive: number;
-    /**
-     * Three-letter currency code.
-     */
-    currency: string;
-    /**
-     * Calculation status ('complete' when Stripe Tax succeeds or 'incomplete' when Stripe Tax returned 0 or errored).
-     */
-    status: PreviewMultiAttachStatus;
-};
-/**
- * Stripe customer invoice credits preview.
- */
-type PreviewMultiAttachInvoiceCredits = {
-    /**
-     * Stripe customer credit balance available, expressed as a positive number in major currency units.
-     */
-    balance: number;
-    /**
-     * Three-letter currency code.
-     */
-    currency: string;
-};
-/**
- * OK
- */
-type PreviewMultiAttachResponse = {
+type PreviewMultiUpdateSubscription = {
     /**
      * The ID of the customer.
      */
     customerId: string;
-    lineItems: Array<PreviewMultiAttachLineItem>;
+    /**
+     * List of line items for the current billing period.
+     */
+    lineItems: Array<PreviewMultiUpdateLineItem>;
     /**
      * The total amount in cents before discounts and tax for the current billing period.
      */
@@ -19348,7 +20239,7 @@ type PreviewMultiAttachResponse = {
     /**
      * Preview of the next billing cycle, if applicable. This shows what the customer will be charged in subsequent cycles.
      */
-    nextCycle?: PreviewMultiAttachNextCycle | undefined;
+    nextCycle?: PreviewMultiUpdateNextCycle | undefined;
     /**
      * Expand the response with additional data.
      */
@@ -19356,27 +20247,36 @@ type PreviewMultiAttachResponse = {
     /**
      * Products or subscription changes being added or updated.
      */
-    incoming: Array<PreviewMultiAttachIncoming>;
+    incoming: Array<PreviewMultiUpdateIncoming>;
     /**
      * Products or subscription changes being removed or ended.
      */
-    outgoing: Array<PreviewMultiAttachOutgoing>;
+    outgoing: Array<PreviewMultiUpdateOutgoing>;
     /**
-     * Whether the customer will be redirected to a checkout page if attach is called.
+     * The IDs of the plans updated on this subscription.
      */
-    redirectToCheckout: boolean;
+    planIds: Array<string>;
+};
+/**
+ * OK
+ */
+type MultiUpdatePreviewResponse = {
     /**
-     * The type of checkout that will be used if the customer is redirected to a checkout page.
+     * The ID of the customer the preview applies to.
      */
-    checkoutType: PreviewMultiAttachCheckoutType | null;
+    customerId: string;
     /**
-     * Tax preview for the immediate charge. Contact us to enable the tax flag on your organisation. Shows only with flag enabled, a Stripe customer exists and has a location.
+     * The three-letter ISO currency code (e.g., 'usd').
      */
-    tax?: PreviewMultiAttachTax | undefined;
+    currency: string;
     /**
-     * Stripe customer invoice credits preview.
+     * The combined amount due today across all subscriptions (sum of subscriptions[].total).
      */
-    invoiceCredits?: PreviewMultiAttachInvoiceCredits | undefined;
+    total: number;
+    /**
+     * One preview per affected Stripe subscription. Updates to plans without a subscription (free plans) produce no entry.
+     */
+    subscriptions: Array<PreviewMultiUpdateSubscription>;
 };
 
 /**
@@ -22326,6 +23226,10 @@ type UpdateBalanceParams = {
      * The next reset time for the balance. If there are multiple breakdowns, this will update the breakdown with the next reset time.
      */
     nextResetAt?: number | undefined;
+    /**
+     * Unix timestamp (milliseconds) when the balance expires. Targets a specific balance via balance_id / interval when the customer has multiple balances for the same feature.
+     */
+    expiresAt?: number | undefined;
 };
 /**
  * OK
@@ -22604,18 +23508,45 @@ declare const UpdateCustomerEnv: {
  * The environment this customer was created in.
  */
 type UpdateCustomerEnv = OpenEnum<typeof UpdateCustomerEnv>;
+/**
+ * The time interval for the purchase limit window.
+ */
 declare const UpdateCustomerPurchaseLimitIntervalResponse2: {
     readonly Hour: "hour";
     readonly Day: "day";
     readonly Week: "week";
     readonly Month: "month";
 };
+/**
+ * The time interval for the purchase limit window.
+ */
 type UpdateCustomerPurchaseLimitIntervalResponse2 = OpenEnum<typeof UpdateCustomerPurchaseLimitIntervalResponse2>;
 type UpdateCustomerPurchaseLimitResponse2 = {
+    /**
+     * The time interval for the purchase limit window.
+     */
+    interval: UpdateCustomerPurchaseLimitIntervalResponse2;
+    /**
+     * Number of intervals in the purchase limit window.
+     */
+    intervalCount: number;
+    /**
+     * Maximum number of auto top-ups allowed within the interval.
+     */
+    limit: number;
+};
+declare const UpdateCustomerPurchaseLimitIntervalResponse1: {
+    readonly Hour: "hour";
+    readonly Day: "day";
+    readonly Week: "week";
+    readonly Month: "month";
+};
+type UpdateCustomerPurchaseLimitIntervalResponse1 = OpenEnum<typeof UpdateCustomerPurchaseLimitIntervalResponse1>;
+type UpdateCustomerPurchaseLimitResponse1 = {
     /**
      * The time interval for the purchase limit window. Null when no purchase limit is configured.
      */
-    interval: UpdateCustomerPurchaseLimitIntervalResponse2 | null;
+    interval: UpdateCustomerPurchaseLimitIntervalResponse1 | null;
     /**
      * Number of intervals in the purchase limit window. Null when no purchase limit is configured.
      */
@@ -22634,32 +23565,16 @@ type UpdateCustomerPurchaseLimitResponse2 = {
     nextResetAt: number;
 };
 /**
- * The time interval for the purchase limit window.
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
  */
-declare const UpdateCustomerPurchaseLimitIntervalResponse1: {
-    readonly Hour: "hour";
-    readonly Day: "day";
-    readonly Week: "week";
-    readonly Month: "month";
+declare const UpdateCustomerAutoTopupSource: {
+    readonly Customer: "customer";
+    readonly Plan: "plan";
 };
 /**
- * The time interval for the purchase limit window.
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
  */
-type UpdateCustomerPurchaseLimitIntervalResponse1 = OpenEnum<typeof UpdateCustomerPurchaseLimitIntervalResponse1>;
-type UpdateCustomerPurchaseLimitResponse1 = {
-    /**
-     * The time interval for the purchase limit window.
-     */
-    interval: UpdateCustomerPurchaseLimitIntervalResponse1;
-    /**
-     * Number of intervals in the purchase limit window.
-     */
-    intervalCount: number;
-    /**
-     * Maximum number of auto top-ups allowed within the interval.
-     */
-    limit: number;
-};
+type UpdateCustomerAutoTopupSource = OpenEnum<typeof UpdateCustomerAutoTopupSource>;
 type UpdateCustomerAutoTopupResponse = {
     /**
      * The ID of the feature (credit balance) to auto top-up.
@@ -22680,11 +23595,15 @@ type UpdateCustomerAutoTopupResponse = {
     /**
      * Optional rate limit to cap how often auto top-ups occur. Expand billing_controls.auto_topups.purchase_limit for a count of top ups and the next_reset_at.
      */
-    purchaseLimit?: UpdateCustomerPurchaseLimitResponse2 | UpdateCustomerPurchaseLimitResponse1 | undefined;
+    purchaseLimit?: UpdateCustomerPurchaseLimitResponse1 | UpdateCustomerPurchaseLimitResponse2 | undefined;
     /**
      * When true, auto top-up creates a send_invoice invoice instead of auto-charging.
      */
     invoiceMode?: boolean | undefined;
+    /**
+     * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+     */
+    source?: UpdateCustomerAutoTopupSource | undefined;
 };
 /**
  * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
@@ -22697,6 +23616,17 @@ declare const UpdateCustomerLimitTypeResponse: {
  * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
  */
 type UpdateCustomerLimitTypeResponse = OpenEnum<typeof UpdateCustomerLimitTypeResponse>;
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+declare const UpdateCustomerSpendLimitSource: {
+    readonly Customer: "customer";
+    readonly Plan: "plan";
+};
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+type UpdateCustomerSpendLimitSource = OpenEnum<typeof UpdateCustomerSpendLimitSource>;
 type UpdateCustomerSpendLimitResponse = {
     /**
      * Optional feature ID this spend limit applies to.
@@ -22718,6 +23648,10 @@ type UpdateCustomerSpendLimitResponse = {
      * When true, overage for this feature is not posted to Stripe. Usage tracking and balance resets still behave normally.
      */
     skipOverageBilling?: boolean | undefined;
+    /**
+     * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+     */
+    source?: UpdateCustomerSpendLimitSource | undefined;
 };
 /**
  * Interval for the cap, aligned to the customer's billing cycle.
@@ -22740,6 +23674,17 @@ type UpdateCustomerFilterResponse = {
         [k: string]: any;
     };
 };
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+declare const UpdateCustomerUsageLimitSource: {
+    readonly Customer: "customer";
+    readonly Plan: "plan";
+};
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+type UpdateCustomerUsageLimitSource = OpenEnum<typeof UpdateCustomerUsageLimitSource>;
 type UpdateCustomerUsageLimitResponse = {
     /**
      * The feature this usage limit applies to.
@@ -22765,6 +23710,10 @@ type UpdateCustomerUsageLimitResponse = {
      * Current usage already consumed in the active interval. Response-only; not stored on billing controls.
      */
     usage?: number | undefined;
+    /**
+     * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+     */
+    source?: UpdateCustomerUsageLimitSource | undefined;
 };
 /**
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
@@ -22779,6 +23728,17 @@ declare const UpdateCustomerThresholdTypeResponse: {
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
  */
 type UpdateCustomerThresholdTypeResponse = OpenEnum<typeof UpdateCustomerThresholdTypeResponse>;
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+declare const UpdateCustomerUsageAlertSource: {
+    readonly Customer: "customer";
+    readonly Plan: "plan";
+};
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+type UpdateCustomerUsageAlertSource = OpenEnum<typeof UpdateCustomerUsageAlertSource>;
 type UpdateCustomerUsageAlertResponse = {
     /**
      * The feature ID this alert applies to.
@@ -22800,7 +23760,22 @@ type UpdateCustomerUsageAlertResponse = {
      * Optional user-defined label to distinguish multiple alerts on the same feature.
      */
     name?: string | undefined;
+    /**
+     * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+     */
+    source?: UpdateCustomerUsageAlertSource | undefined;
+};
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+declare const UpdateCustomerOverageAllowedSource: {
+    readonly Customer: "customer";
+    readonly Plan: "plan";
 };
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+type UpdateCustomerOverageAllowedSource = OpenEnum<typeof UpdateCustomerOverageAllowedSource>;
 type UpdateCustomerOverageAllowedResponse = {
     /**
      * The feature ID this overage allowed control applies to.
@@ -22810,6 +23785,10 @@ type UpdateCustomerOverageAllowedResponse = {
      * Whether overage is allowed for this feature.
      */
     enabled: boolean;
+    /**
+     * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+     */
+    source?: UpdateCustomerOverageAllowedSource | undefined;
 };
 /**
  * Billing controls for the customer (auto top-ups, etc.)
@@ -23619,6 +24598,17 @@ declare const UpdateEntityLimitTypeResponse: {
  * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
  */
 type UpdateEntityLimitTypeResponse = OpenEnum<typeof UpdateEntityLimitTypeResponse>;
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+declare const UpdateEntitySpendLimitSource: {
+    readonly Customer: "customer";
+    readonly Plan: "plan";
+};
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+type UpdateEntitySpendLimitSource = OpenEnum<typeof UpdateEntitySpendLimitSource>;
 type UpdateEntitySpendLimitResponse = {
     /**
      * Optional feature ID this spend limit applies to.
@@ -23640,6 +24630,10 @@ type UpdateEntitySpendLimitResponse = {
      * When true, overage for this feature is not posted to Stripe. Usage tracking and balance resets still behave normally.
      */
     skipOverageBilling?: boolean | undefined;
+    /**
+     * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+     */
+    source?: UpdateEntitySpendLimitSource | undefined;
 };
 /**
  * Interval for the cap, aligned to the customer's billing cycle.
@@ -23662,6 +24656,17 @@ type UpdateEntityFilterResponse = {
         [k: string]: any;
     };
 };
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+declare const UpdateEntityUsageLimitSource: {
+    readonly Customer: "customer";
+    readonly Plan: "plan";
+};
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+type UpdateEntityUsageLimitSource = OpenEnum<typeof UpdateEntityUsageLimitSource>;
 type UpdateEntityUsageLimitResponse = {
     /**
      * The feature this usage limit applies to.
@@ -23687,6 +24692,10 @@ type UpdateEntityUsageLimitResponse = {
      * Current usage already consumed in the active interval. Response-only; not stored on billing controls.
      */
     usage?: number | undefined;
+    /**
+     * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+     */
+    source?: UpdateEntityUsageLimitSource | undefined;
 };
 /**
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
@@ -23701,6 +24710,17 @@ declare const UpdateEntityThresholdTypeResponse: {
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
  */
 type UpdateEntityThresholdTypeResponse = OpenEnum<typeof UpdateEntityThresholdTypeResponse>;
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+declare const UpdateEntityUsageAlertSource: {
+    readonly Customer: "customer";
+    readonly Plan: "plan";
+};
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+type UpdateEntityUsageAlertSource = OpenEnum<typeof UpdateEntityUsageAlertSource>;
 type UpdateEntityUsageAlertResponse = {
     /**
      * The feature ID this alert applies to.
@@ -23722,7 +24742,22 @@ type UpdateEntityUsageAlertResponse = {
      * Optional user-defined label to distinguish multiple alerts on the same feature.
      */
     name?: string | undefined;
+    /**
+     * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+     */
+    source?: UpdateEntityUsageAlertSource | undefined;
+};
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+declare const UpdateEntityOverageAllowedSource: {
+    readonly Customer: "customer";
+    readonly Plan: "plan";
 };
+/**
+ * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+ */
+type UpdateEntityOverageAllowedSource = OpenEnum<typeof UpdateEntityOverageAllowedSource>;
 type UpdateEntityOverageAllowedResponse = {
     /**
      * The feature ID this overage allowed control applies to.
@@ -23732,6 +24767,10 @@ type UpdateEntityOverageAllowedResponse = {
      * Whether overage is allowed for this feature.
      */
     enabled: boolean;
+    /**
+     * Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults.
+     */
+    source?: UpdateEntityOverageAllowedSource | undefined;
 };
 /**
  * Billing controls for the entity.
@@ -26696,7 +27735,7 @@ declare class Billing extends ClientSDK {
      * @example
      * ```typescript
      * // Schedule a transition from a trial plan to a paid plan
-     * const response = await client.billing.createSchedule({ customerId: "cus_123", phases: [{"startsAt":1783539171816,"plans":[{"planId":"trial_plan"}]},{"startsAt":1784748771816,"plans":[{"planId":"pro_plan"}]}] });
+     * const response = await client.billing.createSchedule({ customerId: "cus_123", phases: [{"startsAt":1783701939170,"plans":[{"planId":"trial_plan"}]},{"startsAt":1784911539170,"plans":[{"planId":"pro_plan"}]}] });
      * ```
      *
      * @param customerId - The ID of the customer to create the schedule for.
@@ -26896,6 +27935,48 @@ declare class Billing extends ClientSDK {
      * @returns A preview response with line items showing prorated charges or credits for the proposed changes.
      */
     previewUpdate(request: PreviewUpdateParams, options?: RequestOptions): Promise<PreviewUpdateResponse>;
+    /**
+     * Updates multiple plans on a customer in a single request. Currently supports cancel actions (immediately, end of cycle, or uncancel) across one or more subscriptions.
+     *
+     * Use this endpoint to cancel or uncancel several plans atomically in one call — for example canceling a main plan together with its add-ons, or plans across multiple entities.
+     *
+     * @example
+     * ```typescript
+     * // Cancel a plan and an add-on at end of cycle
+     * const response = await client.billing.multiUpdate({ customerId: "cus_123", updates: [{"planId":"pro_plan","cancelAction":"cancel_end_of_cycle"},{"planId":"addon_seats","cancelAction":"cancel_end_of_cycle"}] });
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // Uncancel one plan and cancel another immediately
+     * const response = await client.billing.multiUpdate({ customerId: "cus_123", updates: [{"planId":"pro_plan","cancelAction":"uncancel"},{"planId":"addon_seats","cancelAction":"cancel_immediately"}] });
+     * ```
+     *
+     * @param customerId - The ID of the customer to update plans for.
+     * @param entityId - The ID of the entity to update plans for. Individual updates can override this with their own entity_id. (optional)
+     * @param updates - The list of plan updates to apply to the customer.
+     *
+     * @returns A billing response with the resulting invoice summary (one credit invoice per affected subscription for immediate cancels).
+     */
+    multiUpdate(request: MultiUpdateParams, options?: RequestOptions): Promise<MultiUpdateResponse>;
+    /**
+     * Previews the billing changes of a multi-plan update without making any changes. Returns one core preview per affected subscription.
+     *
+     * Use this endpoint to show customers the credits and next-cycle changes of canceling multiple plans before confirming.
+     *
+     * @example
+     * ```typescript
+     * // Preview canceling two plans immediately
+     * const response = await client.billing.previewMultiUpdate({ customerId: "cus_123", updates: [{"planId":"pro_plan","cancelAction":"cancel_immediately"},{"planId":"addon_seats","cancelAction":"cancel_immediately"}] });
+     * ```
+     *
+     * @param customerId - The ID of the customer to update plans for.
+     * @param entityId - The ID of the entity to update plans for. Individual updates can override this with their own entity_id. (optional)
+     * @param updates - The list of plan updates to apply to the customer.
+     *
+     * @returns A preview with the combined total plus one entry per subscription, each with its own line items, totals, and next-cycle preview.
+     */
+    previewMultiUpdate(request: PreviewMultiUpdateParams, options?: RequestOptions): Promise<MultiUpdatePreviewResponse>;
     /**
      * Create a billing portal session for a customer to manage their subscription.
      */