autumn-js 1.2.39 → 1.2.41

package/dist/react/{params-Bf18ATYi.d.mts → params-_Bb3H0_F.d.ts}

@@ -1,4 +1,4 @@
-import { C as ClosedEnum, O as OpenEnum, a as Balance, P as Plan } from './plan-CUExbmy9.mjs';
+import { C as ClosedEnum, O as OpenEnum, a as Balance, P as Plan } from './plan--HshF-xs.js';
 
 /**
  * Time range to aggregate events for. Either range or custom_range must be provided
@@ -154,6 +154,16 @@ declare const AttachPriceInterval: {
  * Billing interval (e.g. 'month', 'year').
  */
 type AttachPriceInterval = ClosedEnum<typeof AttachPriceInterval>;
+type AttachAdditionalCurrency = {
+    /**
+     * Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').
+     */
+    currency: string;
+    /**
+     * Price amount in this currency. Set explicitly per currency, not converted from the base amount.
+     */
+    amount: number;
+};
 /**
  * Base price configuration for a plan.
  */
@@ -170,6 +180,10 @@ type AttachBasePrice = {
      * Number of intervals per billing cycle. Defaults to 1.
      */
     intervalCount?: number | undefined;
+    /**
+     * Base price amounts in additional currencies. The base 'amount' is in the org's default currency.
+     */
+    additionalCurrencies?: Array<AttachAdditionalCurrency> | undefined;
 };
 /**
  * Interval at which balance resets (e.g. 'month', 'year'). For consumable features only.
@@ -202,10 +216,38 @@ type AttachItemReset = {
      */
     intervalCount?: number | undefined;
 };
+type AttachItemAdditionalCurrency = {
+    /**
+     * Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').
+     */
+    currency: string;
+    /**
+     * Price amount in this currency. Set explicitly per currency, not converted from the base amount.
+     */
+    amount: number;
+};
+type AttachItemTierAdditionalCurrency = {
+    /**
+     * Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').
+     */
+    currency: string;
+    /**
+     * Per-unit amount for this tier in this currency.
+     */
+    amount?: number | undefined;
+    /**
+     * Flat amount for this tier in this currency, if the tier uses one.
+     */
+    flatAmount?: number | undefined;
+};
 type AttachItemTier = {
     to: number | string;
     amount?: number | undefined;
     flatAmount?: number | undefined;
+    /**
+     * Per-currency amounts for this tier. Tier boundaries ('to') are shared across all currencies.
+     */
+    additionalCurrencies?: Array<AttachItemTierAdditionalCurrency> | undefined;
 };
 declare const AttachItemTierBehavior: {
     readonly Graduated: "graduated";
@@ -246,6 +288,10 @@ type AttachItemPrice = {
      * Price per billing_units after included usage. Either 'amount' or 'tiers' is required.
      */
     amount?: number | undefined;
+    /**
+     * Amounts in additional currencies for this flat price. The base 'amount' is in the org's default currency. Only valid with 'amount', not 'tiers'.
+     */
+    additionalCurrencies?: Array<AttachItemAdditionalCurrency> | undefined;
     /**
      * Tiered pricing.  Either 'amount' or 'tiers' is required.
      */
@@ -408,10 +454,38 @@ type AttachAddItemReset = {
      */
     intervalCount?: number | undefined;
 };
+type AttachAddItemAdditionalCurrency = {
+    /**
+     * Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').
+     */
+    currency: string;
+    /**
+     * Price amount in this currency. Set explicitly per currency, not converted from the base amount.
+     */
+    amount: number;
+};
+type AttachAddItemTierAdditionalCurrency = {
+    /**
+     * Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').
+     */
+    currency: string;
+    /**
+     * Per-unit amount for this tier in this currency.
+     */
+    amount?: number | undefined;
+    /**
+     * Flat amount for this tier in this currency, if the tier uses one.
+     */
+    flatAmount?: number | undefined;
+};
 type AttachAddItemTier = {
     to: number | string;
     amount?: number | undefined;
     flatAmount?: number | undefined;
+    /**
+     * Per-currency amounts for this tier. Tier boundaries ('to') are shared across all currencies.
+     */
+    additionalCurrencies?: Array<AttachAddItemTierAdditionalCurrency> | undefined;
 };
 declare const AttachAddItemTierBehavior: {
     readonly Graduated: "graduated";
@@ -452,6 +526,10 @@ type AttachAddItemPrice = {
      * Price per billing_units after included usage. Either 'amount' or 'tiers' is required.
      */
     amount?: number | undefined;
+    /**
+     * Amounts in additional currencies for this flat price. The base 'amount' is in the org's default currency. Only valid with 'amount', not 'tiers'.
+     */
+    additionalCurrencies?: Array<AttachAddItemAdditionalCurrency> | undefined;
     /**
      * Tiered pricing.  Either 'amount' or 'tiers' is required.
      */
@@ -883,157 +961,508 @@ type AttachBillingControls = {
     overageAllowed?: Array<AttachOverageAllowed> | undefined;
 };
 /**
- * Customize the plan to attach. Can override the price, items, free trial, or a combination.
+ * Billing interval (e.g. 'month', 'year').
  */
-type AttachCustomize = {
+declare const AttachPriceUpsertLicenseInterval: {
+    readonly OneOff: "one_off";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Quarter: "quarter";
+    readonly SemiAnnual: "semi_annual";
+    readonly Year: "year";
+};
+/**
+ * Billing interval (e.g. 'month', 'year').
+ */
+type AttachPriceUpsertLicenseInterval = ClosedEnum<typeof AttachPriceUpsertLicenseInterval>;
+type AttachUpsertLicenseAdditionalCurrency = {
     /**
-     * Override the base price of the plan. Pass null to remove the base price.
+     * Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').
      */
-    price?: AttachBasePrice | null | undefined;
+    currency: string;
     /**
-     * Override the items in the plan (PUT-style — replaces all existing items). Mutually exclusive with add_items / remove_items / deprecated update_items.
+     * Price amount in this currency. Set explicitly per currency, not converted from the base amount.
      */
-    items?: Array<AttachItemPlanItem> | undefined;
+    amount: number;
+};
+/**
+ * Base price configuration for a plan.
+ */
+type AttachUpsertLicenseBasePrice = {
     /**
-     * Items to add to the plan.
+     * Base price amount for the plan.
      */
-    addItems?: Array<AttachAddItemPlanItem> | undefined;
+    amount: number;
     /**
-     * Filters selecting items to remove from the plan.
+     * Billing interval (e.g. 'month', 'year').
      */
-    removeItems?: Array<AttachPlanItemFilter> | undefined;
+    interval: AttachPriceUpsertLicenseInterval;
     /**
-     * Override the plan's default free trial. Pass an object to set a custom trial, or null to remove the trial entirely.
+     * Number of intervals per billing cycle. Defaults to 1.
      */
-    freeTrial?: AttachFreeTrialParams | null | undefined;
+    intervalCount?: number | undefined;
     /**
-     * Override the plan's billing controls (auto top-ups, spend limits, usage limits, usage alerts, overage allowed) for this customer.
+     * Base price amounts in additional currencies. The base 'amount' is in the org's default currency.
      */
-    billingControls?: AttachBillingControls | undefined;
+    additionalCurrencies?: Array<AttachUpsertLicenseAdditionalCurrency> | undefined;
 };
 /**
- * Invoice mode creates a draft or open invoice and sends it to the customer, instead of charging their card immediately. This uses Stripe's send_invoice collection method.
+ * Interval at which balance resets (e.g. 'month', 'year'). For consumable features only.
  */
-type AttachInvoiceMode = {
+declare const AttachUpsertLicenseResetInterval: {
+    readonly OneOff: "one_off";
+    readonly Minute: "minute";
+    readonly Hour: "hour";
+    readonly Day: "day";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Quarter: "quarter";
+    readonly SemiAnnual: "semi_annual";
+    readonly Year: "year";
+};
+/**
+ * Interval at which balance resets (e.g. 'month', 'year'). For consumable features only.
+ */
+type AttachUpsertLicenseResetInterval = ClosedEnum<typeof AttachUpsertLicenseResetInterval>;
+/**
+ * Reset configuration for consumable features. Omit for non-consumable features like seats.
+ */
+type AttachUpsertLicenseReset = {
     /**
-     * When true, creates an invoice and sends it to the customer instead of charging their card immediately. Uses Stripe's send_invoice collection method.
+     * Interval at which balance resets (e.g. 'month', 'year'). For consumable features only.
      */
-    enabled: boolean;
+    interval: AttachUpsertLicenseResetInterval;
     /**
-     * If true, enables the plan immediately even though the invoice is not paid yet.
+     * Number of intervals between resets. Defaults to 1.
      */
-    enablePlanImmediately?: boolean | undefined;
+    intervalCount?: number | undefined;
+};
+type AttachUpsertLicenseAddItemAdditionalCurrency = {
     /**
-     * If true, finalizes the invoice so it can be sent to the customer. If false, keeps it as a draft for manual review.
+     * Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').
      */
-    finalize?: boolean | undefined;
+    currency: string;
     /**
-     * ID of an invoice template (configured in billing settings) whose footer (e.g. bank details) is applied to the invoice.
+     * Price amount in this currency. Set explicitly per currency, not converted from the base amount.
      */
-    invoiceTemplateId?: string | undefined;
+    amount: number;
+};
+type AttachUpsertLicenseTier = {
+    to?: any | undefined;
+    amount?: number | undefined;
+    flatAmount?: number | undefined;
     /**
-     * Number of days the customer has to pay the invoice before it is due (Stripe days_until_due).
+     * Per-currency amounts for this tier. Tier boundaries ('to') are shared across all currencies.
      */
-    netTermsDays?: number | undefined;
+    additionalCurrencies?: Array<any> | undefined;
 };
+declare const AttachUpsertLicenseTierBehavior: {
+    readonly Graduated: "graduated";
+    readonly Volume: "volume";
+};
+type AttachUpsertLicenseTierBehavior = ClosedEnum<typeof AttachUpsertLicenseTierBehavior>;
 /**
- * How to handle proration when updating an existing subscription. 'prorate_immediately' charges/credits prorated amounts now, 'none' skips creating any charges.
+ * Billing interval. For consumable features, should match reset.interval.
  */
-declare const AttachProrationBehavior: {
-    readonly ProrateImmediately: "prorate_immediately";
-    readonly None: "none";
+declare const AttachUpsertLicenseAddItemPriceInterval: {
+    readonly OneOff: "one_off";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Quarter: "quarter";
+    readonly SemiAnnual: "semi_annual";
+    readonly Year: "year";
 };
 /**
- * How to handle proration when updating an existing subscription. 'prorate_immediately' charges/credits prorated amounts now, 'none' skips creating any charges.
+ * Billing interval. For consumable features, should match reset.interval.
  */
-type AttachProrationBehavior = ClosedEnum<typeof AttachProrationBehavior>;
+type AttachUpsertLicenseAddItemPriceInterval = ClosedEnum<typeof AttachUpsertLicenseAddItemPriceInterval>;
 /**
- * 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.
+ * 'prepaid' for upfront payment (seats), 'usage_based' for pay-as-you-go.
  */
-declare const AttachRedirectMode: {
-    readonly Always: "always";
-    readonly IfRequired: "if_required";
-    readonly Never: "never";
+declare const AttachUpsertLicenseAddItemBillingMethod: {
+    readonly Prepaid: "prepaid";
+    readonly UsageBased: "usage_based";
 };
 /**
- * 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.
+ * 'prepaid' for upfront payment (seats), 'usage_based' for pay-as-you-go.
  */
-type AttachRedirectMode = ClosedEnum<typeof AttachRedirectMode>;
+type AttachUpsertLicenseAddItemBillingMethod = ClosedEnum<typeof AttachUpsertLicenseAddItemBillingMethod>;
 /**
- * A discount to apply. Can be either a reward ID or a promotion code.
+ * Pricing for usage beyond included units. Omit for free features.
  */
-type AttachAttachDiscount = {
+type AttachUpsertLicensePrice = {
     /**
-     * The ID of the reward to apply as a discount.
+     * Price per billing_units after included usage. Either 'amount' or 'tiers' is required.
      */
-    rewardId?: string | undefined;
+    amount?: number | undefined;
     /**
-     * The promotion code to apply as a discount.
+     * Amounts in additional currencies for this flat price. The base 'amount' is in the org's default currency. Only valid with 'amount', not 'tiers'.
      */
-    promotionCode?: string | undefined;
+    additionalCurrencies?: Array<AttachUpsertLicenseAddItemAdditionalCurrency> | undefined;
+    /**
+     * Tiered pricing.  Either 'amount' or 'tiers' is required.
+     */
+    tiers?: Array<AttachUpsertLicenseTier> | undefined;
+    tierBehavior?: AttachUpsertLicenseTierBehavior | undefined;
+    /**
+     * Billing interval. For consumable features, should match reset.interval.
+     */
+    interval: AttachUpsertLicenseAddItemPriceInterval;
+    /**
+     * Number of intervals per billing cycle. Defaults to 1.
+     */
+    intervalCount?: number | undefined;
+    /**
+     * Units per price increment. Usage is rounded UP when billed (e.g. billing_units=100 means 101 rounds to 200).
+     */
+    billingUnits?: number | undefined;
+    /**
+     * 'prepaid' for upfront payment (seats), 'usage_based' for pay-as-you-go.
+     */
+    billingMethod: AttachUpsertLicenseAddItemBillingMethod;
+    /**
+     * Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.
+     */
+    maxPurchase?: number | null | undefined;
 };
 /**
- * When the plan change should take effect. 'immediate' applies now, 'end_of_cycle' schedules for the end of the current billing cycle. By default, upgrades are immediate and downgrades are scheduled.
+ * Billing behavior when quantity increases mid-cycle.
  */
-declare const AttachPlanSchedule: {
-    readonly Immediate: "immediate";
-    readonly EndOfCycle: "end_of_cycle";
+declare const AttachUpsertLicenseOnIncrease: {
+    readonly BillImmediately: "bill_immediately";
+    readonly ProrateImmediately: "prorate_immediately";
+    readonly ProrateNextCycle: "prorate_next_cycle";
+    readonly BillNextCycle: "bill_next_cycle";
 };
 /**
- * When the plan change should take effect. 'immediate' applies now, 'end_of_cycle' schedules for the end of the current billing cycle. By default, upgrades are immediate and downgrades are scheduled.
+ * Billing behavior when quantity increases mid-cycle.
  */
-type AttachPlanSchedule = ClosedEnum<typeof AttachPlanSchedule>;
-type AttachCustomLineItem = {
-    /**
-     * Amount in dollars for this line item (e.g. 10.50). Can be negative for credits.
-     */
-    amount: number;
-    /**
-     * Description for the line item.
-     */
-    description: string;
+type AttachUpsertLicenseOnIncrease = ClosedEnum<typeof AttachUpsertLicenseOnIncrease>;
+/**
+ * Credit behavior when quantity decreases mid-cycle.
+ */
+declare const AttachUpsertLicenseOnDecrease: {
+    readonly Prorate: "prorate";
+    readonly ProrateImmediately: "prorate_immediately";
+    readonly ProrateNextCycle: "prorate_next_cycle";
+    readonly None: "none";
+    readonly NoProrations: "no_prorations";
 };
 /**
- * Whether to carry over balances from the previous plan.
+ * Credit behavior when quantity decreases mid-cycle.
  */
-type AttachCarryOverBalances = {
+type AttachUpsertLicenseOnDecrease = ClosedEnum<typeof AttachUpsertLicenseOnDecrease>;
+/**
+ * Proration settings for prepaid features. Controls mid-cycle quantity change billing.
+ */
+type AttachUpsertLicenseProration = {
     /**
-     * Whether to carry over balances from the previous plan.
+     * Billing behavior when quantity increases mid-cycle.
      */
-    enabled: boolean;
+    onIncrease: AttachUpsertLicenseOnIncrease;
     /**
-     * The IDs of the features to carry over balances from. If left undefined, all features will be carried over.
+     * Credit behavior when quantity decreases mid-cycle.
      */
-    featureIds?: Array<string> | undefined;
+    onDecrease: AttachUpsertLicenseOnDecrease;
 };
 /**
- * Whether to carry over usages from the previous plan.
+ * When rolled over units expire.
  */
-type AttachCarryOverUsages = {
-    /**
-     * Whether to carry over usages from the previous plan.
-     */
-    enabled: boolean;
-    /**
-     * The IDs of the features to carry over usages for. If left undefined, all consumable features will be carried over.
-     */
-    featureIds?: Array<string> | undefined;
+declare const AttachUpsertLicenseExpiryDurationType: {
+    readonly Month: "month";
+    readonly Forever: "forever";
 };
-type AttachParams = {
+/**
+ * When rolled over units expire.
+ */
+type AttachUpsertLicenseExpiryDurationType = ClosedEnum<typeof AttachUpsertLicenseExpiryDurationType>;
+/**
+ * Rollover config for unused units. If set, unused included units carry over.
+ */
+type AttachUpsertLicenseRollover = {
     /**
-     * The ID of the customer to attach the plan to.
+     * Max rollover units. Omit for unlimited rollover.
      */
-    customerId: string;
+    max?: number | undefined;
     /**
-     * The ID of the entity to attach the plan to.
+     * Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.
      */
-    entityId?: string | undefined;
+    maxPercentage?: number | undefined;
     /**
-     * The ID of the plan.
+     * When rolled over units expire.
      */
-    planId: string;
+    expiryDurationType: AttachUpsertLicenseExpiryDurationType;
     /**
-     * If this plan contains prepaid features, use this field to specify the quantity of each prepaid feature. This quantity includes the included amount and billing units defined when setting up the plan.
+     * Number of periods before expiry.
+     */
+    expiryDurationLength?: number | undefined;
+};
+/**
+ * Configuration for a feature item in a plan, including usage limits, pricing, and rollover settings.
+ */
+type AttachUpsertLicensePlanItem = {
+    /**
+     * The ID of the feature to configure.
+     */
+    featureId: string;
+    /**
+     * Number of free units included. Balance resets to this each interval for consumable features.
+     */
+    included?: number | undefined;
+    /**
+     * If true, customer has unlimited access to this feature.
+     */
+    unlimited?: boolean | undefined;
+    /**
+     * Reset configuration for consumable features. Omit for non-consumable features like seats.
+     */
+    reset?: AttachUpsertLicenseReset | undefined;
+    /**
+     * Pricing for usage beyond included units. Omit for free features.
+     */
+    price?: AttachUpsertLicensePrice | undefined;
+    /**
+     * Proration settings for prepaid features. Controls mid-cycle quantity change billing.
+     */
+    proration?: AttachUpsertLicenseProration | undefined;
+    /**
+     * Rollover config for unused units. If set, unused included units carry over.
+     */
+    rollover?: AttachUpsertLicenseRollover | undefined;
+};
+/**
+ * Match items with this billing method (prepaid or usage_based).
+ */
+declare const AttachUpsertLicenseRemoveItemBillingMethod: {
+    readonly Prepaid: "prepaid";
+    readonly UsageBased: "usage_based";
+};
+/**
+ * Match items with this billing method (prepaid or usage_based).
+ */
+type AttachUpsertLicenseRemoveItemBillingMethod = ClosedEnum<typeof AttachUpsertLicenseRemoveItemBillingMethod>;
+declare const AttachIntervalUpsertLicenseRemoveItemEnum2: {
+    readonly OneOff: "one_off";
+    readonly Minute: "minute";
+    readonly Hour: "hour";
+    readonly Day: "day";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Quarter: "quarter";
+    readonly SemiAnnual: "semi_annual";
+    readonly Year: "year";
+};
+type AttachIntervalUpsertLicenseRemoveItemEnum2 = ClosedEnum<typeof AttachIntervalUpsertLicenseRemoveItemEnum2>;
+declare const AttachIntervalUpsertLicenseRemoveItemEnum1: {
+    readonly OneOff: "one_off";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Quarter: "quarter";
+    readonly SemiAnnual: "semi_annual";
+    readonly Year: "year";
+};
+type AttachIntervalUpsertLicenseRemoveItemEnum1 = ClosedEnum<typeof AttachIntervalUpsertLicenseRemoveItemEnum1>;
+/**
+ * Filter for matching plan items. All provided fields must match (AND).
+ */
+type AttachUpsertLicensePlanItemFilter = {
+    /**
+     * Match items linked to this feature.
+     */
+    featureId?: string | undefined;
+    /**
+     * Match items with this billing method (prepaid or usage_based).
+     */
+    billingMethod?: AttachUpsertLicenseRemoveItemBillingMethod | undefined;
+    /**
+     * Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.
+     */
+    interval?: AttachIntervalUpsertLicenseRemoveItemEnum1 | AttachIntervalUpsertLicenseRemoveItemEnum2 | undefined;
+    /**
+     * Match items with this interval_count. Disambiguates between items that share an interval but differ in count.
+     */
+    intervalCount?: number | undefined;
+};
+type AttachUpsertLicenseCustomize = {
+    price?: AttachUpsertLicenseBasePrice | null | undefined;
+    addItems?: Array<AttachUpsertLicensePlanItem> | undefined;
+    removeItems?: Array<AttachUpsertLicensePlanItemFilter> | undefined;
+};
+type AttachUpsertLicense = {
+    licensePlanId: string;
+    included?: number | undefined;
+    prepaidOnly?: boolean | undefined;
+    customize?: AttachUpsertLicenseCustomize | null | undefined;
+    metadata?: {
+        [k: string]: any;
+    } | undefined;
+};
+/**
+ * Customize the plan to attach. Can override the price, items, licenses, free trial, or a combination.
+ */
+type AttachCustomize = {
+    /**
+     * Override the base price of the plan. Pass null to remove the base price.
+     */
+    price?: AttachBasePrice | null | undefined;
+    /**
+     * Override the items in the plan (PUT-style — replaces all existing items). Mutually exclusive with add_items / remove_items / deprecated update_items.
+     */
+    items?: Array<AttachItemPlanItem> | undefined;
+    /**
+     * Items to add to the plan.
+     */
+    addItems?: Array<AttachAddItemPlanItem> | undefined;
+    /**
+     * Filters selecting items to remove from the plan.
+     */
+    removeItems?: Array<AttachPlanItemFilter> | undefined;
+    /**
+     * Override the plan's default free trial. Pass an object to set a custom trial, or null to remove the trial entirely.
+     */
+    freeTrial?: AttachFreeTrialParams | null | undefined;
+    /**
+     * Override the plan's billing controls (auto top-ups, spend limits, usage limits, usage alerts, overage allowed) for this customer.
+     */
+    billingControls?: AttachBillingControls | undefined;
+    /**
+     * License links to add or override for this customer, keyed by license_plan_id. Omitted fields inherit the plan catalog link (included defaults to 1 when the license is not in the catalog). A bare entry restores the license to pure catalog inheritance.
+     */
+    upsertLicenses?: Array<AttachUpsertLicense> | undefined;
+};
+/**
+ * Invoice mode creates a draft or open invoice and sends it to the customer, instead of charging their card immediately. This uses Stripe's send_invoice collection method.
+ */
+type AttachInvoiceMode = {
+    /**
+     * When true, creates an invoice and sends it to the customer instead of charging their card immediately. Uses Stripe's send_invoice collection method.
+     */
+    enabled: boolean;
+    /**
+     * If true, enables the plan immediately even though the invoice is not paid yet.
+     */
+    enablePlanImmediately?: boolean | undefined;
+    /**
+     * If true, finalizes the invoice so it can be sent to the customer. If false, keeps it as a draft for manual review.
+     */
+    finalize?: boolean | undefined;
+    /**
+     * ID of an invoice template (configured in billing settings) whose footer (e.g. bank details) is applied to the invoice.
+     */
+    invoiceTemplateId?: string | undefined;
+    /**
+     * Number of days the customer has to pay the invoice before it is due (Stripe days_until_due).
+     */
+    netTermsDays?: number | undefined;
+};
+/**
+ * How to handle proration when updating an existing subscription. 'prorate_immediately' charges/credits prorated amounts now, 'none' skips creating any charges.
+ */
+declare const AttachProrationBehavior: {
+    readonly ProrateImmediately: "prorate_immediately";
+    readonly None: "none";
+};
+/**
+ * How to handle proration when updating an existing subscription. 'prorate_immediately' charges/credits prorated amounts now, 'none' skips creating any charges.
+ */
+type AttachProrationBehavior = ClosedEnum<typeof AttachProrationBehavior>;
+/**
+ * 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.
+ */
+declare const AttachRedirectMode: {
+    readonly Always: "always";
+    readonly IfRequired: "if_required";
+    readonly Never: "never";
+};
+/**
+ * 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.
+ */
+type AttachRedirectMode = ClosedEnum<typeof AttachRedirectMode>;
+/**
+ * A discount to apply. Can be either a reward ID or a promotion code.
+ */
+type AttachAttachDiscount = {
+    /**
+     * The ID of the reward to apply as a discount.
+     */
+    rewardId?: string | undefined;
+    /**
+     * The promotion code to apply as a discount.
+     */
+    promotionCode?: string | undefined;
+};
+/**
+ * When the plan change should take effect. 'immediate' applies now, 'end_of_cycle' schedules for the end of the current billing cycle. By default, upgrades are immediate and downgrades are scheduled.
+ */
+declare const AttachPlanSchedule: {
+    readonly Immediate: "immediate";
+    readonly EndOfCycle: "end_of_cycle";
+};
+/**
+ * When the plan change should take effect. 'immediate' applies now, 'end_of_cycle' schedules for the end of the current billing cycle. By default, upgrades are immediate and downgrades are scheduled.
+ */
+type AttachPlanSchedule = ClosedEnum<typeof AttachPlanSchedule>;
+type AttachCustomLineItem = {
+    /**
+     * Amount in dollars for this line item (e.g. 10.50). Can be negative for credits.
+     */
+    amount: number;
+    /**
+     * Description for the line item.
+     */
+    description: string;
+};
+/**
+ * Whether to carry over balances from the previous plan.
+ */
+type AttachCarryOverBalances = {
+    /**
+     * Whether to carry over balances from the previous plan.
+     */
+    enabled: boolean;
+    /**
+     * The IDs of the features to carry over balances from. If left undefined, all features will be carried over.
+     */
+    featureIds?: Array<string> | undefined;
+};
+/**
+ * Whether to carry over usages from the previous plan.
+ */
+type AttachCarryOverUsages = {
+    /**
+     * Whether to carry over usages from the previous plan.
+     */
+    enabled: boolean;
+    /**
+     * The IDs of the features to carry over usages for. If left undefined, all consumable features will be carried over.
+     */
+    featureIds?: Array<string> | undefined;
+};
+type AttachLicenseQuantity = {
+    /**
+     * The license plan to set seat quantity for.
+     */
+    licensePlanId: string;
+    /**
+     * Total seats for the license, inclusive of the plan's included amount — seats beyond it are paid.
+     */
+    quantity: number;
+};
+type AttachParams = {
+    /**
+     * The ID of the customer to attach the plan to.
+     */
+    customerId: string;
+    /**
+     * The ID of the entity to attach the plan to.
+     */
+    entityId?: string | undefined;
+    /**
+     * The ID of the plan.
+     */
+    planId: string;
+    /**
+     * If this plan contains prepaid features, use this field to specify the quantity of each prepaid feature. This quantity includes the included amount and billing units defined when setting up the plan.
      */
     featureQuantities?: Array<AttachFeatureQuantity> | undefined;
     /**
@@ -1041,7 +1470,7 @@ type AttachParams = {
      */
     version?: number | undefined;
     /**
-     * Customize the plan to attach. Can override the price, items, free trial, or a combination.
+     * Customize the plan to attach. Can override the price, items, licenses, free trial, or a combination.
      */
     customize?: AttachCustomize | undefined;
     /**
@@ -1114,6 +1543,10 @@ type AttachParams = {
      * Whether to carry over usages from the previous plan.
      */
     carryOverUsages?: AttachCarryOverUsages | undefined;
+    /**
+     * Seat quantities for the plan's licenses, keyed by license plan.
+     */
+    licenseQuantities?: Array<AttachLicenseQuantity> | undefined;
     /**
      * Key-value metadata to attach to the Stripe subscription, invoice, and checkout session created during this attach flow. Keys prefixed with 'autumn_' are reserved and will be stripped.
      */
@@ -1132,6 +1565,10 @@ type AttachParams = {
      * Stripe tax rate ID (txr_...) to apply as the default tax rate on the created subscription, invoice, or checkout session line items.
      */
     taxRateId?: string | undefined;
+    /**
+     * Currency to bill this attach in (e.g. usd, eur). Must match the customer's currency if they are already locked to one, and the plan must offer a paid price in it. Defaults to the customer's currency, then the org default.
+     */
+    currency?: string | undefined;
 };
 /**
  * Invoice details if an invoice was created. Only present when a charge was made.
@@ -1242,6 +1679,16 @@ declare const BillingUpdatePriceInterval: {
  * Billing interval (e.g. 'month', 'year').
  */
 type BillingUpdatePriceInterval = ClosedEnum<typeof BillingUpdatePriceInterval>;
+type BillingUpdateAdditionalCurrency = {
+    /**
+     * Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').
+     */
+    currency: string;
+    /**
+     * Price amount in this currency. Set explicitly per currency, not converted from the base amount.
+     */
+    amount: number;
+};
 /**
  * Base price configuration for a plan.
  */
@@ -1258,6 +1705,10 @@ type BillingUpdateBasePrice = {
      * Number of intervals per billing cycle. Defaults to 1.
      */
     intervalCount?: number | undefined;
+    /**
+     * Base price amounts in additional currencies. The base 'amount' is in the org's default currency.
+     */
+    additionalCurrencies?: Array<BillingUpdateAdditionalCurrency> | undefined;
 };
 /**
  * Interval at which balance resets (e.g. 'month', 'year'). For consumable features only.
@@ -1290,10 +1741,38 @@ type BillingUpdateItemReset = {
      */
     intervalCount?: number | undefined;
 };
-type BillingUpdateItemTier = {
-    to: number | string;
-    amount?: number | undefined;
+type BillingUpdateItemAdditionalCurrency = {
+    /**
+     * Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').
+     */
+    currency: string;
+    /**
+     * Price amount in this currency. Set explicitly per currency, not converted from the base amount.
+     */
+    amount: number;
+};
+type BillingUpdateItemTierAdditionalCurrency = {
+    /**
+     * Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').
+     */
+    currency: string;
+    /**
+     * Per-unit amount for this tier in this currency.
+     */
+    amount?: number | undefined;
+    /**
+     * Flat amount for this tier in this currency, if the tier uses one.
+     */
+    flatAmount?: number | undefined;
+};
+type BillingUpdateItemTier = {
+    to: number | string;
+    amount?: number | undefined;
     flatAmount?: number | undefined;
+    /**
+     * Per-currency amounts for this tier. Tier boundaries ('to') are shared across all currencies.
+     */
+    additionalCurrencies?: Array<BillingUpdateItemTierAdditionalCurrency> | undefined;
 };
 declare const BillingUpdateItemTierBehavior: {
     readonly Graduated: "graduated";
@@ -1334,6 +1813,10 @@ type BillingUpdateItemPrice = {
      * Price per billing_units after included usage. Either 'amount' or 'tiers' is required.
      */
     amount?: number | undefined;
+    /**
+     * Amounts in additional currencies for this flat price. The base 'amount' is in the org's default currency. Only valid with 'amount', not 'tiers'.
+     */
+    additionalCurrencies?: Array<BillingUpdateItemAdditionalCurrency> | undefined;
     /**
      * Tiered pricing.  Either 'amount' or 'tiers' is required.
      */
@@ -1496,10 +1979,38 @@ type BillingUpdateAddItemReset = {
      */
     intervalCount?: number | undefined;
 };
+type BillingUpdateAddItemAdditionalCurrency = {
+    /**
+     * Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').
+     */
+    currency: string;
+    /**
+     * Price amount in this currency. Set explicitly per currency, not converted from the base amount.
+     */
+    amount: number;
+};
+type BillingUpdateAddItemTierAdditionalCurrency = {
+    /**
+     * Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').
+     */
+    currency: string;
+    /**
+     * Per-unit amount for this tier in this currency.
+     */
+    amount?: number | undefined;
+    /**
+     * Flat amount for this tier in this currency, if the tier uses one.
+     */
+    flatAmount?: number | undefined;
+};
 type BillingUpdateAddItemTier = {
     to: number | string;
     amount?: number | undefined;
     flatAmount?: number | undefined;
+    /**
+     * Per-currency amounts for this tier. Tier boundaries ('to') are shared across all currencies.
+     */
+    additionalCurrencies?: Array<BillingUpdateAddItemTierAdditionalCurrency> | undefined;
 };
 declare const BillingUpdateAddItemTierBehavior: {
     readonly Graduated: "graduated";
@@ -1540,6 +2051,10 @@ type BillingUpdateAddItemPrice = {
      * Price per billing_units after included usage. Either 'amount' or 'tiers' is required.
      */
     amount?: number | undefined;
+    /**
+     * Amounts in additional currencies for this flat price. The base 'amount' is in the org's default currency. Only valid with 'amount', not 'tiers'.
+     */
+    additionalCurrencies?: Array<BillingUpdateAddItemAdditionalCurrency> | undefined;
     /**
      * Tiered pricing.  Either 'amount' or 'tiers' is required.
      */
@@ -1971,163 +2486,514 @@ type BillingUpdateBillingControls = {
     overageAllowed?: Array<BillingUpdateOverageAllowed> | undefined;
 };
 /**
- * Customize the plan to attach. Can override the price, items, free trial, or a combination.
+ * Billing interval (e.g. 'month', 'year').
  */
-type BillingUpdateCustomize = {
+declare const BillingUpdatePriceUpsertLicenseInterval: {
+    readonly OneOff: "one_off";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Quarter: "quarter";
+    readonly SemiAnnual: "semi_annual";
+    readonly Year: "year";
+};
+/**
+ * Billing interval (e.g. 'month', 'year').
+ */
+type BillingUpdatePriceUpsertLicenseInterval = ClosedEnum<typeof BillingUpdatePriceUpsertLicenseInterval>;
+type BillingUpdateUpsertLicenseAdditionalCurrency = {
     /**
-     * Override the base price of the plan. Pass null to remove the base price.
+     * Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').
      */
-    price?: BillingUpdateBasePrice | null | undefined;
+    currency: string;
     /**
-     * Override the items in the plan (PUT-style — replaces all existing items). Mutually exclusive with add_items / remove_items / deprecated update_items.
+     * Price amount in this currency. Set explicitly per currency, not converted from the base amount.
      */
-    items?: Array<BillingUpdateItemPlanItem> | undefined;
+    amount: number;
+};
+/**
+ * Base price configuration for a plan.
+ */
+type BillingUpdateUpsertLicenseBasePrice = {
     /**
-     * Items to add to the plan.
+     * Base price amount for the plan.
      */
-    addItems?: Array<BillingUpdateAddItemPlanItem> | undefined;
+    amount: number;
     /**
-     * Filters selecting items to remove from the plan.
+     * Billing interval (e.g. 'month', 'year').
      */
-    removeItems?: Array<BillingUpdatePlanItemFilter> | undefined;
+    interval: BillingUpdatePriceUpsertLicenseInterval;
     /**
-     * Override the plan's default free trial. Pass an object to set a custom trial, or null to remove the trial entirely.
+     * Number of intervals per billing cycle. Defaults to 1.
      */
-    freeTrial?: BillingUpdateFreeTrialParams | null | undefined;
+    intervalCount?: number | undefined;
     /**
-     * Override the plan's billing controls (auto top-ups, spend limits, usage limits, usage alerts, overage allowed) for this customer.
+     * Base price amounts in additional currencies. The base 'amount' is in the org's default currency.
      */
-    billingControls?: BillingUpdateBillingControls | undefined;
+    additionalCurrencies?: Array<BillingUpdateUpsertLicenseAdditionalCurrency> | undefined;
 };
 /**
- * Invoice mode creates a draft or open invoice and sends it to the customer, instead of charging their card immediately. This uses Stripe's send_invoice collection method.
+ * Interval at which balance resets (e.g. 'month', 'year'). For consumable features only.
  */
-type BillingUpdateInvoiceMode = {
+declare const BillingUpdateUpsertLicenseResetInterval: {
+    readonly OneOff: "one_off";
+    readonly Minute: "minute";
+    readonly Hour: "hour";
+    readonly Day: "day";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Quarter: "quarter";
+    readonly SemiAnnual: "semi_annual";
+    readonly Year: "year";
+};
+/**
+ * Interval at which balance resets (e.g. 'month', 'year'). For consumable features only.
+ */
+type BillingUpdateUpsertLicenseResetInterval = ClosedEnum<typeof BillingUpdateUpsertLicenseResetInterval>;
+/**
+ * Reset configuration for consumable features. Omit for non-consumable features like seats.
+ */
+type BillingUpdateUpsertLicenseReset = {
     /**
-     * When true, creates an invoice and sends it to the customer instead of charging their card immediately. Uses Stripe's send_invoice collection method.
+     * Interval at which balance resets (e.g. 'month', 'year'). For consumable features only.
      */
-    enabled: boolean;
+    interval: BillingUpdateUpsertLicenseResetInterval;
     /**
-     * If true, enables the plan immediately even though the invoice is not paid yet.
+     * Number of intervals between resets. Defaults to 1.
      */
-    enablePlanImmediately?: boolean | undefined;
+    intervalCount?: number | undefined;
+};
+type BillingUpdateUpsertLicenseAddItemAdditionalCurrency = {
     /**
-     * If true, finalizes the invoice so it can be sent to the customer. If false, keeps it as a draft for manual review.
+     * Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').
      */
-    finalize?: boolean | undefined;
+    currency: string;
     /**
-     * ID of an invoice template (configured in billing settings) whose footer (e.g. bank details) is applied to the invoice.
+     * Price amount in this currency. Set explicitly per currency, not converted from the base amount.
      */
-    invoiceTemplateId?: string | undefined;
+    amount: number;
+};
+type BillingUpdateUpsertLicenseTier = {
+    to?: any | undefined;
+    amount?: number | undefined;
+    flatAmount?: number | undefined;
     /**
-     * Number of days the customer has to pay the invoice before it is due (Stripe days_until_due).
+     * Per-currency amounts for this tier. Tier boundaries ('to') are shared across all currencies.
      */
-    netTermsDays?: number | undefined;
+    additionalCurrencies?: Array<any> | undefined;
+};
+declare const BillingUpdateUpsertLicenseTierBehavior: {
+    readonly Graduated: "graduated";
+    readonly Volume: "volume";
 };
+type BillingUpdateUpsertLicenseTierBehavior = ClosedEnum<typeof BillingUpdateUpsertLicenseTierBehavior>;
 /**
- * How to handle proration when updating an existing subscription. 'prorate_immediately' charges/credits prorated amounts now, 'none' skips creating any charges.
+ * Billing interval. For consumable features, should match reset.interval.
  */
-declare const BillingUpdateProrationBehavior: {
-    readonly ProrateImmediately: "prorate_immediately";
-    readonly None: "none";
+declare const BillingUpdateUpsertLicenseAddItemPriceInterval: {
+    readonly OneOff: "one_off";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Quarter: "quarter";
+    readonly SemiAnnual: "semi_annual";
+    readonly Year: "year";
 };
 /**
- * How to handle proration when updating an existing subscription. 'prorate_immediately' charges/credits prorated amounts now, 'none' skips creating any charges.
+ * Billing interval. For consumable features, should match reset.interval.
  */
-type BillingUpdateProrationBehavior = ClosedEnum<typeof BillingUpdateProrationBehavior>;
+type BillingUpdateUpsertLicenseAddItemPriceInterval = ClosedEnum<typeof BillingUpdateUpsertLicenseAddItemPriceInterval>;
 /**
- * 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.
+ * 'prepaid' for upfront payment (seats), 'usage_based' for pay-as-you-go.
  */
-declare const BillingUpdateRedirectMode: {
-    readonly Always: "always";
-    readonly IfRequired: "if_required";
-    readonly Never: "never";
+declare const BillingUpdateUpsertLicenseAddItemBillingMethod: {
+    readonly Prepaid: "prepaid";
+    readonly UsageBased: "usage_based";
 };
 /**
- * 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.
+ * 'prepaid' for upfront payment (seats), 'usage_based' for pay-as-you-go.
  */
-type BillingUpdateRedirectMode = ClosedEnum<typeof BillingUpdateRedirectMode>;
+type BillingUpdateUpsertLicenseAddItemBillingMethod = ClosedEnum<typeof BillingUpdateUpsertLicenseAddItemBillingMethod>;
 /**
- * A discount to apply. Can be either a reward ID or a promotion code.
+ * Pricing for usage beyond included units. Omit for free features.
  */
-type BillingUpdateAttachDiscount = {
+type BillingUpdateUpsertLicensePrice = {
     /**
-     * The ID of the reward to apply as a discount.
+     * Price per billing_units after included usage. Either 'amount' or 'tiers' is required.
      */
-    rewardId?: string | undefined;
+    amount?: number | undefined;
     /**
-     * The promotion code to apply as a discount.
+     * Amounts in additional currencies for this flat price. The base 'amount' is in the org's default currency. Only valid with 'amount', not 'tiers'.
      */
-    promotionCode?: string | undefined;
+    additionalCurrencies?: Array<BillingUpdateUpsertLicenseAddItemAdditionalCurrency> | undefined;
+    /**
+     * Tiered pricing.  Either 'amount' or 'tiers' is required.
+     */
+    tiers?: Array<BillingUpdateUpsertLicenseTier> | undefined;
+    tierBehavior?: BillingUpdateUpsertLicenseTierBehavior | undefined;
+    /**
+     * Billing interval. For consumable features, should match reset.interval.
+     */
+    interval: BillingUpdateUpsertLicenseAddItemPriceInterval;
+    /**
+     * Number of intervals per billing cycle. Defaults to 1.
+     */
+    intervalCount?: number | undefined;
+    /**
+     * Units per price increment. Usage is rounded UP when billed (e.g. billing_units=100 means 101 rounds to 200).
+     */
+    billingUnits?: number | undefined;
+    /**
+     * 'prepaid' for upfront payment (seats), 'usage_based' for pay-as-you-go.
+     */
+    billingMethod: BillingUpdateUpsertLicenseAddItemBillingMethod;
+    /**
+     * Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.
+     */
+    maxPurchase?: number | null | 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.
+ * Billing behavior when quantity increases mid-cycle.
  */
-declare const BillingUpdateCancelAction: {
-    readonly CancelImmediately: "cancel_immediately";
-    readonly CancelEndOfCycle: "cancel_end_of_cycle";
-    readonly Uncancel: "uncancel";
+declare const BillingUpdateUpsertLicenseOnIncrease: {
+    readonly BillImmediately: "bill_immediately";
+    readonly ProrateImmediately: "prorate_immediately";
+    readonly ProrateNextCycle: "prorate_next_cycle";
+    readonly BillNextCycle: "bill_next_cycle";
 };
 /**
- * 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.
+ * Billing behavior when quantity increases mid-cycle.
  */
-type BillingUpdateCancelAction = ClosedEnum<typeof BillingUpdateCancelAction>;
+type BillingUpdateUpsertLicenseOnIncrease = ClosedEnum<typeof BillingUpdateUpsertLicenseOnIncrease>;
 /**
- * Controls how the last payment is refunded on immediate cancellation. 'prorated' refunds the unused portion, 'full' refunds the entire last payment.
+ * Credit behavior when quantity decreases mid-cycle.
  */
-declare const BillingUpdateRefundLastPayment: {
-    readonly Prorated: "prorated";
-    readonly Full: "full";
+declare const BillingUpdateUpsertLicenseOnDecrease: {
+    readonly Prorate: "prorate";
+    readonly ProrateImmediately: "prorate_immediately";
+    readonly ProrateNextCycle: "prorate_next_cycle";
+    readonly None: "none";
+    readonly NoProrations: "no_prorations";
 };
 /**
- * Controls how the last payment is refunded on immediate cancellation. 'prorated' refunds the unused portion, 'full' refunds the entire last payment.
+ * Credit behavior when quantity decreases mid-cycle.
  */
-type BillingUpdateRefundLastPayment = ClosedEnum<typeof BillingUpdateRefundLastPayment>;
+type BillingUpdateUpsertLicenseOnDecrease = ClosedEnum<typeof BillingUpdateUpsertLicenseOnDecrease>;
 /**
- * Controls whether balances should be recalculated during the subscription update.
+ * Proration settings for prepaid features. Controls mid-cycle quantity change billing.
  */
-type BillingUpdateRecalculateBalances = {
+type BillingUpdateUpsertLicenseProration = {
     /**
-     * If true, recalculates balances during the subscription update. Only applicable when updating feature quantities.
+     * Billing behavior when quantity increases mid-cycle.
      */
-    enabled: boolean;
+    onIncrease: BillingUpdateUpsertLicenseOnIncrease;
+    /**
+     * Credit behavior when quantity decreases mid-cycle.
+     */
+    onDecrease: BillingUpdateUpsertLicenseOnDecrease;
 };
 /**
- * Whether to carry over usages from the previous plan.
+ * When rolled over units expire.
  */
-type BillingUpdateCarryOverUsages = {
+declare const BillingUpdateUpsertLicenseExpiryDurationType: {
+    readonly Month: "month";
+    readonly Forever: "forever";
+};
+/**
+ * When rolled over units expire.
+ */
+type BillingUpdateUpsertLicenseExpiryDurationType = ClosedEnum<typeof BillingUpdateUpsertLicenseExpiryDurationType>;
+/**
+ * Rollover config for unused units. If set, unused included units carry over.
+ */
+type BillingUpdateUpsertLicenseRollover = {
     /**
-     * Whether to carry over usages from the previous plan.
+     * Max rollover units. Omit for unlimited rollover.
      */
-    enabled: boolean;
+    max?: number | undefined;
     /**
-     * The IDs of the features to carry over usages for. If left undefined, all consumable features will be carried over.
+     * Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.
      */
-    featureIds?: Array<string> | undefined;
-};
-type UpdateSubscriptionParams = {
+    maxPercentage?: number | undefined;
     /**
-     * The ID of the customer to attach the plan to.
+     * When rolled over units expire.
      */
-    customerId: string;
+    expiryDurationType: BillingUpdateUpsertLicenseExpiryDurationType;
     /**
-     * The ID of the entity to attach the plan to.
+     * Number of periods before expiry.
      */
-    entityId?: string | undefined;
+    expiryDurationLength?: number | undefined;
+};
+/**
+ * Configuration for a feature item in a plan, including usage limits, pricing, and rollover settings.
+ */
+type BillingUpdateUpsertLicensePlanItem = {
     /**
-     * The ID of the plan to update. Optional if subscription_id is provided, or if the customer has only one product.
+     * The ID of the feature to configure.
      */
-    planId?: string | undefined;
+    featureId: string;
     /**
-     * If this plan contains prepaid features, use this field to specify the quantity of each prepaid feature. This quantity includes the included amount and billing units defined when setting up the plan.
+     * Number of free units included. Balance resets to this each interval for consumable features.
      */
-    featureQuantities?: Array<BillingUpdateFeatureQuantity> | undefined;
+    included?: number | undefined;
     /**
-     * The version of the plan to attach.
+     * If true, customer has unlimited access to this feature.
      */
-    version?: number | undefined;
+    unlimited?: boolean | undefined;
     /**
-     * Customize the plan to attach. Can override the price, items, free trial, or a combination.
+     * Reset configuration for consumable features. Omit for non-consumable features like seats.
+     */
+    reset?: BillingUpdateUpsertLicenseReset | undefined;
+    /**
+     * Pricing for usage beyond included units. Omit for free features.
+     */
+    price?: BillingUpdateUpsertLicensePrice | undefined;
+    /**
+     * Proration settings for prepaid features. Controls mid-cycle quantity change billing.
+     */
+    proration?: BillingUpdateUpsertLicenseProration | undefined;
+    /**
+     * Rollover config for unused units. If set, unused included units carry over.
+     */
+    rollover?: BillingUpdateUpsertLicenseRollover | undefined;
+};
+/**
+ * Match items with this billing method (prepaid or usage_based).
+ */
+declare const BillingUpdateUpsertLicenseRemoveItemBillingMethod: {
+    readonly Prepaid: "prepaid";
+    readonly UsageBased: "usage_based";
+};
+/**
+ * Match items with this billing method (prepaid or usage_based).
+ */
+type BillingUpdateUpsertLicenseRemoveItemBillingMethod = ClosedEnum<typeof BillingUpdateUpsertLicenseRemoveItemBillingMethod>;
+declare const BillingUpdateIntervalUpsertLicenseRemoveItemEnum2: {
+    readonly OneOff: "one_off";
+    readonly Minute: "minute";
+    readonly Hour: "hour";
+    readonly Day: "day";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Quarter: "quarter";
+    readonly SemiAnnual: "semi_annual";
+    readonly Year: "year";
+};
+type BillingUpdateIntervalUpsertLicenseRemoveItemEnum2 = ClosedEnum<typeof BillingUpdateIntervalUpsertLicenseRemoveItemEnum2>;
+declare const BillingUpdateIntervalUpsertLicenseRemoveItemEnum1: {
+    readonly OneOff: "one_off";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Quarter: "quarter";
+    readonly SemiAnnual: "semi_annual";
+    readonly Year: "year";
+};
+type BillingUpdateIntervalUpsertLicenseRemoveItemEnum1 = ClosedEnum<typeof BillingUpdateIntervalUpsertLicenseRemoveItemEnum1>;
+/**
+ * Filter for matching plan items. All provided fields must match (AND).
+ */
+type BillingUpdateUpsertLicensePlanItemFilter = {
+    /**
+     * Match items linked to this feature.
+     */
+    featureId?: string | undefined;
+    /**
+     * Match items with this billing method (prepaid or usage_based).
+     */
+    billingMethod?: BillingUpdateUpsertLicenseRemoveItemBillingMethod | undefined;
+    /**
+     * Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.
+     */
+    interval?: BillingUpdateIntervalUpsertLicenseRemoveItemEnum1 | BillingUpdateIntervalUpsertLicenseRemoveItemEnum2 | undefined;
+    /**
+     * Match items with this interval_count. Disambiguates between items that share an interval but differ in count.
+     */
+    intervalCount?: number | undefined;
+};
+type BillingUpdateUpsertLicenseCustomize = {
+    price?: BillingUpdateUpsertLicenseBasePrice | null | undefined;
+    addItems?: Array<BillingUpdateUpsertLicensePlanItem> | undefined;
+    removeItems?: Array<BillingUpdateUpsertLicensePlanItemFilter> | undefined;
+};
+type BillingUpdateUpsertLicense = {
+    licensePlanId: string;
+    included?: number | undefined;
+    prepaidOnly?: boolean | undefined;
+    customize?: BillingUpdateUpsertLicenseCustomize | null | undefined;
+    metadata?: {
+        [k: string]: any;
+    } | undefined;
+};
+/**
+ * Customize the plan to attach. Can override the price, items, licenses, free trial, or a combination.
+ */
+type BillingUpdateCustomize = {
+    /**
+     * Override the base price of the plan. Pass null to remove the base price.
+     */
+    price?: BillingUpdateBasePrice | null | undefined;
+    /**
+     * Override the items in the plan (PUT-style — replaces all existing items). Mutually exclusive with add_items / remove_items / deprecated update_items.
+     */
+    items?: Array<BillingUpdateItemPlanItem> | undefined;
+    /**
+     * Items to add to the plan.
+     */
+    addItems?: Array<BillingUpdateAddItemPlanItem> | undefined;
+    /**
+     * Filters selecting items to remove from the plan.
+     */
+    removeItems?: Array<BillingUpdatePlanItemFilter> | undefined;
+    /**
+     * Override the plan's default free trial. Pass an object to set a custom trial, or null to remove the trial entirely.
+     */
+    freeTrial?: BillingUpdateFreeTrialParams | null | undefined;
+    /**
+     * Override the plan's billing controls (auto top-ups, spend limits, usage limits, usage alerts, overage allowed) for this customer.
+     */
+    billingControls?: BillingUpdateBillingControls | undefined;
+    /**
+     * License links to add or override for this customer, keyed by license_plan_id. Omitted fields inherit the plan catalog link (included defaults to 1 when the license is not in the catalog). A bare entry restores the license to pure catalog inheritance.
+     */
+    upsertLicenses?: Array<BillingUpdateUpsertLicense> | undefined;
+};
+/**
+ * Invoice mode creates a draft or open invoice and sends it to the customer, instead of charging their card immediately. This uses Stripe's send_invoice collection method.
+ */
+type BillingUpdateInvoiceMode = {
+    /**
+     * When true, creates an invoice and sends it to the customer instead of charging their card immediately. Uses Stripe's send_invoice collection method.
+     */
+    enabled: boolean;
+    /**
+     * If true, enables the plan immediately even though the invoice is not paid yet.
+     */
+    enablePlanImmediately?: boolean | undefined;
+    /**
+     * If true, finalizes the invoice so it can be sent to the customer. If false, keeps it as a draft for manual review.
+     */
+    finalize?: boolean | undefined;
+    /**
+     * ID of an invoice template (configured in billing settings) whose footer (e.g. bank details) is applied to the invoice.
+     */
+    invoiceTemplateId?: string | undefined;
+    /**
+     * Number of days the customer has to pay the invoice before it is due (Stripe days_until_due).
+     */
+    netTermsDays?: number | undefined;
+};
+/**
+ * How to handle proration when updating an existing subscription. 'prorate_immediately' charges/credits prorated amounts now, 'none' skips creating any charges.
+ */
+declare const BillingUpdateProrationBehavior: {
+    readonly ProrateImmediately: "prorate_immediately";
+    readonly None: "none";
+};
+/**
+ * How to handle proration when updating an existing subscription. 'prorate_immediately' charges/credits prorated amounts now, 'none' skips creating any charges.
+ */
+type BillingUpdateProrationBehavior = ClosedEnum<typeof BillingUpdateProrationBehavior>;
+/**
+ * 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.
+ */
+declare const BillingUpdateRedirectMode: {
+    readonly Always: "always";
+    readonly IfRequired: "if_required";
+    readonly Never: "never";
+};
+/**
+ * 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.
+ */
+type BillingUpdateRedirectMode = ClosedEnum<typeof BillingUpdateRedirectMode>;
+/**
+ * A discount to apply. Can be either a reward ID or a promotion code.
+ */
+type BillingUpdateAttachDiscount = {
+    /**
+     * The ID of the reward to apply as a discount.
+     */
+    rewardId?: string | undefined;
+    /**
+     * The promotion code to apply as a discount.
+     */
+    promotionCode?: 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.
+ */
+declare const BillingUpdateCancelAction: {
+    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 BillingUpdateCancelAction = ClosedEnum<typeof BillingUpdateCancelAction>;
+/**
+ * Controls how the last payment is refunded on immediate cancellation. 'prorated' refunds the unused portion, 'full' refunds the entire last payment.
+ */
+declare const BillingUpdateRefundLastPayment: {
+    readonly Prorated: "prorated";
+    readonly Full: "full";
+};
+/**
+ * Controls how the last payment is refunded on immediate cancellation. 'prorated' refunds the unused portion, 'full' refunds the entire last payment.
+ */
+type BillingUpdateRefundLastPayment = ClosedEnum<typeof BillingUpdateRefundLastPayment>;
+/**
+ * Controls whether balances should be recalculated during the subscription update.
+ */
+type BillingUpdateRecalculateBalances = {
+    /**
+     * If true, recalculates balances during the subscription update. Only applicable when updating feature quantities.
+     */
+    enabled: boolean;
+};
+/**
+ * Whether to carry over usages from the previous plan.
+ */
+type BillingUpdateCarryOverUsages = {
+    /**
+     * Whether to carry over usages from the previous plan.
+     */
+    enabled: boolean;
+    /**
+     * The IDs of the features to carry over usages for. If left undefined, all consumable features will be carried over.
+     */
+    featureIds?: Array<string> | undefined;
+};
+type BillingUpdateLicenseQuantity = {
+    /**
+     * The license plan to set seat quantity for.
+     */
+    licensePlanId: string;
+    /**
+     * Total seats for the license, inclusive of the plan's included amount — seats beyond it are paid.
+     */
+    quantity: number;
+};
+type UpdateSubscriptionParams = {
+    /**
+     * The ID of the customer to attach the plan to.
+     */
+    customerId: string;
+    /**
+     * The ID of the entity to attach the plan to.
+     */
+    entityId?: string | undefined;
+    /**
+     * The ID of the plan to update. Optional if subscription_id is provided, or if the customer has only one product.
+     */
+    planId?: string | undefined;
+    /**
+     * If this plan contains prepaid features, use this field to specify the quantity of each prepaid feature. This quantity includes the included amount and billing units defined when setting up the plan.
+     */
+    featureQuantities?: Array<BillingUpdateFeatureQuantity> | undefined;
+    /**
+     * The version of the plan to attach.
+     */
+    version?: number | undefined;
+    /**
+     * Customize the plan to attach. Can override the price, items, licenses, free trial, or a combination.
      */
     customize?: BillingUpdateCustomize | undefined;
     /**
@@ -2174,6 +3040,10 @@ type UpdateSubscriptionParams = {
      * Whether to carry over usages from the previous plan.
      */
     carryOverUsages?: BillingUpdateCarryOverUsages | undefined;
+    /**
+     * Total seat quantities (inclusive of the license's included count) per license plan offered by this plan. Licenses not listed keep their current paid quantity.
+     */
+    licenseQuantities?: Array<BillingUpdateLicenseQuantity> | undefined;
 };
 /**
  * Invoice details if an invoice was created. Only present when a charge was made.
@@ -3952,6 +4822,10 @@ type CustomerData = {
      * Whether to send email receipts to this customer
      */
     sendEmailReceipts?: boolean | undefined;
+    /**
+     * Currency to bill this customer in (e.g. usd, eur). Defaults to the organization's default currency.
+     */
+    currency?: string | null | undefined;
     /**
      * Billing controls for the customer (auto top-ups, etc.)
      */
@@ -4690,6 +5564,16 @@ declare const MultiAttachPriceInterval: {
  * Billing interval (e.g. 'month', 'year').
  */
 type MultiAttachPriceInterval = ClosedEnum<typeof MultiAttachPriceInterval>;
+type MultiAttachAdditionalCurrency = {
+    /**
+     * Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').
+     */
+    currency: string;
+    /**
+     * Price amount in this currency. Set explicitly per currency, not converted from the base amount.
+     */
+    amount: number;
+};
 /**
  * Base price configuration for a plan.
  */
@@ -4706,6 +5590,10 @@ type MultiAttachBasePrice = {
      * Number of intervals per billing cycle. Defaults to 1.
      */
     intervalCount?: number | undefined;
+    /**
+     * Base price amounts in additional currencies. The base 'amount' is in the org's default currency.
+     */
+    additionalCurrencies?: Array<MultiAttachAdditionalCurrency> | undefined;
 };
 /**
  * Interval at which balance resets (e.g. 'month', 'year'). For consumable features only.
@@ -4738,10 +5626,29 @@ type MultiAttachReset = {
      */
     intervalCount?: number | undefined;
 };
+type MultiAttachItemAdditionalCurrency = {
+    /**
+     * Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').
+     */
+    currency: string;
+    /**
+     * Price amount in this currency. Set explicitly per currency, not converted from the base amount.
+     */
+    amount: number;
+};
+type MultiAttachTierAdditionalCurrency = {
+    currency?: any | undefined;
+    amount?: any | undefined;
+    flatAmount?: any | undefined;
+};
 type MultiAttachTier = {
     to: number | string;
     amount?: number | undefined;
     flatAmount?: number | undefined;
+    /**
+     * Per-currency amounts for this tier. Tier boundaries ('to') are shared across all currencies.
+     */
+    additionalCurrencies?: Array<MultiAttachTierAdditionalCurrency> | undefined;
 };
 declare const MultiAttachTierBehavior: {
     readonly Graduated: "graduated";
@@ -4782,6 +5689,10 @@ type MultiAttachPrice = {
      * Price per billing_units after included usage. Either 'amount' or 'tiers' is required.
      */
     amount?: number | undefined;
+    /**
+     * Amounts in additional currencies for this flat price. The base 'amount' is in the org's default currency. Only valid with 'amount', not 'tiers'.
+     */
+    additionalCurrencies?: Array<MultiAttachItemAdditionalCurrency> | undefined;
     /**
      * Tiered pricing.  Either 'amount' or 'tiers' is required.
      */
@@ -4914,7 +5825,7 @@ type MultiAttachPlanItem = {
     rollover?: MultiAttachRollover | undefined;
 };
 /**
- * Customize the plan to attach. Can override the price or items.
+ * Customize the plan to attach. Can override the price, items, or licenses.
  */
 type MultiAttachCustomize = {
     /**
@@ -4949,7 +5860,7 @@ type MultiAttachPlan = {
      */
     planId: string;
     /**
-     * Customize the plan to attach. Can override the price or items.
+     * Customize the plan to attach. Can override the price, items, or licenses.
      */
     customize?: MultiAttachCustomize | undefined;
     /**
@@ -5232,6 +6143,10 @@ type MultiAttachParams = {
      * Free trial configuration applied to all plans. Pass an object to set a custom trial, or null to remove any trial.
      */
     freeTrial?: MultiAttachFreeTrialParams | null | undefined;
+    /**
+     * Currency to bill this multi-attach in (e.g. usd, eur). Must match the customer's currency if they are already locked to one, and every plan must offer a paid price in it. Defaults to the customer's currency, then the org default.
+     */
+    currency?: string | undefined;
     /**
      * Invoice mode creates a draft or open invoice and sends it to the customer, instead of charging their card immediately.
      */
@@ -5405,9 +6320,19 @@ declare const PreviewAttachPriceInterval: {
  * Billing interval (e.g. 'month', 'year').
  */
 type PreviewAttachPriceInterval = ClosedEnum<typeof PreviewAttachPriceInterval>;
-/**
- * Base price configuration for a plan.
- */
+type PreviewAttachAdditionalCurrency = {
+    /**
+     * Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').
+     */
+    currency: string;
+    /**
+     * Price amount in this currency. Set explicitly per currency, not converted from the base amount.
+     */
+    amount: number;
+};
+/**
+ * Base price configuration for a plan.
+ */
 type PreviewAttachBasePrice = {
     /**
      * Base price amount for the plan.
@@ -5421,6 +6346,10 @@ type PreviewAttachBasePrice = {
      * Number of intervals per billing cycle. Defaults to 1.
      */
     intervalCount?: number | undefined;
+    /**
+     * Base price amounts in additional currencies. The base 'amount' is in the org's default currency.
+     */
+    additionalCurrencies?: Array<PreviewAttachAdditionalCurrency> | undefined;
 };
 /**
  * Interval at which balance resets (e.g. 'month', 'year'). For consumable features only.
@@ -5453,10 +6382,38 @@ type PreviewAttachItemReset = {
      */
     intervalCount?: number | undefined;
 };
+type PreviewAttachItemAdditionalCurrency = {
+    /**
+     * Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').
+     */
+    currency: string;
+    /**
+     * Price amount in this currency. Set explicitly per currency, not converted from the base amount.
+     */
+    amount: number;
+};
+type PreviewAttachItemTierAdditionalCurrency = {
+    /**
+     * Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').
+     */
+    currency: string;
+    /**
+     * Per-unit amount for this tier in this currency.
+     */
+    amount?: number | undefined;
+    /**
+     * Flat amount for this tier in this currency, if the tier uses one.
+     */
+    flatAmount?: number | undefined;
+};
 type PreviewAttachItemTier = {
     to: number | string;
     amount?: number | undefined;
     flatAmount?: number | undefined;
+    /**
+     * Per-currency amounts for this tier. Tier boundaries ('to') are shared across all currencies.
+     */
+    additionalCurrencies?: Array<PreviewAttachItemTierAdditionalCurrency> | undefined;
 };
 declare const PreviewAttachItemTierBehavior: {
     readonly Graduated: "graduated";
@@ -5497,6 +6454,10 @@ type PreviewAttachItemPrice = {
      * Price per billing_units after included usage. Either 'amount' or 'tiers' is required.
      */
     amount?: number | undefined;
+    /**
+     * Amounts in additional currencies for this flat price. The base 'amount' is in the org's default currency. Only valid with 'amount', not 'tiers'.
+     */
+    additionalCurrencies?: Array<PreviewAttachItemAdditionalCurrency> | undefined;
     /**
      * Tiered pricing.  Either 'amount' or 'tiers' is required.
      */
@@ -5659,10 +6620,38 @@ type PreviewAttachAddItemReset = {
      */
     intervalCount?: number | undefined;
 };
+type PreviewAttachAddItemAdditionalCurrency = {
+    /**
+     * Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').
+     */
+    currency: string;
+    /**
+     * Price amount in this currency. Set explicitly per currency, not converted from the base amount.
+     */
+    amount: number;
+};
+type PreviewAttachAddItemTierAdditionalCurrency = {
+    /**
+     * Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').
+     */
+    currency: string;
+    /**
+     * Per-unit amount for this tier in this currency.
+     */
+    amount?: number | undefined;
+    /**
+     * Flat amount for this tier in this currency, if the tier uses one.
+     */
+    flatAmount?: number | undefined;
+};
 type PreviewAttachAddItemTier = {
     to: number | string;
     amount?: number | undefined;
     flatAmount?: number | undefined;
+    /**
+     * Per-currency amounts for this tier. Tier boundaries ('to') are shared across all currencies.
+     */
+    additionalCurrencies?: Array<PreviewAttachAddItemTierAdditionalCurrency> | undefined;
 };
 declare const PreviewAttachAddItemTierBehavior: {
     readonly Graduated: "graduated";
@@ -5703,6 +6692,10 @@ type PreviewAttachAddItemPrice = {
      * Price per billing_units after included usage. Either 'amount' or 'tiers' is required.
      */
     amount?: number | undefined;
+    /**
+     * Amounts in additional currencies for this flat price. The base 'amount' is in the org's default currency. Only valid with 'amount', not 'tiers'.
+     */
+    additionalCurrencies?: Array<PreviewAttachAddItemAdditionalCurrency> | undefined;
     /**
      * Tiered pricing.  Either 'amount' or 'tiers' is required.
      */
@@ -6134,153 +7127,504 @@ type PreviewAttachBillingControls = {
     overageAllowed?: Array<PreviewAttachOverageAllowed> | undefined;
 };
 /**
- * Customize the plan to attach. Can override the price, items, free trial, or a combination.
+ * Billing interval (e.g. 'month', 'year').
  */
-type PreviewAttachCustomize = {
+declare const PreviewAttachPriceUpsertLicenseInterval: {
+    readonly OneOff: "one_off";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Quarter: "quarter";
+    readonly SemiAnnual: "semi_annual";
+    readonly Year: "year";
+};
+/**
+ * Billing interval (e.g. 'month', 'year').
+ */
+type PreviewAttachPriceUpsertLicenseInterval = ClosedEnum<typeof PreviewAttachPriceUpsertLicenseInterval>;
+type PreviewAttachUpsertLicenseAdditionalCurrency = {
     /**
-     * Override the base price of the plan. Pass null to remove the base price.
+     * Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').
      */
-    price?: PreviewAttachBasePrice | null | undefined;
+    currency: string;
     /**
-     * Override the items in the plan (PUT-style — replaces all existing items). Mutually exclusive with add_items / remove_items / deprecated update_items.
+     * Price amount in this currency. Set explicitly per currency, not converted from the base amount.
      */
-    items?: Array<PreviewAttachItemPlanItem> | undefined;
+    amount: number;
+};
+/**
+ * Base price configuration for a plan.
+ */
+type PreviewAttachUpsertLicenseBasePrice = {
     /**
-     * Items to add to the plan.
+     * Base price amount for the plan.
      */
-    addItems?: Array<PreviewAttachAddItemPlanItem> | undefined;
+    amount: number;
     /**
-     * Filters selecting items to remove from the plan.
+     * Billing interval (e.g. 'month', 'year').
      */
-    removeItems?: Array<PreviewAttachPlanItemFilter> | undefined;
+    interval: PreviewAttachPriceUpsertLicenseInterval;
     /**
-     * Override the plan's default free trial. Pass an object to set a custom trial, or null to remove the trial entirely.
+     * Number of intervals per billing cycle. Defaults to 1.
      */
-    freeTrial?: PreviewAttachFreeTrialParams | null | undefined;
+    intervalCount?: number | undefined;
     /**
-     * Override the plan's billing controls (auto top-ups, spend limits, usage limits, usage alerts, overage allowed) for this customer.
+     * Base price amounts in additional currencies. The base 'amount' is in the org's default currency.
      */
-    billingControls?: PreviewAttachBillingControls | undefined;
+    additionalCurrencies?: Array<PreviewAttachUpsertLicenseAdditionalCurrency> | undefined;
 };
 /**
- * Invoice mode creates a draft or open invoice and sends it to the customer, instead of charging their card immediately. This uses Stripe's send_invoice collection method.
+ * Interval at which balance resets (e.g. 'month', 'year'). For consumable features only.
  */
-type PreviewAttachInvoiceMode = {
+declare const PreviewAttachUpsertLicenseResetInterval: {
+    readonly OneOff: "one_off";
+    readonly Minute: "minute";
+    readonly Hour: "hour";
+    readonly Day: "day";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Quarter: "quarter";
+    readonly SemiAnnual: "semi_annual";
+    readonly Year: "year";
+};
+/**
+ * Interval at which balance resets (e.g. 'month', 'year'). For consumable features only.
+ */
+type PreviewAttachUpsertLicenseResetInterval = ClosedEnum<typeof PreviewAttachUpsertLicenseResetInterval>;
+/**
+ * Reset configuration for consumable features. Omit for non-consumable features like seats.
+ */
+type PreviewAttachUpsertLicenseReset = {
     /**
-     * When true, creates an invoice and sends it to the customer instead of charging their card immediately. Uses Stripe's send_invoice collection method.
+     * Interval at which balance resets (e.g. 'month', 'year'). For consumable features only.
      */
-    enabled: boolean;
+    interval: PreviewAttachUpsertLicenseResetInterval;
     /**
-     * If true, enables the plan immediately even though the invoice is not paid yet.
+     * Number of intervals between resets. Defaults to 1.
      */
-    enablePlanImmediately?: boolean | undefined;
+    intervalCount?: number | undefined;
+};
+type PreviewAttachUpsertLicenseAddItemAdditionalCurrency = {
     /**
-     * If true, finalizes the invoice so it can be sent to the customer. If false, keeps it as a draft for manual review.
+     * Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').
      */
-    finalize?: boolean | undefined;
+    currency: string;
     /**
-     * ID of an invoice template (configured in billing settings) whose footer (e.g. bank details) is applied to the invoice.
+     * Price amount in this currency. Set explicitly per currency, not converted from the base amount.
      */
-    invoiceTemplateId?: string | undefined;
+    amount: number;
+};
+type PreviewAttachUpsertLicenseTier = {
+    to?: any | undefined;
+    amount?: number | undefined;
+    flatAmount?: number | undefined;
     /**
-     * Number of days the customer has to pay the invoice before it is due (Stripe days_until_due).
+     * Per-currency amounts for this tier. Tier boundaries ('to') are shared across all currencies.
      */
-    netTermsDays?: number | undefined;
+    additionalCurrencies?: Array<any> | undefined;
+};
+declare const PreviewAttachUpsertLicenseTierBehavior: {
+    readonly Graduated: "graduated";
+    readonly Volume: "volume";
 };
+type PreviewAttachUpsertLicenseTierBehavior = ClosedEnum<typeof PreviewAttachUpsertLicenseTierBehavior>;
 /**
- * How to handle proration when updating an existing subscription. 'prorate_immediately' charges/credits prorated amounts now, 'none' skips creating any charges.
+ * Billing interval. For consumable features, should match reset.interval.
  */
-declare const PreviewAttachProrationBehavior: {
-    readonly ProrateImmediately: "prorate_immediately";
-    readonly None: "none";
+declare const PreviewAttachUpsertLicenseAddItemPriceInterval: {
+    readonly OneOff: "one_off";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Quarter: "quarter";
+    readonly SemiAnnual: "semi_annual";
+    readonly Year: "year";
 };
 /**
- * How to handle proration when updating an existing subscription. 'prorate_immediately' charges/credits prorated amounts now, 'none' skips creating any charges.
+ * Billing interval. For consumable features, should match reset.interval.
  */
-type PreviewAttachProrationBehavior = ClosedEnum<typeof PreviewAttachProrationBehavior>;
+type PreviewAttachUpsertLicenseAddItemPriceInterval = ClosedEnum<typeof PreviewAttachUpsertLicenseAddItemPriceInterval>;
 /**
- * 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.
+ * 'prepaid' for upfront payment (seats), 'usage_based' for pay-as-you-go.
  */
-declare const PreviewAttachRedirectMode: {
-    readonly Always: "always";
-    readonly IfRequired: "if_required";
-    readonly Never: "never";
+declare const PreviewAttachUpsertLicenseAddItemBillingMethod: {
+    readonly Prepaid: "prepaid";
+    readonly UsageBased: "usage_based";
 };
 /**
- * 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.
+ * 'prepaid' for upfront payment (seats), 'usage_based' for pay-as-you-go.
  */
-type PreviewAttachRedirectMode = ClosedEnum<typeof PreviewAttachRedirectMode>;
+type PreviewAttachUpsertLicenseAddItemBillingMethod = ClosedEnum<typeof PreviewAttachUpsertLicenseAddItemBillingMethod>;
 /**
- * A discount to apply. Can be either a reward ID or a promotion code.
+ * Pricing for usage beyond included units. Omit for free features.
  */
-type PreviewAttachAttachDiscount = {
+type PreviewAttachUpsertLicensePrice = {
     /**
-     * The ID of the reward to apply as a discount.
+     * Price per billing_units after included usage. Either 'amount' or 'tiers' is required.
      */
-    rewardId?: string | undefined;
+    amount?: number | undefined;
     /**
-     * The promotion code to apply as a discount.
+     * Amounts in additional currencies for this flat price. The base 'amount' is in the org's default currency. Only valid with 'amount', not 'tiers'.
      */
-    promotionCode?: string | undefined;
+    additionalCurrencies?: Array<PreviewAttachUpsertLicenseAddItemAdditionalCurrency> | undefined;
+    /**
+     * Tiered pricing.  Either 'amount' or 'tiers' is required.
+     */
+    tiers?: Array<PreviewAttachUpsertLicenseTier> | undefined;
+    tierBehavior?: PreviewAttachUpsertLicenseTierBehavior | undefined;
+    /**
+     * Billing interval. For consumable features, should match reset.interval.
+     */
+    interval: PreviewAttachUpsertLicenseAddItemPriceInterval;
+    /**
+     * Number of intervals per billing cycle. Defaults to 1.
+     */
+    intervalCount?: number | undefined;
+    /**
+     * Units per price increment. Usage is rounded UP when billed (e.g. billing_units=100 means 101 rounds to 200).
+     */
+    billingUnits?: number | undefined;
+    /**
+     * 'prepaid' for upfront payment (seats), 'usage_based' for pay-as-you-go.
+     */
+    billingMethod: PreviewAttachUpsertLicenseAddItemBillingMethod;
+    /**
+     * Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.
+     */
+    maxPurchase?: number | null | undefined;
 };
 /**
- * When the plan change should take effect. 'immediate' applies now, 'end_of_cycle' schedules for the end of the current billing cycle. By default, upgrades are immediate and downgrades are scheduled.
+ * Billing behavior when quantity increases mid-cycle.
  */
-declare const PreviewAttachPlanSchedule: {
-    readonly Immediate: "immediate";
-    readonly EndOfCycle: "end_of_cycle";
+declare const PreviewAttachUpsertLicenseOnIncrease: {
+    readonly BillImmediately: "bill_immediately";
+    readonly ProrateImmediately: "prorate_immediately";
+    readonly ProrateNextCycle: "prorate_next_cycle";
+    readonly BillNextCycle: "bill_next_cycle";
 };
 /**
- * When the plan change should take effect. 'immediate' applies now, 'end_of_cycle' schedules for the end of the current billing cycle. By default, upgrades are immediate and downgrades are scheduled.
+ * Billing behavior when quantity increases mid-cycle.
  */
-type PreviewAttachPlanSchedule = ClosedEnum<typeof PreviewAttachPlanSchedule>;
-type PreviewAttachCustomLineItem = {
-    /**
-     * Amount in dollars for this line item (e.g. 10.50). Can be negative for credits.
-     */
-    amount: number;
-    /**
-     * Description for the line item.
-     */
-    description: string;
+type PreviewAttachUpsertLicenseOnIncrease = ClosedEnum<typeof PreviewAttachUpsertLicenseOnIncrease>;
+/**
+ * Credit behavior when quantity decreases mid-cycle.
+ */
+declare const PreviewAttachUpsertLicenseOnDecrease: {
+    readonly Prorate: "prorate";
+    readonly ProrateImmediately: "prorate_immediately";
+    readonly ProrateNextCycle: "prorate_next_cycle";
+    readonly None: "none";
+    readonly NoProrations: "no_prorations";
 };
 /**
- * Whether to carry over balances from the previous plan.
+ * Credit behavior when quantity decreases mid-cycle.
  */
-type PreviewAttachCarryOverBalances = {
+type PreviewAttachUpsertLicenseOnDecrease = ClosedEnum<typeof PreviewAttachUpsertLicenseOnDecrease>;
+/**
+ * Proration settings for prepaid features. Controls mid-cycle quantity change billing.
+ */
+type PreviewAttachUpsertLicenseProration = {
     /**
-     * Whether to carry over balances from the previous plan.
+     * Billing behavior when quantity increases mid-cycle.
      */
-    enabled: boolean;
+    onIncrease: PreviewAttachUpsertLicenseOnIncrease;
     /**
-     * The IDs of the features to carry over balances from. If left undefined, all features will be carried over.
+     * Credit behavior when quantity decreases mid-cycle.
      */
-    featureIds?: Array<string> | undefined;
+    onDecrease: PreviewAttachUpsertLicenseOnDecrease;
 };
 /**
- * Whether to carry over usages from the previous plan.
+ * When rolled over units expire.
  */
-type PreviewAttachCarryOverUsages = {
+declare const PreviewAttachUpsertLicenseExpiryDurationType: {
+    readonly Month: "month";
+    readonly Forever: "forever";
+};
+/**
+ * When rolled over units expire.
+ */
+type PreviewAttachUpsertLicenseExpiryDurationType = ClosedEnum<typeof PreviewAttachUpsertLicenseExpiryDurationType>;
+/**
+ * Rollover config for unused units. If set, unused included units carry over.
+ */
+type PreviewAttachUpsertLicenseRollover = {
     /**
-     * Whether to carry over usages from the previous plan.
+     * Max rollover units. Omit for unlimited rollover.
      */
-    enabled: boolean;
+    max?: number | undefined;
     /**
-     * The IDs of the features to carry over usages for. If left undefined, all consumable features will be carried over.
+     * Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.
      */
-    featureIds?: Array<string> | undefined;
-};
-type PreviewAttachParams = {
+    maxPercentage?: number | undefined;
     /**
-     * The ID of the customer to attach the plan to.
+     * When rolled over units expire.
      */
-    customerId: string;
+    expiryDurationType: PreviewAttachUpsertLicenseExpiryDurationType;
     /**
-     * The ID of the entity to attach the plan to.
+     * Number of periods before expiry.
      */
-    entityId?: string | undefined;
-    /**
-     * The ID of the plan.
+    expiryDurationLength?: number | undefined;
+};
+/**
+ * Configuration for a feature item in a plan, including usage limits, pricing, and rollover settings.
+ */
+type PreviewAttachUpsertLicensePlanItem = {
+    /**
+     * The ID of the feature to configure.
+     */
+    featureId: string;
+    /**
+     * Number of free units included. Balance resets to this each interval for consumable features.
+     */
+    included?: number | undefined;
+    /**
+     * If true, customer has unlimited access to this feature.
+     */
+    unlimited?: boolean | undefined;
+    /**
+     * Reset configuration for consumable features. Omit for non-consumable features like seats.
+     */
+    reset?: PreviewAttachUpsertLicenseReset | undefined;
+    /**
+     * Pricing for usage beyond included units. Omit for free features.
+     */
+    price?: PreviewAttachUpsertLicensePrice | undefined;
+    /**
+     * Proration settings for prepaid features. Controls mid-cycle quantity change billing.
+     */
+    proration?: PreviewAttachUpsertLicenseProration | undefined;
+    /**
+     * Rollover config for unused units. If set, unused included units carry over.
+     */
+    rollover?: PreviewAttachUpsertLicenseRollover | undefined;
+};
+/**
+ * Match items with this billing method (prepaid or usage_based).
+ */
+declare const PreviewAttachUpsertLicenseRemoveItemBillingMethod: {
+    readonly Prepaid: "prepaid";
+    readonly UsageBased: "usage_based";
+};
+/**
+ * Match items with this billing method (prepaid or usage_based).
+ */
+type PreviewAttachUpsertLicenseRemoveItemBillingMethod = ClosedEnum<typeof PreviewAttachUpsertLicenseRemoveItemBillingMethod>;
+declare const PreviewAttachIntervalUpsertLicenseRemoveItemEnum2: {
+    readonly OneOff: "one_off";
+    readonly Minute: "minute";
+    readonly Hour: "hour";
+    readonly Day: "day";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Quarter: "quarter";
+    readonly SemiAnnual: "semi_annual";
+    readonly Year: "year";
+};
+type PreviewAttachIntervalUpsertLicenseRemoveItemEnum2 = ClosedEnum<typeof PreviewAttachIntervalUpsertLicenseRemoveItemEnum2>;
+declare const PreviewAttachIntervalUpsertLicenseRemoveItemEnum1: {
+    readonly OneOff: "one_off";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Quarter: "quarter";
+    readonly SemiAnnual: "semi_annual";
+    readonly Year: "year";
+};
+type PreviewAttachIntervalUpsertLicenseRemoveItemEnum1 = ClosedEnum<typeof PreviewAttachIntervalUpsertLicenseRemoveItemEnum1>;
+/**
+ * Filter for matching plan items. All provided fields must match (AND).
+ */
+type PreviewAttachUpsertLicensePlanItemFilter = {
+    /**
+     * Match items linked to this feature.
+     */
+    featureId?: string | undefined;
+    /**
+     * Match items with this billing method (prepaid or usage_based).
+     */
+    billingMethod?: PreviewAttachUpsertLicenseRemoveItemBillingMethod | undefined;
+    /**
+     * Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.
+     */
+    interval?: PreviewAttachIntervalUpsertLicenseRemoveItemEnum1 | PreviewAttachIntervalUpsertLicenseRemoveItemEnum2 | undefined;
+    /**
+     * Match items with this interval_count. Disambiguates between items that share an interval but differ in count.
+     */
+    intervalCount?: number | undefined;
+};
+type PreviewAttachUpsertLicenseCustomize = {
+    price?: PreviewAttachUpsertLicenseBasePrice | null | undefined;
+    addItems?: Array<PreviewAttachUpsertLicensePlanItem> | undefined;
+    removeItems?: Array<PreviewAttachUpsertLicensePlanItemFilter> | undefined;
+};
+type PreviewAttachUpsertLicense = {
+    licensePlanId: string;
+    included?: number | undefined;
+    prepaidOnly?: boolean | undefined;
+    customize?: PreviewAttachUpsertLicenseCustomize | null | undefined;
+    metadata?: {
+        [k: string]: any;
+    } | undefined;
+};
+/**
+ * Customize the plan to attach. Can override the price, items, licenses, free trial, or a combination.
+ */
+type PreviewAttachCustomize = {
+    /**
+     * Override the base price of the plan. Pass null to remove the base price.
+     */
+    price?: PreviewAttachBasePrice | null | undefined;
+    /**
+     * Override the items in the plan (PUT-style — replaces all existing items). Mutually exclusive with add_items / remove_items / deprecated update_items.
+     */
+    items?: Array<PreviewAttachItemPlanItem> | undefined;
+    /**
+     * Items to add to the plan.
+     */
+    addItems?: Array<PreviewAttachAddItemPlanItem> | undefined;
+    /**
+     * Filters selecting items to remove from the plan.
+     */
+    removeItems?: Array<PreviewAttachPlanItemFilter> | undefined;
+    /**
+     * Override the plan's default free trial. Pass an object to set a custom trial, or null to remove the trial entirely.
+     */
+    freeTrial?: PreviewAttachFreeTrialParams | null | undefined;
+    /**
+     * Override the plan's billing controls (auto top-ups, spend limits, usage limits, usage alerts, overage allowed) for this customer.
+     */
+    billingControls?: PreviewAttachBillingControls | undefined;
+    /**
+     * License links to add or override for this customer, keyed by license_plan_id. Omitted fields inherit the plan catalog link (included defaults to 1 when the license is not in the catalog). A bare entry restores the license to pure catalog inheritance.
+     */
+    upsertLicenses?: Array<PreviewAttachUpsertLicense> | undefined;
+};
+/**
+ * Invoice mode creates a draft or open invoice and sends it to the customer, instead of charging their card immediately. This uses Stripe's send_invoice collection method.
+ */
+type PreviewAttachInvoiceMode = {
+    /**
+     * When true, creates an invoice and sends it to the customer instead of charging their card immediately. Uses Stripe's send_invoice collection method.
+     */
+    enabled: boolean;
+    /**
+     * If true, enables the plan immediately even though the invoice is not paid yet.
+     */
+    enablePlanImmediately?: boolean | undefined;
+    /**
+     * If true, finalizes the invoice so it can be sent to the customer. If false, keeps it as a draft for manual review.
+     */
+    finalize?: boolean | undefined;
+    /**
+     * ID of an invoice template (configured in billing settings) whose footer (e.g. bank details) is applied to the invoice.
+     */
+    invoiceTemplateId?: string | undefined;
+    /**
+     * Number of days the customer has to pay the invoice before it is due (Stripe days_until_due).
+     */
+    netTermsDays?: number | undefined;
+};
+/**
+ * How to handle proration when updating an existing subscription. 'prorate_immediately' charges/credits prorated amounts now, 'none' skips creating any charges.
+ */
+declare const PreviewAttachProrationBehavior: {
+    readonly ProrateImmediately: "prorate_immediately";
+    readonly None: "none";
+};
+/**
+ * How to handle proration when updating an existing subscription. 'prorate_immediately' charges/credits prorated amounts now, 'none' skips creating any charges.
+ */
+type PreviewAttachProrationBehavior = ClosedEnum<typeof PreviewAttachProrationBehavior>;
+/**
+ * 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.
+ */
+declare const PreviewAttachRedirectMode: {
+    readonly Always: "always";
+    readonly IfRequired: "if_required";
+    readonly Never: "never";
+};
+/**
+ * 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.
+ */
+type PreviewAttachRedirectMode = ClosedEnum<typeof PreviewAttachRedirectMode>;
+/**
+ * A discount to apply. Can be either a reward ID or a promotion code.
+ */
+type PreviewAttachAttachDiscount = {
+    /**
+     * The ID of the reward to apply as a discount.
+     */
+    rewardId?: string | undefined;
+    /**
+     * The promotion code to apply as a discount.
+     */
+    promotionCode?: string | undefined;
+};
+/**
+ * When the plan change should take effect. 'immediate' applies now, 'end_of_cycle' schedules for the end of the current billing cycle. By default, upgrades are immediate and downgrades are scheduled.
+ */
+declare const PreviewAttachPlanSchedule: {
+    readonly Immediate: "immediate";
+    readonly EndOfCycle: "end_of_cycle";
+};
+/**
+ * When the plan change should take effect. 'immediate' applies now, 'end_of_cycle' schedules for the end of the current billing cycle. By default, upgrades are immediate and downgrades are scheduled.
+ */
+type PreviewAttachPlanSchedule = ClosedEnum<typeof PreviewAttachPlanSchedule>;
+type PreviewAttachCustomLineItem = {
+    /**
+     * Amount in dollars for this line item (e.g. 10.50). Can be negative for credits.
+     */
+    amount: number;
+    /**
+     * Description for the line item.
+     */
+    description: string;
+};
+/**
+ * Whether to carry over balances from the previous plan.
+ */
+type PreviewAttachCarryOverBalances = {
+    /**
+     * Whether to carry over balances from the previous plan.
+     */
+    enabled: boolean;
+    /**
+     * The IDs of the features to carry over balances from. If left undefined, all features will be carried over.
+     */
+    featureIds?: Array<string> | undefined;
+};
+/**
+ * Whether to carry over usages from the previous plan.
+ */
+type PreviewAttachCarryOverUsages = {
+    /**
+     * Whether to carry over usages from the previous plan.
+     */
+    enabled: boolean;
+    /**
+     * The IDs of the features to carry over usages for. If left undefined, all consumable features will be carried over.
+     */
+    featureIds?: Array<string> | undefined;
+};
+type PreviewAttachLicenseQuantity = {
+    /**
+     * The license plan to set seat quantity for.
+     */
+    licensePlanId: string;
+    /**
+     * Total seats for the license, inclusive of the plan's included amount — seats beyond it are paid.
+     */
+    quantity: number;
+};
+type PreviewAttachParams = {
+    /**
+     * The ID of the customer to attach the plan to.
+     */
+    customerId: string;
+    /**
+     * The ID of the entity to attach the plan to.
+     */
+    entityId?: string | undefined;
+    /**
+     * The ID of the plan.
      */
     planId: string;
     /**
@@ -6292,7 +7636,7 @@ type PreviewAttachParams = {
      */
     version?: number | undefined;
     /**
-     * Customize the plan to attach. Can override the price, items, free trial, or a combination.
+     * Customize the plan to attach. Can override the price, items, licenses, free trial, or a combination.
      */
     customize?: PreviewAttachCustomize | undefined;
     /**
@@ -6365,6 +7709,10 @@ type PreviewAttachParams = {
      * Whether to carry over usages from the previous plan.
      */
     carryOverUsages?: PreviewAttachCarryOverUsages | undefined;
+    /**
+     * Seat quantities for the plan's licenses, keyed by license plan.
+     */
+    licenseQuantities?: Array<PreviewAttachLicenseQuantity> | undefined;
     /**
      * Key-value metadata to attach to the Stripe subscription, invoice, and checkout session created during this attach flow. Keys prefixed with 'autumn_' are reserved and will be stripped.
      */
@@ -6383,6 +7731,10 @@ type PreviewAttachParams = {
      * Stripe tax rate ID (txr_...) to apply as the default tax rate on the created subscription, invoice, or checkout session line items.
      */
     taxRateId?: string | undefined;
+    /**
+     * Currency to bill this attach in (e.g. usd, eur). Must match the customer's currency if they are already locked to one, and the plan must offer a paid price in it. Defaults to the customer's currency, then the org default.
+     */
+    currency?: string | undefined;
 };
 type PreviewAttachDiscount = {
     amountOff: number;
@@ -6744,6 +8096,16 @@ declare const PreviewMultiAttachPriceInterval: {
  * Billing interval (e.g. 'month', 'year').
  */
 type PreviewMultiAttachPriceInterval = ClosedEnum<typeof PreviewMultiAttachPriceInterval>;
+type PreviewMultiAttachAdditionalCurrency = {
+    /**
+     * Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').
+     */
+    currency: string;
+    /**
+     * Price amount in this currency. Set explicitly per currency, not converted from the base amount.
+     */
+    amount: number;
+};
 /**
  * Base price configuration for a plan.
  */
@@ -6760,6 +8122,10 @@ type PreviewMultiAttachBasePrice = {
      * Number of intervals per billing cycle. Defaults to 1.
      */
     intervalCount?: number | undefined;
+    /**
+     * Base price amounts in additional currencies. The base 'amount' is in the org's default currency.
+     */
+    additionalCurrencies?: Array<PreviewMultiAttachAdditionalCurrency> | undefined;
 };
 /**
  * Interval at which balance resets (e.g. 'month', 'year'). For consumable features only.
@@ -6792,10 +8158,29 @@ type PreviewMultiAttachReset = {
      */
     intervalCount?: number | undefined;
 };
+type PreviewMultiAttachItemAdditionalCurrency = {
+    /**
+     * Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').
+     */
+    currency: string;
+    /**
+     * Price amount in this currency. Set explicitly per currency, not converted from the base amount.
+     */
+    amount: number;
+};
+type PreviewMultiAttachTierAdditionalCurrency = {
+    currency?: any | undefined;
+    amount?: any | undefined;
+    flatAmount?: any | undefined;
+};
 type PreviewMultiAttachTier = {
     to: number | string;
     amount?: number | undefined;
     flatAmount?: number | undefined;
+    /**
+     * Per-currency amounts for this tier. Tier boundaries ('to') are shared across all currencies.
+     */
+    additionalCurrencies?: Array<PreviewMultiAttachTierAdditionalCurrency> | undefined;
 };
 declare const PreviewMultiAttachTierBehavior: {
     readonly Graduated: "graduated";
@@ -6836,6 +8221,10 @@ type PreviewMultiAttachPrice = {
      * Price per billing_units after included usage. Either 'amount' or 'tiers' is required.
      */
     amount?: number | undefined;
+    /**
+     * Amounts in additional currencies for this flat price. The base 'amount' is in the org's default currency. Only valid with 'amount', not 'tiers'.
+     */
+    additionalCurrencies?: Array<PreviewMultiAttachItemAdditionalCurrency> | undefined;
     /**
      * Tiered pricing.  Either 'amount' or 'tiers' is required.
      */
@@ -6968,7 +8357,7 @@ type PreviewMultiAttachPlanItem = {
     rollover?: PreviewMultiAttachRollover | undefined;
 };
 /**
- * Customize the plan to attach. Can override the price or items.
+ * Customize the plan to attach. Can override the price, items, or licenses.
  */
 type PreviewMultiAttachCustomize = {
     /**
@@ -7003,7 +8392,7 @@ type PreviewMultiAttachPlan = {
      */
     planId: string;
     /**
-     * Customize the plan to attach. Can override the price or items.
+     * Customize the plan to attach. Can override the price, items, or licenses.
      */
     customize?: PreviewMultiAttachCustomize | undefined;
     /**
@@ -7286,6 +8675,10 @@ type PreviewMultiAttachParams = {
      * Free trial configuration applied to all plans. Pass an object to set a custom trial, or null to remove any trial.
      */
     freeTrial?: PreviewMultiAttachFreeTrialParams | null | undefined;
+    /**
+     * Currency to bill this multi-attach in (e.g. usd, eur). Must match the customer's currency if they are already locked to one, and every plan must offer a paid price in it. Defaults to the customer's currency, then the org default.
+     */
+    currency?: string | undefined;
     /**
      * Invoice mode creates a draft or open invoice and sends it to the customer, instead of charging their card immediately.
      */
@@ -7699,6 +9092,16 @@ declare const PreviewUpdatePriceInterval: {
  * Billing interval (e.g. 'month', 'year').
  */
 type PreviewUpdatePriceInterval = ClosedEnum<typeof PreviewUpdatePriceInterval>;
+type PreviewUpdateAdditionalCurrency = {
+    /**
+     * Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').
+     */
+    currency: string;
+    /**
+     * Price amount in this currency. Set explicitly per currency, not converted from the base amount.
+     */
+    amount: number;
+};
 /**
  * Base price configuration for a plan.
  */
@@ -7715,6 +9118,10 @@ type PreviewUpdateBasePrice = {
      * Number of intervals per billing cycle. Defaults to 1.
      */
     intervalCount?: number | undefined;
+    /**
+     * Base price amounts in additional currencies. The base 'amount' is in the org's default currency.
+     */
+    additionalCurrencies?: Array<PreviewUpdateAdditionalCurrency> | undefined;
 };
 /**
  * Interval at which balance resets (e.g. 'month', 'year'). For consumable features only.
@@ -7747,10 +9154,38 @@ type PreviewUpdateItemReset = {
      */
     intervalCount?: number | undefined;
 };
+type PreviewUpdateItemAdditionalCurrency = {
+    /**
+     * Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').
+     */
+    currency: string;
+    /**
+     * Price amount in this currency. Set explicitly per currency, not converted from the base amount.
+     */
+    amount: number;
+};
+type PreviewUpdateItemTierAdditionalCurrency = {
+    /**
+     * Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').
+     */
+    currency: string;
+    /**
+     * Per-unit amount for this tier in this currency.
+     */
+    amount?: number | undefined;
+    /**
+     * Flat amount for this tier in this currency, if the tier uses one.
+     */
+    flatAmount?: number | undefined;
+};
 type PreviewUpdateItemTier = {
     to: number | string;
     amount?: number | undefined;
     flatAmount?: number | undefined;
+    /**
+     * Per-currency amounts for this tier. Tier boundaries ('to') are shared across all currencies.
+     */
+    additionalCurrencies?: Array<PreviewUpdateItemTierAdditionalCurrency> | undefined;
 };
 declare const PreviewUpdateItemTierBehavior: {
     readonly Graduated: "graduated";
@@ -7791,6 +9226,10 @@ type PreviewUpdateItemPrice = {
      * Price per billing_units after included usage. Either 'amount' or 'tiers' is required.
      */
     amount?: number | undefined;
+    /**
+     * Amounts in additional currencies for this flat price. The base 'amount' is in the org's default currency. Only valid with 'amount', not 'tiers'.
+     */
+    additionalCurrencies?: Array<PreviewUpdateItemAdditionalCurrency> | undefined;
     /**
      * Tiered pricing.  Either 'amount' or 'tiers' is required.
      */
@@ -7953,10 +9392,38 @@ type PreviewUpdateAddItemReset = {
      */
     intervalCount?: number | undefined;
 };
+type PreviewUpdateAddItemAdditionalCurrency = {
+    /**
+     * Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').
+     */
+    currency: string;
+    /**
+     * Price amount in this currency. Set explicitly per currency, not converted from the base amount.
+     */
+    amount: number;
+};
+type PreviewUpdateAddItemTierAdditionalCurrency = {
+    /**
+     * Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').
+     */
+    currency: string;
+    /**
+     * Per-unit amount for this tier in this currency.
+     */
+    amount?: number | undefined;
+    /**
+     * Flat amount for this tier in this currency, if the tier uses one.
+     */
+    flatAmount?: number | undefined;
+};
 type PreviewUpdateAddItemTier = {
     to: number | string;
     amount?: number | undefined;
     flatAmount?: number | undefined;
+    /**
+     * Per-currency amounts for this tier. Tier boundaries ('to') are shared across all currencies.
+     */
+    additionalCurrencies?: Array<PreviewUpdateAddItemTierAdditionalCurrency> | undefined;
 };
 declare const PreviewUpdateAddItemTierBehavior: {
     readonly Graduated: "graduated";
@@ -7997,6 +9464,10 @@ type PreviewUpdateAddItemPrice = {
      * Price per billing_units after included usage. Either 'amount' or 'tiers' is required.
      */
     amount?: number | undefined;
+    /**
+     * Amounts in additional currencies for this flat price. The base 'amount' is in the org's default currency. Only valid with 'amount', not 'tiers'.
+     */
+    additionalCurrencies?: Array<PreviewUpdateAddItemAdditionalCurrency> | undefined;
     /**
      * Tiered pricing.  Either 'amount' or 'tiers' is required.
      */
@@ -8428,155 +9899,506 @@ type PreviewUpdateBillingControls = {
     overageAllowed?: Array<PreviewUpdateOverageAllowed> | undefined;
 };
 /**
- * Customize the plan to attach. Can override the price, items, free trial, or a combination.
+ * Billing interval (e.g. 'month', 'year').
  */
-type PreviewUpdateCustomize = {
+declare const PreviewUpdatePriceUpsertLicenseInterval: {
+    readonly OneOff: "one_off";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Quarter: "quarter";
+    readonly SemiAnnual: "semi_annual";
+    readonly Year: "year";
+};
+/**
+ * Billing interval (e.g. 'month', 'year').
+ */
+type PreviewUpdatePriceUpsertLicenseInterval = ClosedEnum<typeof PreviewUpdatePriceUpsertLicenseInterval>;
+type PreviewUpdateUpsertLicenseAdditionalCurrency = {
     /**
-     * Override the base price of the plan. Pass null to remove the base price.
+     * Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').
      */
-    price?: PreviewUpdateBasePrice | null | undefined;
+    currency: string;
     /**
-     * Override the items in the plan (PUT-style — replaces all existing items). Mutually exclusive with add_items / remove_items / deprecated update_items.
+     * Price amount in this currency. Set explicitly per currency, not converted from the base amount.
      */
-    items?: Array<PreviewUpdateItemPlanItem> | undefined;
+    amount: number;
+};
+/**
+ * Base price configuration for a plan.
+ */
+type PreviewUpdateUpsertLicenseBasePrice = {
     /**
-     * Items to add to the plan.
+     * Base price amount for the plan.
      */
-    addItems?: Array<PreviewUpdateAddItemPlanItem> | undefined;
+    amount: number;
     /**
-     * Filters selecting items to remove from the plan.
+     * Billing interval (e.g. 'month', 'year').
      */
-    removeItems?: Array<PreviewUpdatePlanItemFilter> | undefined;
+    interval: PreviewUpdatePriceUpsertLicenseInterval;
     /**
-     * Override the plan's default free trial. Pass an object to set a custom trial, or null to remove the trial entirely.
+     * Number of intervals per billing cycle. Defaults to 1.
      */
-    freeTrial?: PreviewUpdateFreeTrialParams | null | undefined;
+    intervalCount?: number | undefined;
     /**
-     * Override the plan's billing controls (auto top-ups, spend limits, usage limits, usage alerts, overage allowed) for this customer.
+     * Base price amounts in additional currencies. The base 'amount' is in the org's default currency.
      */
-    billingControls?: PreviewUpdateBillingControls | undefined;
+    additionalCurrencies?: Array<PreviewUpdateUpsertLicenseAdditionalCurrency> | undefined;
 };
 /**
- * Invoice mode creates a draft or open invoice and sends it to the customer, instead of charging their card immediately. This uses Stripe's send_invoice collection method.
+ * Interval at which balance resets (e.g. 'month', 'year'). For consumable features only.
  */
-type PreviewUpdateInvoiceMode = {
+declare const PreviewUpdateUpsertLicenseResetInterval: {
+    readonly OneOff: "one_off";
+    readonly Minute: "minute";
+    readonly Hour: "hour";
+    readonly Day: "day";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Quarter: "quarter";
+    readonly SemiAnnual: "semi_annual";
+    readonly Year: "year";
+};
+/**
+ * Interval at which balance resets (e.g. 'month', 'year'). For consumable features only.
+ */
+type PreviewUpdateUpsertLicenseResetInterval = ClosedEnum<typeof PreviewUpdateUpsertLicenseResetInterval>;
+/**
+ * Reset configuration for consumable features. Omit for non-consumable features like seats.
+ */
+type PreviewUpdateUpsertLicenseReset = {
     /**
-     * When true, creates an invoice and sends it to the customer instead of charging their card immediately. Uses Stripe's send_invoice collection method.
+     * Interval at which balance resets (e.g. 'month', 'year'). For consumable features only.
      */
-    enabled: boolean;
+    interval: PreviewUpdateUpsertLicenseResetInterval;
     /**
-     * If true, enables the plan immediately even though the invoice is not paid yet.
+     * Number of intervals between resets. Defaults to 1.
      */
-    enablePlanImmediately?: boolean | undefined;
+    intervalCount?: number | undefined;
+};
+type PreviewUpdateUpsertLicenseAddItemAdditionalCurrency = {
     /**
-     * If true, finalizes the invoice so it can be sent to the customer. If false, keeps it as a draft for manual review.
+     * Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').
      */
-    finalize?: boolean | undefined;
+    currency: string;
     /**
-     * ID of an invoice template (configured in billing settings) whose footer (e.g. bank details) is applied to the invoice.
+     * Price amount in this currency. Set explicitly per currency, not converted from the base amount.
      */
-    invoiceTemplateId?: string | undefined;
+    amount: number;
+};
+type PreviewUpdateUpsertLicenseTier = {
+    to?: any | undefined;
+    amount?: number | undefined;
+    flatAmount?: number | undefined;
     /**
-     * Number of days the customer has to pay the invoice before it is due (Stripe days_until_due).
+     * Per-currency amounts for this tier. Tier boundaries ('to') are shared across all currencies.
      */
-    netTermsDays?: number | undefined;
+    additionalCurrencies?: Array<any> | undefined;
+};
+declare const PreviewUpdateUpsertLicenseTierBehavior: {
+    readonly Graduated: "graduated";
+    readonly Volume: "volume";
 };
+type PreviewUpdateUpsertLicenseTierBehavior = ClosedEnum<typeof PreviewUpdateUpsertLicenseTierBehavior>;
 /**
- * How to handle proration when updating an existing subscription. 'prorate_immediately' charges/credits prorated amounts now, 'none' skips creating any charges.
+ * Billing interval. For consumable features, should match reset.interval.
  */
-declare const PreviewUpdateProrationBehavior: {
-    readonly ProrateImmediately: "prorate_immediately";
-    readonly None: "none";
+declare const PreviewUpdateUpsertLicenseAddItemPriceInterval: {
+    readonly OneOff: "one_off";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Quarter: "quarter";
+    readonly SemiAnnual: "semi_annual";
+    readonly Year: "year";
 };
 /**
- * How to handle proration when updating an existing subscription. 'prorate_immediately' charges/credits prorated amounts now, 'none' skips creating any charges.
+ * Billing interval. For consumable features, should match reset.interval.
  */
-type PreviewUpdateProrationBehavior = ClosedEnum<typeof PreviewUpdateProrationBehavior>;
+type PreviewUpdateUpsertLicenseAddItemPriceInterval = ClosedEnum<typeof PreviewUpdateUpsertLicenseAddItemPriceInterval>;
 /**
- * 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.
+ * 'prepaid' for upfront payment (seats), 'usage_based' for pay-as-you-go.
  */
-declare const PreviewUpdateRedirectMode: {
-    readonly Always: "always";
-    readonly IfRequired: "if_required";
-    readonly Never: "never";
+declare const PreviewUpdateUpsertLicenseAddItemBillingMethod: {
+    readonly Prepaid: "prepaid";
+    readonly UsageBased: "usage_based";
 };
 /**
- * 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.
+ * 'prepaid' for upfront payment (seats), 'usage_based' for pay-as-you-go.
  */
-type PreviewUpdateRedirectMode = ClosedEnum<typeof PreviewUpdateRedirectMode>;
+type PreviewUpdateUpsertLicenseAddItemBillingMethod = ClosedEnum<typeof PreviewUpdateUpsertLicenseAddItemBillingMethod>;
 /**
- * A discount to apply. Can be either a reward ID or a promotion code.
+ * Pricing for usage beyond included units. Omit for free features.
  */
-type PreviewUpdateAttachDiscount = {
+type PreviewUpdateUpsertLicensePrice = {
     /**
-     * The ID of the reward to apply as a discount.
+     * Price per billing_units after included usage. Either 'amount' or 'tiers' is required.
      */
-    rewardId?: string | undefined;
+    amount?: number | undefined;
     /**
-     * The promotion code to apply as a discount.
+     * Amounts in additional currencies for this flat price. The base 'amount' is in the org's default currency. Only valid with 'amount', not 'tiers'.
      */
-    promotionCode?: string | undefined;
+    additionalCurrencies?: Array<PreviewUpdateUpsertLicenseAddItemAdditionalCurrency> | undefined;
+    /**
+     * Tiered pricing.  Either 'amount' or 'tiers' is required.
+     */
+    tiers?: Array<PreviewUpdateUpsertLicenseTier> | undefined;
+    tierBehavior?: PreviewUpdateUpsertLicenseTierBehavior | undefined;
+    /**
+     * Billing interval. For consumable features, should match reset.interval.
+     */
+    interval: PreviewUpdateUpsertLicenseAddItemPriceInterval;
+    /**
+     * Number of intervals per billing cycle. Defaults to 1.
+     */
+    intervalCount?: number | undefined;
+    /**
+     * Units per price increment. Usage is rounded UP when billed (e.g. billing_units=100 means 101 rounds to 200).
+     */
+    billingUnits?: number | undefined;
+    /**
+     * 'prepaid' for upfront payment (seats), 'usage_based' for pay-as-you-go.
+     */
+    billingMethod: PreviewUpdateUpsertLicenseAddItemBillingMethod;
+    /**
+     * Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.
+     */
+    maxPurchase?: number | null | 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.
+ * Billing behavior when quantity increases mid-cycle.
  */
-declare const PreviewUpdateCancelAction: {
-    readonly CancelImmediately: "cancel_immediately";
-    readonly CancelEndOfCycle: "cancel_end_of_cycle";
-    readonly Uncancel: "uncancel";
+declare const PreviewUpdateUpsertLicenseOnIncrease: {
+    readonly BillImmediately: "bill_immediately";
+    readonly ProrateImmediately: "prorate_immediately";
+    readonly ProrateNextCycle: "prorate_next_cycle";
+    readonly BillNextCycle: "bill_next_cycle";
 };
 /**
- * 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.
+ * Billing behavior when quantity increases mid-cycle.
  */
-type PreviewUpdateCancelAction = ClosedEnum<typeof PreviewUpdateCancelAction>;
+type PreviewUpdateUpsertLicenseOnIncrease = ClosedEnum<typeof PreviewUpdateUpsertLicenseOnIncrease>;
 /**
- * Controls how the last payment is refunded on immediate cancellation. 'prorated' refunds the unused portion, 'full' refunds the entire last payment.
+ * Credit behavior when quantity decreases mid-cycle.
  */
-declare const PreviewUpdateRefundLastPayment: {
-    readonly Prorated: "prorated";
-    readonly Full: "full";
+declare const PreviewUpdateUpsertLicenseOnDecrease: {
+    readonly Prorate: "prorate";
+    readonly ProrateImmediately: "prorate_immediately";
+    readonly ProrateNextCycle: "prorate_next_cycle";
+    readonly None: "none";
+    readonly NoProrations: "no_prorations";
 };
 /**
- * Controls how the last payment is refunded on immediate cancellation. 'prorated' refunds the unused portion, 'full' refunds the entire last payment.
+ * Credit behavior when quantity decreases mid-cycle.
  */
-type PreviewUpdateRefundLastPayment = ClosedEnum<typeof PreviewUpdateRefundLastPayment>;
+type PreviewUpdateUpsertLicenseOnDecrease = ClosedEnum<typeof PreviewUpdateUpsertLicenseOnDecrease>;
 /**
- * Controls whether balances should be recalculated during the subscription update.
+ * Proration settings for prepaid features. Controls mid-cycle quantity change billing.
  */
-type PreviewUpdateRecalculateBalances = {
+type PreviewUpdateUpsertLicenseProration = {
     /**
-     * If true, recalculates balances during the subscription update. Only applicable when updating feature quantities.
+     * Billing behavior when quantity increases mid-cycle.
      */
-    enabled: boolean;
+    onIncrease: PreviewUpdateUpsertLicenseOnIncrease;
+    /**
+     * Credit behavior when quantity decreases mid-cycle.
+     */
+    onDecrease: PreviewUpdateUpsertLicenseOnDecrease;
 };
 /**
- * Whether to carry over usages from the previous plan.
+ * When rolled over units expire.
  */
-type PreviewUpdateCarryOverUsages = {
-    /**
-     * Whether to carry over usages from the previous plan.
-     */
-    enabled: boolean;
-    /**
-     * The IDs of the features to carry over usages for. If left undefined, all consumable features will be carried over.
-     */
-    featureIds?: Array<string> | undefined;
+declare const PreviewUpdateUpsertLicenseExpiryDurationType: {
+    readonly Month: "month";
+    readonly Forever: "forever";
 };
-type PreviewUpdateParams = {
+/**
+ * When rolled over units expire.
+ */
+type PreviewUpdateUpsertLicenseExpiryDurationType = ClosedEnum<typeof PreviewUpdateUpsertLicenseExpiryDurationType>;
+/**
+ * Rollover config for unused units. If set, unused included units carry over.
+ */
+type PreviewUpdateUpsertLicenseRollover = {
     /**
-     * The ID of the customer to attach the plan to.
+     * Max rollover units. Omit for unlimited rollover.
      */
-    customerId: string;
+    max?: number | undefined;
     /**
-     * The ID of the entity to attach the plan to.
+     * Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.
      */
-    entityId?: string | undefined;
+    maxPercentage?: number | undefined;
     /**
-     * The ID of the plan to update. Optional if subscription_id is provided, or if the customer has only one product.
+     * When rolled over units expire.
      */
-    planId?: string | undefined;
+    expiryDurationType: PreviewUpdateUpsertLicenseExpiryDurationType;
     /**
-     * If this plan contains prepaid features, use this field to specify the quantity of each prepaid feature. This quantity includes the included amount and billing units defined when setting up the plan.
+     * Number of periods before expiry.
+     */
+    expiryDurationLength?: number | undefined;
+};
+/**
+ * Configuration for a feature item in a plan, including usage limits, pricing, and rollover settings.
+ */
+type PreviewUpdateUpsertLicensePlanItem = {
+    /**
+     * The ID of the feature to configure.
+     */
+    featureId: string;
+    /**
+     * Number of free units included. Balance resets to this each interval for consumable features.
+     */
+    included?: number | undefined;
+    /**
+     * If true, customer has unlimited access to this feature.
+     */
+    unlimited?: boolean | undefined;
+    /**
+     * Reset configuration for consumable features. Omit for non-consumable features like seats.
+     */
+    reset?: PreviewUpdateUpsertLicenseReset | undefined;
+    /**
+     * Pricing for usage beyond included units. Omit for free features.
+     */
+    price?: PreviewUpdateUpsertLicensePrice | undefined;
+    /**
+     * Proration settings for prepaid features. Controls mid-cycle quantity change billing.
+     */
+    proration?: PreviewUpdateUpsertLicenseProration | undefined;
+    /**
+     * Rollover config for unused units. If set, unused included units carry over.
+     */
+    rollover?: PreviewUpdateUpsertLicenseRollover | undefined;
+};
+/**
+ * Match items with this billing method (prepaid or usage_based).
+ */
+declare const PreviewUpdateUpsertLicenseRemoveItemBillingMethod: {
+    readonly Prepaid: "prepaid";
+    readonly UsageBased: "usage_based";
+};
+/**
+ * Match items with this billing method (prepaid or usage_based).
+ */
+type PreviewUpdateUpsertLicenseRemoveItemBillingMethod = ClosedEnum<typeof PreviewUpdateUpsertLicenseRemoveItemBillingMethod>;
+declare const PreviewUpdateIntervalUpsertLicenseRemoveItemEnum2: {
+    readonly OneOff: "one_off";
+    readonly Minute: "minute";
+    readonly Hour: "hour";
+    readonly Day: "day";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Quarter: "quarter";
+    readonly SemiAnnual: "semi_annual";
+    readonly Year: "year";
+};
+type PreviewUpdateIntervalUpsertLicenseRemoveItemEnum2 = ClosedEnum<typeof PreviewUpdateIntervalUpsertLicenseRemoveItemEnum2>;
+declare const PreviewUpdateIntervalUpsertLicenseRemoveItemEnum1: {
+    readonly OneOff: "one_off";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Quarter: "quarter";
+    readonly SemiAnnual: "semi_annual";
+    readonly Year: "year";
+};
+type PreviewUpdateIntervalUpsertLicenseRemoveItemEnum1 = ClosedEnum<typeof PreviewUpdateIntervalUpsertLicenseRemoveItemEnum1>;
+/**
+ * Filter for matching plan items. All provided fields must match (AND).
+ */
+type PreviewUpdateUpsertLicensePlanItemFilter = {
+    /**
+     * Match items linked to this feature.
+     */
+    featureId?: string | undefined;
+    /**
+     * Match items with this billing method (prepaid or usage_based).
+     */
+    billingMethod?: PreviewUpdateUpsertLicenseRemoveItemBillingMethod | undefined;
+    /**
+     * Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.
+     */
+    interval?: PreviewUpdateIntervalUpsertLicenseRemoveItemEnum1 | PreviewUpdateIntervalUpsertLicenseRemoveItemEnum2 | undefined;
+    /**
+     * Match items with this interval_count. Disambiguates between items that share an interval but differ in count.
+     */
+    intervalCount?: number | undefined;
+};
+type PreviewUpdateUpsertLicenseCustomize = {
+    price?: PreviewUpdateUpsertLicenseBasePrice | null | undefined;
+    addItems?: Array<PreviewUpdateUpsertLicensePlanItem> | undefined;
+    removeItems?: Array<PreviewUpdateUpsertLicensePlanItemFilter> | undefined;
+};
+type PreviewUpdateUpsertLicense = {
+    licensePlanId: string;
+    included?: number | undefined;
+    prepaidOnly?: boolean | undefined;
+    customize?: PreviewUpdateUpsertLicenseCustomize | null | undefined;
+    metadata?: {
+        [k: string]: any;
+    } | undefined;
+};
+/**
+ * Customize the plan to attach. Can override the price, items, licenses, free trial, or a combination.
+ */
+type PreviewUpdateCustomize = {
+    /**
+     * Override the base price of the plan. Pass null to remove the base price.
+     */
+    price?: PreviewUpdateBasePrice | null | undefined;
+    /**
+     * Override the items in the plan (PUT-style — replaces all existing items). Mutually exclusive with add_items / remove_items / deprecated update_items.
+     */
+    items?: Array<PreviewUpdateItemPlanItem> | undefined;
+    /**
+     * Items to add to the plan.
+     */
+    addItems?: Array<PreviewUpdateAddItemPlanItem> | undefined;
+    /**
+     * Filters selecting items to remove from the plan.
+     */
+    removeItems?: Array<PreviewUpdatePlanItemFilter> | undefined;
+    /**
+     * Override the plan's default free trial. Pass an object to set a custom trial, or null to remove the trial entirely.
+     */
+    freeTrial?: PreviewUpdateFreeTrialParams | null | undefined;
+    /**
+     * Override the plan's billing controls (auto top-ups, spend limits, usage limits, usage alerts, overage allowed) for this customer.
+     */
+    billingControls?: PreviewUpdateBillingControls | undefined;
+    /**
+     * License links to add or override for this customer, keyed by license_plan_id. Omitted fields inherit the plan catalog link (included defaults to 1 when the license is not in the catalog). A bare entry restores the license to pure catalog inheritance.
+     */
+    upsertLicenses?: Array<PreviewUpdateUpsertLicense> | undefined;
+};
+/**
+ * Invoice mode creates a draft or open invoice and sends it to the customer, instead of charging their card immediately. This uses Stripe's send_invoice collection method.
+ */
+type PreviewUpdateInvoiceMode = {
+    /**
+     * When true, creates an invoice and sends it to the customer instead of charging their card immediately. Uses Stripe's send_invoice collection method.
+     */
+    enabled: boolean;
+    /**
+     * If true, enables the plan immediately even though the invoice is not paid yet.
+     */
+    enablePlanImmediately?: boolean | undefined;
+    /**
+     * If true, finalizes the invoice so it can be sent to the customer. If false, keeps it as a draft for manual review.
+     */
+    finalize?: boolean | undefined;
+    /**
+     * ID of an invoice template (configured in billing settings) whose footer (e.g. bank details) is applied to the invoice.
+     */
+    invoiceTemplateId?: string | undefined;
+    /**
+     * Number of days the customer has to pay the invoice before it is due (Stripe days_until_due).
+     */
+    netTermsDays?: number | undefined;
+};
+/**
+ * How to handle proration when updating an existing subscription. 'prorate_immediately' charges/credits prorated amounts now, 'none' skips creating any charges.
+ */
+declare const PreviewUpdateProrationBehavior: {
+    readonly ProrateImmediately: "prorate_immediately";
+    readonly None: "none";
+};
+/**
+ * How to handle proration when updating an existing subscription. 'prorate_immediately' charges/credits prorated amounts now, 'none' skips creating any charges.
+ */
+type PreviewUpdateProrationBehavior = ClosedEnum<typeof PreviewUpdateProrationBehavior>;
+/**
+ * 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.
+ */
+declare const PreviewUpdateRedirectMode: {
+    readonly Always: "always";
+    readonly IfRequired: "if_required";
+    readonly Never: "never";
+};
+/**
+ * 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.
+ */
+type PreviewUpdateRedirectMode = ClosedEnum<typeof PreviewUpdateRedirectMode>;
+/**
+ * A discount to apply. Can be either a reward ID or a promotion code.
+ */
+type PreviewUpdateAttachDiscount = {
+    /**
+     * The ID of the reward to apply as a discount.
+     */
+    rewardId?: string | undefined;
+    /**
+     * The promotion code to apply as a discount.
+     */
+    promotionCode?: 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.
+ */
+declare const PreviewUpdateCancelAction: {
+    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 PreviewUpdateCancelAction = ClosedEnum<typeof PreviewUpdateCancelAction>;
+/**
+ * Controls how the last payment is refunded on immediate cancellation. 'prorated' refunds the unused portion, 'full' refunds the entire last payment.
+ */
+declare const PreviewUpdateRefundLastPayment: {
+    readonly Prorated: "prorated";
+    readonly Full: "full";
+};
+/**
+ * Controls how the last payment is refunded on immediate cancellation. 'prorated' refunds the unused portion, 'full' refunds the entire last payment.
+ */
+type PreviewUpdateRefundLastPayment = ClosedEnum<typeof PreviewUpdateRefundLastPayment>;
+/**
+ * Controls whether balances should be recalculated during the subscription update.
+ */
+type PreviewUpdateRecalculateBalances = {
+    /**
+     * If true, recalculates balances during the subscription update. Only applicable when updating feature quantities.
+     */
+    enabled: boolean;
+};
+/**
+ * Whether to carry over usages from the previous plan.
+ */
+type PreviewUpdateCarryOverUsages = {
+    /**
+     * Whether to carry over usages from the previous plan.
+     */
+    enabled: boolean;
+    /**
+     * The IDs of the features to carry over usages for. If left undefined, all consumable features will be carried over.
+     */
+    featureIds?: Array<string> | undefined;
+};
+type PreviewUpdateLicenseQuantity = {
+    /**
+     * The license plan to set seat quantity for.
+     */
+    licensePlanId: string;
+    /**
+     * Total seats for the license, inclusive of the plan's included amount — seats beyond it are paid.
+     */
+    quantity: number;
+};
+type PreviewUpdateParams = {
+    /**
+     * The ID of the customer to attach the plan to.
+     */
+    customerId: string;
+    /**
+     * The ID of the entity to attach the plan to.
+     */
+    entityId?: string | undefined;
+    /**
+     * The ID of the plan to update. Optional if subscription_id is provided, or if the customer has only one product.
+     */
+    planId?: string | undefined;
+    /**
+     * If this plan contains prepaid features, use this field to specify the quantity of each prepaid feature. This quantity includes the included amount and billing units defined when setting up the plan.
      */
     featureQuantities?: Array<PreviewUpdateFeatureQuantityRequest> | undefined;
     /**
@@ -8584,7 +10406,7 @@ type PreviewUpdateParams = {
      */
     version?: number | undefined;
     /**
-     * Customize the plan to attach. Can override the price, items, free trial, or a combination.
+     * Customize the plan to attach. Can override the price, items, licenses, free trial, or a combination.
      */
     customize?: PreviewUpdateCustomize | undefined;
     /**
@@ -8631,6 +10453,10 @@ type PreviewUpdateParams = {
      * Whether to carry over usages from the previous plan.
      */
     carryOverUsages?: PreviewUpdateCarryOverUsages | undefined;
+    /**
+     * Total seat quantities (inclusive of the license's included count) per license plan offered by this plan. Licenses not listed keep their current paid quantity.
+     */
+    licenseQuantities?: Array<PreviewUpdateLicenseQuantity> | undefined;
 };
 type PreviewUpdateDiscount = {
     amountOff: number;
@@ -9037,6 +10863,16 @@ declare const SetupPaymentPriceInterval: {
  * Billing interval (e.g. 'month', 'year').
  */
 type SetupPaymentPriceInterval = ClosedEnum<typeof SetupPaymentPriceInterval>;
+type SetupPaymentAdditionalCurrency = {
+    /**
+     * Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').
+     */
+    currency: string;
+    /**
+     * Price amount in this currency. Set explicitly per currency, not converted from the base amount.
+     */
+    amount: number;
+};
 /**
  * Base price configuration for a plan.
  */
@@ -9053,6 +10889,10 @@ type SetupPaymentBasePrice = {
      * Number of intervals per billing cycle. Defaults to 1.
      */
     intervalCount?: number | undefined;
+    /**
+     * Base price amounts in additional currencies. The base 'amount' is in the org's default currency.
+     */
+    additionalCurrencies?: Array<SetupPaymentAdditionalCurrency> | undefined;
 };
 /**
  * Interval at which balance resets (e.g. 'month', 'year'). For consumable features only.
@@ -9085,13 +10925,41 @@ type SetupPaymentItemReset = {
      */
     intervalCount?: number | undefined;
 };
-type SetupPaymentItemTier = {
-    to: number | string;
-    amount?: number | undefined;
-    flatAmount?: number | undefined;
-};
-declare const SetupPaymentItemTierBehavior: {
-    readonly Graduated: "graduated";
+type SetupPaymentItemAdditionalCurrency = {
+    /**
+     * Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').
+     */
+    currency: string;
+    /**
+     * Price amount in this currency. Set explicitly per currency, not converted from the base amount.
+     */
+    amount: number;
+};
+type SetupPaymentItemTierAdditionalCurrency = {
+    /**
+     * Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').
+     */
+    currency: string;
+    /**
+     * Per-unit amount for this tier in this currency.
+     */
+    amount?: number | undefined;
+    /**
+     * Flat amount for this tier in this currency, if the tier uses one.
+     */
+    flatAmount?: number | undefined;
+};
+type SetupPaymentItemTier = {
+    to: number | string;
+    amount?: number | undefined;
+    flatAmount?: number | undefined;
+    /**
+     * Per-currency amounts for this tier. Tier boundaries ('to') are shared across all currencies.
+     */
+    additionalCurrencies?: Array<SetupPaymentItemTierAdditionalCurrency> | undefined;
+};
+declare const SetupPaymentItemTierBehavior: {
+    readonly Graduated: "graduated";
     readonly Volume: "volume";
 };
 type SetupPaymentItemTierBehavior = ClosedEnum<typeof SetupPaymentItemTierBehavior>;
@@ -9129,6 +10997,10 @@ type SetupPaymentItemPrice = {
      * Price per billing_units after included usage. Either 'amount' or 'tiers' is required.
      */
     amount?: number | undefined;
+    /**
+     * Amounts in additional currencies for this flat price. The base 'amount' is in the org's default currency. Only valid with 'amount', not 'tiers'.
+     */
+    additionalCurrencies?: Array<SetupPaymentItemAdditionalCurrency> | undefined;
     /**
      * Tiered pricing.  Either 'amount' or 'tiers' is required.
      */
@@ -9291,10 +11163,38 @@ type SetupPaymentAddItemReset = {
      */
     intervalCount?: number | undefined;
 };
+type SetupPaymentAddItemAdditionalCurrency = {
+    /**
+     * Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').
+     */
+    currency: string;
+    /**
+     * Price amount in this currency. Set explicitly per currency, not converted from the base amount.
+     */
+    amount: number;
+};
+type SetupPaymentAddItemTierAdditionalCurrency = {
+    /**
+     * Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').
+     */
+    currency: string;
+    /**
+     * Per-unit amount for this tier in this currency.
+     */
+    amount?: number | undefined;
+    /**
+     * Flat amount for this tier in this currency, if the tier uses one.
+     */
+    flatAmount?: number | undefined;
+};
 type SetupPaymentAddItemTier = {
     to: number | string;
     amount?: number | undefined;
     flatAmount?: number | undefined;
+    /**
+     * Per-currency amounts for this tier. Tier boundaries ('to') are shared across all currencies.
+     */
+    additionalCurrencies?: Array<SetupPaymentAddItemTierAdditionalCurrency> | undefined;
 };
 declare const SetupPaymentAddItemTierBehavior: {
     readonly Graduated: "graduated";
@@ -9335,6 +11235,10 @@ type SetupPaymentAddItemPrice = {
      * Price per billing_units after included usage. Either 'amount' or 'tiers' is required.
      */
     amount?: number | undefined;
+    /**
+     * Amounts in additional currencies for this flat price. The base 'amount' is in the org's default currency. Only valid with 'amount', not 'tiers'.
+     */
+    additionalCurrencies?: Array<SetupPaymentAddItemAdditionalCurrency> | undefined;
     /**
      * Tiered pricing.  Either 'amount' or 'tiers' is required.
      */
@@ -9555,218 +11459,555 @@ type SetupPaymentFreeTrialParams = {
      */
     durationType?: SetupPaymentDurationType | undefined;
     /**
-     * If true, payment method required to start trial. Customer is charged after trial ends.
+     * If true, payment method required to start trial. Customer is charged after trial ends.
+     */
+    cardRequired?: boolean | undefined;
+    /**
+     * Behavior when the trial ends. 'bill' charges the customer (default). 'revert' expires the trial and restores the customer's previous plan.
+     */
+    onEnd?: SetupPaymentOnEnd | undefined;
+};
+/**
+ * The time interval for the purchase limit window.
+ */
+declare const SetupPaymentPurchaseLimitInterval: {
+    readonly Hour: "hour";
+    readonly Day: "day";
+    readonly Week: "week";
+    readonly Month: "month";
+};
+/**
+ * The time interval for the purchase limit window.
+ */
+type SetupPaymentPurchaseLimitInterval = ClosedEnum<typeof SetupPaymentPurchaseLimitInterval>;
+/**
+ * Optional rate limit to cap how often auto top-ups occur.
+ */
+type SetupPaymentPurchaseLimit = {
+    /**
+     * The time interval for the purchase limit window.
+     */
+    interval: SetupPaymentPurchaseLimitInterval;
+    /**
+     * Number of intervals in the purchase limit window.
+     */
+    intervalCount?: number | undefined;
+    /**
+     * Maximum number of auto top-ups allowed within the interval.
+     */
+    limit: number;
+};
+type SetupPaymentAutoTopup = {
+    /**
+     * The ID of the feature (credit balance) to auto top-up.
+     */
+    featureId: string;
+    /**
+     * Whether auto top-up is enabled.
+     */
+    enabled?: boolean | undefined;
+    /**
+     * When the balance drops below this threshold, an auto top-up will be purchased.
+     */
+    threshold: number;
+    /**
+     * Amount of credits to add per auto top-up.
+     */
+    quantity: number;
+    /**
+     * Optional rate limit to cap how often auto top-ups occur.
+     */
+    purchaseLimit?: SetupPaymentPurchaseLimit | undefined;
+    /**
+     * When true, auto top-up creates a send_invoice invoice instead of auto-charging.
+     */
+    invoiceMode?: boolean | undefined;
+};
+/**
+ * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
+ */
+declare const SetupPaymentLimitType: {
+    readonly Absolute: "absolute";
+    readonly UsagePercentage: "usage_percentage";
+};
+/**
+ * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
+ */
+type SetupPaymentLimitType = ClosedEnum<typeof SetupPaymentLimitType>;
+type SetupPaymentSpendLimit = {
+    /**
+     * Optional feature ID this spend limit applies to.
+     */
+    featureId?: string | undefined;
+    /**
+     * Whether the overage spend limit is enabled.
+     */
+    enabled?: boolean | undefined;
+    /**
+     * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
+     */
+    limitType?: SetupPaymentLimitType | undefined;
+    /**
+     * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
+     */
+    overageLimit?: number | undefined;
+    /**
+     * When true, overage for this feature is not posted to Stripe. Usage tracking and balance resets still behave normally.
+     */
+    skipOverageBilling?: boolean | undefined;
+};
+/**
+ * Interval for the cap, aligned to the customer's billing cycle.
+ */
+declare const SetupPaymentUsageLimitInterval: {
+    readonly Day: "day";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Year: "year";
+};
+/**
+ * Interval for the cap, aligned to the customer's billing cycle.
+ */
+type SetupPaymentUsageLimitInterval = ClosedEnum<typeof SetupPaymentUsageLimitInterval>;
+/**
+ * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+ */
+type SetupPaymentFilter = {
+    properties: {
+        [k: string]: string | number | boolean;
+    };
+};
+type SetupPaymentUsageLimit = {
+    /**
+     * The feature this usage limit applies to.
+     */
+    featureId: string;
+    /**
+     * Whether this usage limit is enabled.
+     */
+    enabled?: boolean | undefined;
+    /**
+     * Maximum units allowed per interval.
+     */
+    limit: number;
+    /**
+     * Interval for the cap, aligned to the customer's billing cycle.
+     */
+    interval: SetupPaymentUsageLimitInterval;
+    /**
+     * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+     */
+    filter?: SetupPaymentFilter | undefined;
+};
+/**
+ * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
+ */
+declare const SetupPaymentThresholdType: {
+    readonly Usage: "usage";
+    readonly UsagePercentage: "usage_percentage";
+    readonly Remaining: "remaining";
+    readonly RemainingPercentage: "remaining_percentage";
+};
+/**
+ * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
+ */
+type SetupPaymentThresholdType = ClosedEnum<typeof SetupPaymentThresholdType>;
+type SetupPaymentUsageAlert = {
+    /**
+     * The feature ID this alert applies to.
+     */
+    featureId?: string | undefined;
+    /**
+     * Whether this usage alert is enabled.
+     */
+    enabled?: boolean | undefined;
+    /**
+     * The threshold value that triggers the alert. For usage or remaining, this is an absolute count. For usage_percentage or remaining_percentage, this is a percentage (0-100).
+     */
+    threshold: number;
+    /**
+     * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
+     */
+    thresholdType: SetupPaymentThresholdType;
+    /**
+     * Optional user-defined label to distinguish multiple alerts on the same feature.
+     */
+    name?: string | undefined;
+};
+type SetupPaymentOverageAllowed = {
+    /**
+     * The feature ID this overage allowed control applies to.
+     */
+    featureId: string;
+    /**
+     * Whether overage is allowed for this feature.
+     */
+    enabled?: boolean | undefined;
+};
+/**
+ * Override the plan's billing controls (auto top-ups, spend limits, usage limits, usage alerts, overage allowed) for this customer.
+ */
+type SetupPaymentBillingControls = {
+    /**
+     * List of auto top-up configurations per feature.
+     */
+    autoTopups?: Array<SetupPaymentAutoTopup> | undefined;
+    /**
+     * List of overage spend limits per feature (caps overage spend).
+     */
+    spendLimits?: Array<SetupPaymentSpendLimit> | undefined;
+    /**
+     * List of hard usage caps per feature (max units per interval).
+     */
+    usageLimits?: Array<SetupPaymentUsageLimit> | undefined;
+    /**
+     * List of usage alert configurations per feature.
+     */
+    usageAlerts?: Array<SetupPaymentUsageAlert> | undefined;
+    /**
+     * List of overage allowed controls per feature. When enabled, usage can exceed balance.
+     */
+    overageAllowed?: Array<SetupPaymentOverageAllowed> | undefined;
+};
+/**
+ * Billing interval (e.g. 'month', 'year').
+ */
+declare const SetupPaymentPriceUpsertLicenseInterval: {
+    readonly OneOff: "one_off";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Quarter: "quarter";
+    readonly SemiAnnual: "semi_annual";
+    readonly Year: "year";
+};
+/**
+ * Billing interval (e.g. 'month', 'year').
+ */
+type SetupPaymentPriceUpsertLicenseInterval = ClosedEnum<typeof SetupPaymentPriceUpsertLicenseInterval>;
+type SetupPaymentUpsertLicenseAdditionalCurrency = {
+    /**
+     * Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').
+     */
+    currency: string;
+    /**
+     * Price amount in this currency. Set explicitly per currency, not converted from the base amount.
+     */
+    amount: number;
+};
+/**
+ * Base price configuration for a plan.
+ */
+type SetupPaymentUpsertLicenseBasePrice = {
+    /**
+     * Base price amount for the plan.
+     */
+    amount: number;
+    /**
+     * Billing interval (e.g. 'month', 'year').
+     */
+    interval: SetupPaymentPriceUpsertLicenseInterval;
+    /**
+     * Number of intervals per billing cycle. Defaults to 1.
+     */
+    intervalCount?: number | undefined;
+    /**
+     * Base price amounts in additional currencies. The base 'amount' is in the org's default currency.
+     */
+    additionalCurrencies?: Array<SetupPaymentUpsertLicenseAdditionalCurrency> | undefined;
+};
+/**
+ * Interval at which balance resets (e.g. 'month', 'year'). For consumable features only.
+ */
+declare const SetupPaymentUpsertLicenseResetInterval: {
+    readonly OneOff: "one_off";
+    readonly Minute: "minute";
+    readonly Hour: "hour";
+    readonly Day: "day";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Quarter: "quarter";
+    readonly SemiAnnual: "semi_annual";
+    readonly Year: "year";
+};
+/**
+ * Interval at which balance resets (e.g. 'month', 'year'). For consumable features only.
+ */
+type SetupPaymentUpsertLicenseResetInterval = ClosedEnum<typeof SetupPaymentUpsertLicenseResetInterval>;
+/**
+ * Reset configuration for consumable features. Omit for non-consumable features like seats.
+ */
+type SetupPaymentUpsertLicenseReset = {
+    /**
+     * Interval at which balance resets (e.g. 'month', 'year'). For consumable features only.
+     */
+    interval: SetupPaymentUpsertLicenseResetInterval;
+    /**
+     * Number of intervals between resets. Defaults to 1.
+     */
+    intervalCount?: number | undefined;
+};
+type SetupPaymentUpsertLicenseAddItemAdditionalCurrency = {
+    /**
+     * Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').
+     */
+    currency: string;
+    /**
+     * Price amount in this currency. Set explicitly per currency, not converted from the base amount.
      */
-    cardRequired?: boolean | undefined;
+    amount: number;
+};
+type SetupPaymentUpsertLicenseTier = {
+    to?: any | undefined;
+    amount?: number | undefined;
+    flatAmount?: number | undefined;
     /**
-     * Behavior when the trial ends. 'bill' charges the customer (default). 'revert' expires the trial and restores the customer's previous plan.
+     * Per-currency amounts for this tier. Tier boundaries ('to') are shared across all currencies.
      */
-    onEnd?: SetupPaymentOnEnd | undefined;
+    additionalCurrencies?: Array<any> | undefined;
+};
+declare const SetupPaymentUpsertLicenseTierBehavior: {
+    readonly Graduated: "graduated";
+    readonly Volume: "volume";
 };
+type SetupPaymentUpsertLicenseTierBehavior = ClosedEnum<typeof SetupPaymentUpsertLicenseTierBehavior>;
 /**
- * The time interval for the purchase limit window.
+ * Billing interval. For consumable features, should match reset.interval.
  */
-declare const SetupPaymentPurchaseLimitInterval: {
-    readonly Hour: "hour";
-    readonly Day: "day";
+declare const SetupPaymentUpsertLicenseAddItemPriceInterval: {
+    readonly OneOff: "one_off";
     readonly Week: "week";
     readonly Month: "month";
+    readonly Quarter: "quarter";
+    readonly SemiAnnual: "semi_annual";
+    readonly Year: "year";
 };
 /**
- * The time interval for the purchase limit window.
+ * Billing interval. For consumable features, should match reset.interval.
  */
-type SetupPaymentPurchaseLimitInterval = ClosedEnum<typeof SetupPaymentPurchaseLimitInterval>;
+type SetupPaymentUpsertLicenseAddItemPriceInterval = ClosedEnum<typeof SetupPaymentUpsertLicenseAddItemPriceInterval>;
 /**
- * Optional rate limit to cap how often auto top-ups occur.
+ * 'prepaid' for upfront payment (seats), 'usage_based' for pay-as-you-go.
  */
-type SetupPaymentPurchaseLimit = {
-    /**
-     * The time interval for the purchase limit window.
-     */
-    interval: SetupPaymentPurchaseLimitInterval;
+declare const SetupPaymentUpsertLicenseAddItemBillingMethod: {
+    readonly Prepaid: "prepaid";
+    readonly UsageBased: "usage_based";
+};
+/**
+ * 'prepaid' for upfront payment (seats), 'usage_based' for pay-as-you-go.
+ */
+type SetupPaymentUpsertLicenseAddItemBillingMethod = ClosedEnum<typeof SetupPaymentUpsertLicenseAddItemBillingMethod>;
+/**
+ * Pricing for usage beyond included units. Omit for free features.
+ */
+type SetupPaymentUpsertLicensePrice = {
     /**
-     * Number of intervals in the purchase limit window.
+     * Price per billing_units after included usage. Either 'amount' or 'tiers' is required.
      */
-    intervalCount?: number | undefined;
+    amount?: number | undefined;
     /**
-     * Maximum number of auto top-ups allowed within the interval.
+     * Amounts in additional currencies for this flat price. The base 'amount' is in the org's default currency. Only valid with 'amount', not 'tiers'.
      */
-    limit: number;
-};
-type SetupPaymentAutoTopup = {
+    additionalCurrencies?: Array<SetupPaymentUpsertLicenseAddItemAdditionalCurrency> | undefined;
     /**
-     * The ID of the feature (credit balance) to auto top-up.
+     * Tiered pricing.  Either 'amount' or 'tiers' is required.
      */
-    featureId: string;
+    tiers?: Array<SetupPaymentUpsertLicenseTier> | undefined;
+    tierBehavior?: SetupPaymentUpsertLicenseTierBehavior | undefined;
     /**
-     * Whether auto top-up is enabled.
+     * Billing interval. For consumable features, should match reset.interval.
      */
-    enabled?: boolean | undefined;
+    interval: SetupPaymentUpsertLicenseAddItemPriceInterval;
     /**
-     * When the balance drops below this threshold, an auto top-up will be purchased.
+     * Number of intervals per billing cycle. Defaults to 1.
      */
-    threshold: number;
+    intervalCount?: number | undefined;
     /**
-     * Amount of credits to add per auto top-up.
+     * Units per price increment. Usage is rounded UP when billed (e.g. billing_units=100 means 101 rounds to 200).
      */
-    quantity: number;
+    billingUnits?: number | undefined;
     /**
-     * Optional rate limit to cap how often auto top-ups occur.
+     * 'prepaid' for upfront payment (seats), 'usage_based' for pay-as-you-go.
      */
-    purchaseLimit?: SetupPaymentPurchaseLimit | undefined;
+    billingMethod: SetupPaymentUpsertLicenseAddItemBillingMethod;
     /**
-     * When true, auto top-up creates a send_invoice invoice instead of auto-charging.
+     * Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.
      */
-    invoiceMode?: boolean | undefined;
+    maxPurchase?: number | null | undefined;
 };
 /**
- * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
+ * Billing behavior when quantity increases mid-cycle.
  */
-declare const SetupPaymentLimitType: {
-    readonly Absolute: "absolute";
-    readonly UsagePercentage: "usage_percentage";
+declare const SetupPaymentUpsertLicenseOnIncrease: {
+    readonly BillImmediately: "bill_immediately";
+    readonly ProrateImmediately: "prorate_immediately";
+    readonly ProrateNextCycle: "prorate_next_cycle";
+    readonly BillNextCycle: "bill_next_cycle";
 };
 /**
- * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
+ * Billing behavior when quantity increases mid-cycle.
  */
-type SetupPaymentLimitType = ClosedEnum<typeof SetupPaymentLimitType>;
-type SetupPaymentSpendLimit = {
-    /**
-     * Optional feature ID this spend limit applies to.
-     */
-    featureId?: string | undefined;
-    /**
-     * Whether the overage spend limit is enabled.
-     */
-    enabled?: boolean | undefined;
-    /**
-     * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
-     */
-    limitType?: SetupPaymentLimitType | undefined;
+type SetupPaymentUpsertLicenseOnIncrease = ClosedEnum<typeof SetupPaymentUpsertLicenseOnIncrease>;
+/**
+ * Credit behavior when quantity decreases mid-cycle.
+ */
+declare const SetupPaymentUpsertLicenseOnDecrease: {
+    readonly Prorate: "prorate";
+    readonly ProrateImmediately: "prorate_immediately";
+    readonly ProrateNextCycle: "prorate_next_cycle";
+    readonly None: "none";
+    readonly NoProrations: "no_prorations";
+};
+/**
+ * Credit behavior when quantity decreases mid-cycle.
+ */
+type SetupPaymentUpsertLicenseOnDecrease = ClosedEnum<typeof SetupPaymentUpsertLicenseOnDecrease>;
+/**
+ * Proration settings for prepaid features. Controls mid-cycle quantity change billing.
+ */
+type SetupPaymentUpsertLicenseProration = {
     /**
-     * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
+     * Billing behavior when quantity increases mid-cycle.
      */
-    overageLimit?: number | undefined;
+    onIncrease: SetupPaymentUpsertLicenseOnIncrease;
     /**
-     * When true, overage for this feature is not posted to Stripe. Usage tracking and balance resets still behave normally.
+     * Credit behavior when quantity decreases mid-cycle.
      */
-    skipOverageBilling?: boolean | undefined;
+    onDecrease: SetupPaymentUpsertLicenseOnDecrease;
 };
 /**
- * Interval for the cap, aligned to the customer's billing cycle.
+ * When rolled over units expire.
  */
-declare const SetupPaymentUsageLimitInterval: {
-    readonly Day: "day";
-    readonly Week: "week";
+declare const SetupPaymentUpsertLicenseExpiryDurationType: {
     readonly Month: "month";
-    readonly Year: "year";
+    readonly Forever: "forever";
 };
 /**
- * Interval for the cap, aligned to the customer's billing cycle.
+ * When rolled over units expire.
  */
-type SetupPaymentUsageLimitInterval = ClosedEnum<typeof SetupPaymentUsageLimitInterval>;
+type SetupPaymentUpsertLicenseExpiryDurationType = ClosedEnum<typeof SetupPaymentUpsertLicenseExpiryDurationType>;
 /**
- * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+ * Rollover config for unused units. If set, unused included units carry over.
  */
-type SetupPaymentFilter = {
-    properties: {
-        [k: string]: string | number | boolean;
-    };
-};
-type SetupPaymentUsageLimit = {
-    /**
-     * The feature this usage limit applies to.
-     */
-    featureId: string;
+type SetupPaymentUpsertLicenseRollover = {
     /**
-     * Whether this usage limit is enabled.
+     * Max rollover units. Omit for unlimited rollover.
      */
-    enabled?: boolean | undefined;
+    max?: number | undefined;
     /**
-     * Maximum units allowed per interval.
+     * Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.
      */
-    limit: number;
+    maxPercentage?: number | undefined;
     /**
-     * Interval for the cap, aligned to the customer's billing cycle.
+     * When rolled over units expire.
      */
-    interval: SetupPaymentUsageLimitInterval;
+    expiryDurationType: SetupPaymentUpsertLicenseExpiryDurationType;
     /**
-     * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+     * Number of periods before expiry.
      */
-    filter?: SetupPaymentFilter | undefined;
-};
-/**
- * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
- */
-declare const SetupPaymentThresholdType: {
-    readonly Usage: "usage";
-    readonly UsagePercentage: "usage_percentage";
-    readonly Remaining: "remaining";
-    readonly RemainingPercentage: "remaining_percentage";
+    expiryDurationLength?: number | undefined;
 };
 /**
- * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
+ * Configuration for a feature item in a plan, including usage limits, pricing, and rollover settings.
  */
-type SetupPaymentThresholdType = ClosedEnum<typeof SetupPaymentThresholdType>;
-type SetupPaymentUsageAlert = {
+type SetupPaymentUpsertLicensePlanItem = {
     /**
-     * The feature ID this alert applies to.
+     * The ID of the feature to configure.
      */
-    featureId?: string | undefined;
+    featureId: string;
     /**
-     * Whether this usage alert is enabled.
+     * Number of free units included. Balance resets to this each interval for consumable features.
      */
-    enabled?: boolean | undefined;
+    included?: number | undefined;
     /**
-     * The threshold value that triggers the alert. For usage or remaining, this is an absolute count. For usage_percentage or remaining_percentage, this is a percentage (0-100).
+     * If true, customer has unlimited access to this feature.
      */
-    threshold: number;
+    unlimited?: boolean | undefined;
     /**
-     * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
+     * Reset configuration for consumable features. Omit for non-consumable features like seats.
      */
-    thresholdType: SetupPaymentThresholdType;
+    reset?: SetupPaymentUpsertLicenseReset | undefined;
     /**
-     * Optional user-defined label to distinguish multiple alerts on the same feature.
+     * Pricing for usage beyond included units. Omit for free features.
      */
-    name?: string | undefined;
-};
-type SetupPaymentOverageAllowed = {
+    price?: SetupPaymentUpsertLicensePrice | undefined;
     /**
-     * The feature ID this overage allowed control applies to.
+     * Proration settings for prepaid features. Controls mid-cycle quantity change billing.
      */
-    featureId: string;
+    proration?: SetupPaymentUpsertLicenseProration | undefined;
     /**
-     * Whether overage is allowed for this feature.
+     * Rollover config for unused units. If set, unused included units carry over.
      */
-    enabled?: boolean | undefined;
+    rollover?: SetupPaymentUpsertLicenseRollover | undefined;
 };
 /**
- * Override the plan's billing controls (auto top-ups, spend limits, usage limits, usage alerts, overage allowed) for this customer.
+ * Match items with this billing method (prepaid or usage_based).
  */
-type SetupPaymentBillingControls = {
-    /**
-     * List of auto top-up configurations per feature.
-     */
-    autoTopups?: Array<SetupPaymentAutoTopup> | undefined;
+declare const SetupPaymentUpsertLicenseRemoveItemBillingMethod: {
+    readonly Prepaid: "prepaid";
+    readonly UsageBased: "usage_based";
+};
+/**
+ * Match items with this billing method (prepaid or usage_based).
+ */
+type SetupPaymentUpsertLicenseRemoveItemBillingMethod = ClosedEnum<typeof SetupPaymentUpsertLicenseRemoveItemBillingMethod>;
+declare const SetupPaymentIntervalUpsertLicenseRemoveItemEnum2: {
+    readonly OneOff: "one_off";
+    readonly Minute: "minute";
+    readonly Hour: "hour";
+    readonly Day: "day";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Quarter: "quarter";
+    readonly SemiAnnual: "semi_annual";
+    readonly Year: "year";
+};
+type SetupPaymentIntervalUpsertLicenseRemoveItemEnum2 = ClosedEnum<typeof SetupPaymentIntervalUpsertLicenseRemoveItemEnum2>;
+declare const SetupPaymentIntervalUpsertLicenseRemoveItemEnum1: {
+    readonly OneOff: "one_off";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Quarter: "quarter";
+    readonly SemiAnnual: "semi_annual";
+    readonly Year: "year";
+};
+type SetupPaymentIntervalUpsertLicenseRemoveItemEnum1 = ClosedEnum<typeof SetupPaymentIntervalUpsertLicenseRemoveItemEnum1>;
+/**
+ * Filter for matching plan items. All provided fields must match (AND).
+ */
+type SetupPaymentUpsertLicensePlanItemFilter = {
     /**
-     * List of overage spend limits per feature (caps overage spend).
+     * Match items linked to this feature.
      */
-    spendLimits?: Array<SetupPaymentSpendLimit> | undefined;
+    featureId?: string | undefined;
     /**
-     * List of hard usage caps per feature (max units per interval).
+     * Match items with this billing method (prepaid or usage_based).
      */
-    usageLimits?: Array<SetupPaymentUsageLimit> | undefined;
+    billingMethod?: SetupPaymentUpsertLicenseRemoveItemBillingMethod | undefined;
     /**
-     * List of usage alert configurations per feature.
+     * Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.
      */
-    usageAlerts?: Array<SetupPaymentUsageAlert> | undefined;
+    interval?: SetupPaymentIntervalUpsertLicenseRemoveItemEnum1 | SetupPaymentIntervalUpsertLicenseRemoveItemEnum2 | undefined;
     /**
-     * List of overage allowed controls per feature. When enabled, usage can exceed balance.
+     * Match items with this interval_count. Disambiguates between items that share an interval but differ in count.
      */
-    overageAllowed?: Array<SetupPaymentOverageAllowed> | undefined;
+    intervalCount?: number | undefined;
+};
+type SetupPaymentUpsertLicenseCustomize = {
+    price?: SetupPaymentUpsertLicenseBasePrice | null | undefined;
+    addItems?: Array<SetupPaymentUpsertLicensePlanItem> | undefined;
+    removeItems?: Array<SetupPaymentUpsertLicensePlanItemFilter> | undefined;
+};
+type SetupPaymentUpsertLicense = {
+    licensePlanId: string;
+    included?: number | undefined;
+    prepaidOnly?: boolean | undefined;
+    customize?: SetupPaymentUpsertLicenseCustomize | null | undefined;
+    metadata?: {
+        [k: string]: any;
+    } | undefined;
 };
 /**
- * Customize the plan to attach. Can override the price, items, free trial, or a combination.
+ * Customize the plan to attach. Can override the price, items, licenses, free trial, or a combination.
  */
 type SetupPaymentCustomize = {
     /**
@@ -9793,6 +12034,10 @@ type SetupPaymentCustomize = {
      * Override the plan's billing controls (auto top-ups, spend limits, usage limits, usage alerts, overage allowed) for this customer.
      */
     billingControls?: SetupPaymentBillingControls | undefined;
+    /**
+     * License links to add or override for this customer, keyed by license_plan_id. Omitted fields inherit the plan catalog link (included defaults to 1 when the license is not in the catalog). A bare entry restores the license to pure catalog inheritance.
+     */
+    upsertLicenses?: Array<SetupPaymentUpsertLicense> | undefined;
 };
 /**
  * How to handle proration when updating an existing subscription. 'prorate_immediately' charges/credits prorated amounts now, 'none' skips creating any charges.
@@ -9854,6 +12099,16 @@ type SetupPaymentCarryOverUsages = {
      */
     featureIds?: Array<string> | undefined;
 };
+type SetupPaymentLicenseQuantity = {
+    /**
+     * The license plan to set seat quantity for.
+     */
+    licensePlanId: string;
+    /**
+     * Total seats for the license, inclusive of the plan's included amount — seats beyond it are paid.
+     */
+    quantity: number;
+};
 type SetupPaymentParams = {
     /**
      * The ID of the customer to attach the plan to.
@@ -9876,7 +12131,7 @@ type SetupPaymentParams = {
      */
     version?: number | undefined;
     /**
-     * Customize the plan to attach. Can override the price, items, free trial, or a combination.
+     * Customize the plan to attach. Can override the price, items, licenses, free trial, or a combination.
      */
     customize?: SetupPaymentCustomize | undefined;
     /**
@@ -9929,6 +12184,10 @@ type SetupPaymentParams = {
      * Whether to carry over usages from the previous plan.
      */
     carryOverUsages?: SetupPaymentCarryOverUsages | undefined;
+    /**
+     * Seat quantities for the plan's licenses, keyed by license plan.
+     */
+    licenseQuantities?: Array<SetupPaymentLicenseQuantity> | undefined;
     /**
      * Key-value metadata to attach to the Stripe subscription, invoice, and checkout session created during this attach flow. Keys prefixed with 'autumn_' are reserved and will be stripped.
      */
@@ -9947,6 +12206,10 @@ type SetupPaymentParams = {
      * Stripe tax rate ID (txr_...) to apply as the default tax rate on the created subscription, invoice, or checkout session line items.
      */
     taxRateId?: string | undefined;
+    /**
+     * Currency to bill this attach in (e.g. usd, eur). Must match the customer's currency if they are already locked to one, and the plan must offer a paid price in it. Defaults to the customer's currency, then the org default.
+     */
+    currency?: string | undefined;
 };
 /**
  * OK