orb-billing 5.48.0 → 5.76.0

package/resources/subscriptions.d.ts

@@ -268,12 +268,25 @@ export declare class Subscriptions extends APIResource {
      * ## Limits
      *
      * By default, Orb limits the number of subscriptions per customer to 100.
+     *
+     * @example
+     * ```ts
+     * const mutatedSubscription =
+     *   await client.subscriptions.create();
+     * ```
      */
     create(body: SubscriptionCreateParams, options?: Core.RequestOptions): Core.APIPromise<SubscriptionChangesAPI.MutatedSubscription>;
     /**
      * This endpoint can be used to update the `metadata`, `net terms`,
      * `auto_collection`, `invoicing_threshold`, and `default_invoice_memo` properties
      * on a subscription.
+     *
+     * @example
+     * ```ts
+     * const subscription = await client.subscriptions.update(
+     *   'subscription_id',
+     * );
+     * ```
      */
     update(subscriptionId: string, body: SubscriptionUpdateParams, options?: Core.RequestOptions): Core.APIPromise<Subscription>;
     /**
@@ -286,6 +299,19 @@ export declare class Subscriptions extends APIResource {
      * customer_id or external_customer_id query parameters. To filter subscriptions
      * for multiple customers, use the customer_id[] or external_customer_id[] query
      * parameters.
+     *
+     * Subscriptions can be filtered by status using the status query parameter (one of
+     * `active`, `ended`, or `upcoming`). To filter for multiple statuses in a single
+     * request, use the status[] query parameter, e.g.
+     * `status[]=active&status[]=ended`.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const subscription of client.subscriptions.list()) {
+     *   // ...
+     * }
+     * ```
      */
     list(query?: SubscriptionListParams, options?: Core.RequestOptions): Core.PagePromise<SubscriptionsPage, Subscription>;
     list(options?: Core.RequestOptions): Core.PagePromise<SubscriptionsPage, Subscription>;
@@ -351,11 +377,26 @@ export declare class Subscriptions extends APIResource {
      * Orb will void the intervening invoice and generate a new one based on the new
      * dates for the subscription. See the section on
      * [cancellation behaviors](/product-catalog/creating-subscriptions#cancellation-behaviors).
+     *
+     * @example
+     * ```ts
+     * const mutatedSubscription =
+     *   await client.subscriptions.cancel('subscription_id', {
+     *     cancel_option: 'end_of_subscription_term',
+     *   });
+     * ```
      */
     cancel(subscriptionId: string, body: SubscriptionCancelParams, options?: Core.RequestOptions): Core.APIPromise<SubscriptionChangesAPI.MutatedSubscription>;
     /**
      * This endpoint is used to fetch a [Subscription](/core-concepts##subscription)
      * given an identifier.
+     *
+     * @example
+     * ```ts
+     * const subscription = await client.subscriptions.fetch(
+     *   'subscription_id',
+     * );
+     * ```
      */
     fetch(subscriptionId: string, options?: Core.RequestOptions): Core.APIPromise<Subscription>;
     /**
@@ -369,6 +410,13 @@ export declare class Subscriptions extends APIResource {
      * this endpoint to limit your analysis of costs to a specific subscription for the
      * customer (e.g. to de-aggregate costs when a customer's subscription has started
      * and stopped on the same day).
+     *
+     * @example
+     * ```ts
+     * const response = await client.subscriptions.fetchCosts(
+     *   'subscription_id',
+     * );
+     * ```
      */
     fetchCosts(subscriptionId: string, query?: SubscriptionFetchCostsParams, options?: Core.RequestOptions): Core.APIPromise<SubscriptionFetchCostsResponse>;
     fetchCosts(subscriptionId: string, options?: Core.RequestOptions): Core.APIPromise<SubscriptionFetchCostsResponse>;
@@ -377,6 +425,16 @@ export declare class Subscriptions extends APIResource {
      * associated with a subscription along with their start and end dates. This list
      * contains the subscription's initial plan along with past and future plan
      * changes.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const subscriptionFetchScheduleResponse of client.subscriptions.fetchSchedule(
+     *   'subscription_id',
+     * )) {
+     *   // ...
+     * }
+     * ```
      */
     fetchSchedule(subscriptionId: string, query?: SubscriptionFetchScheduleParams, options?: Core.RequestOptions): Core.PagePromise<SubscriptionFetchScheduleResponsesPage, SubscriptionFetchScheduleResponse>;
     fetchSchedule(subscriptionId: string, options?: Core.RequestOptions): Core.PagePromise<SubscriptionFetchScheduleResponsesPage, SubscriptionFetchScheduleResponse>;
@@ -575,6 +633,12 @@ export declare class Subscriptions extends APIResource {
      * - `first_dimension_value`: `us-east-1`
      * - `second_dimension_key`: `provider`
      * - `second_dimension_value`: `aws`
+     *
+     * @example
+     * ```ts
+     * const subscriptionUsage =
+     *   await client.subscriptions.fetchUsage('subscription_id');
+     * ```
      */
     fetchUsage(subscriptionId: string, query?: SubscriptionFetchUsageParams, options?: Core.RequestOptions): Core.APIPromise<SubscriptionUsage>;
     fetchUsage(subscriptionId: string, options?: Core.RequestOptions): Core.APIPromise<SubscriptionUsage>;
@@ -651,10 +715,27 @@ export declare class Subscriptions extends APIResource {
      * existing list of transitions can be retrieved using the
      * `fixed_fee_quantity_transitions` property on a subscription’s serialized price
      * intervals.
+     *
+     * @example
+     * ```ts
+     * const mutatedSubscription =
+     *   await client.subscriptions.priceIntervals(
+     *     'subscription_id',
+     *   );
+     * ```
      */
     priceIntervals(subscriptionId: string, body: SubscriptionPriceIntervalsParams, options?: Core.RequestOptions): Core.APIPromise<SubscriptionChangesAPI.MutatedSubscription>;
     /**
      * Redeem a coupon effective at a given time.
+     *
+     * @example
+     * ```ts
+     * const mutatedSubscription =
+     *   await client.subscriptions.redeemCoupon(
+     *     'subscription_id',
+     *     { change_option: 'requested_date' },
+     *   );
+     * ```
      */
     redeemCoupon(subscriptionId: string, body: SubscriptionRedeemCouponParams, options?: Core.RequestOptions): Core.APIPromise<SubscriptionChangesAPI.MutatedSubscription>;
     /**
@@ -841,11 +922,28 @@ export declare class Subscriptions extends APIResource {
      * a plan change, adjusting the customer balance as needed. For details on this
      * behavior, see
      * [Modifying subscriptions](/product-catalog/modifying-subscriptions#prorations-for-in-advance-fees).
+     *
+     * @example
+     * ```ts
+     * const mutatedSubscription =
+     *   await client.subscriptions.schedulePlanChange(
+     *     'subscription_id',
+     *     { change_option: 'requested_date' },
+     *   );
+     * ```
      */
     schedulePlanChange(subscriptionId: string, body: SubscriptionSchedulePlanChangeParams, options?: Core.RequestOptions): Core.APIPromise<SubscriptionChangesAPI.MutatedSubscription>;
     /**
      * Manually trigger a phase, effective the given date (or the current time, if not
      * specified).
+     *
+     * @example
+     * ```ts
+     * const mutatedSubscription =
+     *   await client.subscriptions.triggerPhase(
+     *     'subscription_id',
+     *   );
+     * ```
      */
     triggerPhase(subscriptionId: string, body: SubscriptionTriggerPhaseParams, options?: Core.RequestOptions): Core.APIPromise<SubscriptionChangesAPI.MutatedSubscription>;
     /**
@@ -855,6 +953,20 @@ export declare class Subscriptions extends APIResource {
      * To be eligible, the subscription must currently be active and have a future
      * cancellation. This operation will turn on auto-renew, ensuring that the
      * subscription does not end at the currently scheduled cancellation time.
+     *
+     * Note: uncancellation is a lossy operation. Price intervals that were cut short
+     * by the cancellation are extended to infinity (original end dates are lost), and
+     * future intervals or phases scheduled after the cancellation time are permanently
+     * deleted. For complex subscriptions with phases or scheduled plan changes,
+     * consider creating a new plan change instead of uncancelling.
+     *
+     * @example
+     * ```ts
+     * const mutatedSubscription =
+     *   await client.subscriptions.unscheduleCancellation(
+     *     'subscription_id',
+     *   );
+     * ```
      */
     unscheduleCancellation(subscriptionId: string, options?: Core.RequestOptions): Core.APIPromise<SubscriptionChangesAPI.MutatedSubscription>;
     /**
@@ -863,11 +975,28 @@ export declare class Subscriptions extends APIResource {
      *
      * If there are no updates scheduled, a request validation error will be returned
      * with a 400 status code.
+     *
+     * @example
+     * ```ts
+     * const mutatedSubscription =
+     *   await client.subscriptions.unscheduleFixedFeeQuantityUpdates(
+     *     'subscription_id',
+     *     { price_id: 'price_id' },
+     *   );
+     * ```
      */
     unscheduleFixedFeeQuantityUpdates(subscriptionId: string, body: SubscriptionUnscheduleFixedFeeQuantityUpdatesParams, options?: Core.RequestOptions): Core.APIPromise<SubscriptionChangesAPI.MutatedSubscription>;
     /**
      * This endpoint can be used to unschedule any pending plan changes on an existing
      * subscription. When called, all upcoming plan changes will be unscheduled.
+     *
+     * @example
+     * ```ts
+     * const mutatedSubscription =
+     *   await client.subscriptions.unschedulePendingPlanChanges(
+     *     'subscription_id',
+     *   );
+     * ```
      */
     unschedulePendingPlanChanges(subscriptionId: string, options?: Core.RequestOptions): Core.APIPromise<SubscriptionChangesAPI.MutatedSubscription>;
     /**
@@ -885,6 +1014,15 @@ export declare class Subscriptions extends APIResource {
      *
      * If the fee is an in-advance fixed fee, it will also issue an immediate invoice
      * for the difference for the remainder of the billing period.
+     *
+     * @example
+     * ```ts
+     * const mutatedSubscription =
+     *   await client.subscriptions.updateFixedFeeQuantity(
+     *     'subscription_id',
+     *     { price_id: 'price_id', quantity: 0 },
+     *   );
+     * ```
      */
     updateFixedFeeQuantity(subscriptionId: string, body: SubscriptionUpdateFixedFeeQuantityParams, options?: Core.RequestOptions): Core.APIPromise<SubscriptionChangesAPI.MutatedSubscription>;
     /**
@@ -906,6 +1044,15 @@ export declare class Subscriptions extends APIResource {
      * end date shift (so, e.g., if a plan change is scheduled or an add-on price was
      * added, that change will be pushed back by the same amount of time the trial is
      * extended).
+     *
+     * @example
+     * ```ts
+     * const mutatedSubscription =
+     *   await client.subscriptions.updateTrial(
+     *     'subscription_id',
+     *     { trial_end_date: '2017-07-21T17:32:28Z' },
+     *   );
+     * ```
      */
     updateTrial(subscriptionId: string, body: SubscriptionUpdateTrialParams, options?: Core.RequestOptions): Core.APIPromise<SubscriptionChangesAPI.MutatedSubscription>;
 }
@@ -3700,6 +3847,13 @@ export interface Subscription {
      * the plan's behavior. If null, defaults to the customer's setting.
      */
     auto_collection: boolean | null;
+    /**
+     * Determines whether invoices for this subscription will be automatically issued.
+     * This resolves the effective setting for the subscription: a subscription-level
+     * override if set, otherwise the customer-level setting, otherwise the
+     * account-level default.
+     */
+    auto_issuance: boolean | null;
     billing_cycle_anchor_configuration: Shared.BillingCycleAnchorConfiguration;
     /**
      * The day of the month on which the billing cycle is anchored. If the maximum
@@ -3751,7 +3905,7 @@ export interface Subscription {
      * @deprecated The discount intervals for this subscription sorted by the
      * start_date. This field is deprecated in favor of `adjustment_intervals`.
      */
-    discount_intervals: Array<Shared.AmountDiscountInterval | Shared.PercentageDiscountInterval | Shared.UsageDiscountInterval>;
+    discount_intervals: Array<Shared.AmountDiscountInterval | Shared.PercentageDiscountInterval | Shared.UsageDiscountInterval | Subscription.TieredPercentageDiscountInterval>;
     /**
      * The date Orb stops billing for this subscription.
      */
@@ -3811,6 +3965,70 @@ export interface Subscription {
     status: 'active' | 'ended' | 'upcoming';
     trial_info: Shared.SubscriptionTrialInfo;
 }
+export declare namespace Subscription {
+    interface TieredPercentageDiscountInterval {
+        /**
+         * The price interval ids that this discount interval applies to.
+         */
+        applies_to_price_interval_ids: Array<string>;
+        discount_type: 'tiered_percentage';
+        /**
+         * The end date of the discount interval.
+         */
+        end_date: string | null;
+        /**
+         * The filters that determine which prices this discount interval applies to.
+         */
+        filters: Array<TieredPercentageDiscountInterval.Filter>;
+        /**
+         * The start date of the discount interval.
+         */
+        start_date: string;
+        /**
+         * Only available if discount_type is `tiered_percentage`. The ordered, contiguous
+         * bands of cumulative eligible spend, each discounted at its own percentage.
+         */
+        tiers: Array<TieredPercentageDiscountInterval.Tier>;
+    }
+    namespace TieredPercentageDiscountInterval {
+        interface Filter {
+            /**
+             * The property of the price to filter on.
+             */
+            field: 'price_id' | 'item_id' | 'price_type' | 'currency' | 'pricing_unit_id';
+            /**
+             * Should prices that match the filter be included or excluded.
+             */
+            operator: 'includes' | 'excludes';
+            /**
+             * The IDs or values that match this filter.
+             */
+            values: Array<string>;
+        }
+        /**
+         * One band of a tiered percentage discount. Bounds are denominated in the
+         * discount's currency. `lower_bound` is the exclusive start of the band and
+         * `upper_bound` is the inclusive end; `upper_bound` is null only for the
+         * open-ended final tier.
+         */
+        interface Tier {
+            /**
+             * Exclusive lower bound of cumulative spend for this tier.
+             */
+            lower_bound: number;
+            /**
+             * The percentage (between 0 and 1) discounted from spend that falls within this
+             * tier.
+             */
+            percentage: number;
+            /**
+             * Inclusive upper bound of cumulative spend for this tier; null for the final
+             * open-ended tier.
+             */
+            upper_bound?: number | null;
+        }
+    }
+}
 export type SubscriptionUsage = SubscriptionUsage.UngroupedSubscriptionUsage | SubscriptionUsage.GroupedSubscriptionUsage;
 export declare namespace SubscriptionUsage {
     interface UngroupedSubscriptionUsage {
@@ -3905,6 +4123,13 @@ export interface SubscriptionCreateParams {
      * defaults to the behavior configured for this customer.
      */
     auto_collection?: boolean | null;
+    /**
+     * Used to determine if invoices for this subscription will be automatically
+     * issued. If true, invoices will be automatically issued. If false, invoices will
+     * require manual approval. If `null` is specified, this defaults to the behavior
+     * configured for this customer.
+     */
+    auto_issuance?: boolean | null;
     /**
      * @deprecated
      */
@@ -4043,7 +4268,7 @@ export declare namespace SubscriptionCreateParams {
         /**
          * The definition of a new adjustment to create and add to the subscription.
          */
-        adjustment: Shared.NewPercentageDiscount | Shared.NewUsageDiscount | Shared.NewAmountDiscount | Shared.NewMinimum | Shared.NewMaximum;
+        adjustment: Shared.NewPercentageDiscount | Shared.NewUsageDiscount | Shared.NewAmountDiscount | Shared.NewMinimum | Shared.NewMaximum | AddAdjustment.NewTieredPercentageDiscount;
         /**
          * The end date of the adjustment interval. This is the date that the adjustment
          * will stop affecting prices on the subscription.
@@ -4060,6 +4285,71 @@ export declare namespace SubscriptionCreateParams {
          */
         start_date?: string | null;
     }
+    namespace AddAdjustment {
+        interface NewTieredPercentageDiscount {
+            adjustment_type: 'tiered_percentage_discount';
+            tiers: Array<NewTieredPercentageDiscount.Tier>;
+            /**
+             * If set, the adjustment will apply to every price on the subscription.
+             */
+            applies_to_all?: true | null;
+            /**
+             * The set of item IDs to which this adjustment applies.
+             */
+            applies_to_item_ids?: Array<string> | null;
+            /**
+             * The set of price IDs to which this adjustment applies.
+             */
+            applies_to_price_ids?: Array<string> | null;
+            /**
+             * If set, only prices in the specified currency will have the adjustment applied.
+             */
+            currency?: string | null;
+            /**
+             * A list of filters that determine which prices this adjustment will apply to.
+             */
+            filters?: Array<NewTieredPercentageDiscount.Filter> | null;
+            /**
+             * When false, this adjustment will be applied to a single price. Otherwise, it
+             * will be applied at the invoice level, possibly to multiple prices.
+             */
+            is_invoice_level?: boolean;
+            /**
+             * If set, only prices of the specified type will have the adjustment applied.
+             */
+            price_type?: 'usage' | 'fixed_in_advance' | 'fixed_in_arrears' | 'fixed' | 'in_arrears' | null;
+        }
+        namespace NewTieredPercentageDiscount {
+            interface Tier {
+                /**
+                 * Exclusive lower bound of cumulative spend for this tier.
+                 */
+                lower_bound: number;
+                /**
+                 * The percentage (0-1) discounted from spend in this tier.
+                 */
+                percentage: number;
+                /**
+                 * Inclusive upper bound of cumulative spend; null for the final open-ended tier.
+                 */
+                upper_bound?: number | null;
+            }
+            interface Filter {
+                /**
+                 * The property of the price to filter on.
+                 */
+                field: 'price_id' | 'item_id' | 'price_type' | 'currency' | 'pricing_unit_id';
+                /**
+                 * Should prices that match the filter be included or excluded.
+                 */
+                operator: 'includes' | 'excludes';
+                /**
+                 * The IDs or values that match this filter.
+                 */
+                values: Array<string>;
+            }
+        }
+    }
     interface AddPrice {
         /**
          * The definition of a new allocation price to create and add to the subscription.
@@ -4104,7 +4394,7 @@ export declare namespace SubscriptionCreateParams {
         /**
          * New subscription price request body params.
          */
-        price?: SubscriptionsAPI.NewSubscriptionUnitPrice | SubscriptionsAPI.NewSubscriptionTieredPrice | SubscriptionsAPI.NewSubscriptionBulkPrice | AddPrice.NewSubscriptionBulkWithFiltersPrice | SubscriptionsAPI.NewSubscriptionPackagePrice | SubscriptionsAPI.NewSubscriptionMatrixPrice | SubscriptionsAPI.NewSubscriptionThresholdTotalAmountPrice | SubscriptionsAPI.NewSubscriptionTieredPackagePrice | SubscriptionsAPI.NewSubscriptionTieredWithMinimumPrice | SubscriptionsAPI.NewSubscriptionGroupedTieredPrice | SubscriptionsAPI.NewSubscriptionTieredPackageWithMinimumPrice | SubscriptionsAPI.NewSubscriptionPackageWithAllocationPrice | SubscriptionsAPI.NewSubscriptionUnitWithPercentPrice | SubscriptionsAPI.NewSubscriptionMatrixWithAllocationPrice | AddPrice.NewSubscriptionTieredWithProrationPrice | SubscriptionsAPI.NewSubscriptionUnitWithProrationPrice | SubscriptionsAPI.NewSubscriptionGroupedAllocationPrice | SubscriptionsAPI.NewSubscriptionBulkWithProrationPrice | SubscriptionsAPI.NewSubscriptionGroupedWithProratedMinimumPrice | SubscriptionsAPI.NewSubscriptionGroupedWithMeteredMinimumPrice | AddPrice.NewSubscriptionGroupedWithMinMaxThresholdsPrice | SubscriptionsAPI.NewSubscriptionMatrixWithDisplayNamePrice | SubscriptionsAPI.NewSubscriptionGroupedTieredPackagePrice | SubscriptionsAPI.NewSubscriptionMaxGroupTieredPackagePrice | SubscriptionsAPI.NewSubscriptionScalableMatrixWithUnitPricingPrice | SubscriptionsAPI.NewSubscriptionScalableMatrixWithTieredPricingPrice | SubscriptionsAPI.NewSubscriptionCumulativeGroupedBulkPrice | AddPrice.NewSubscriptionCumulativeGroupedAllocationPrice | SubscriptionsAPI.NewSubscriptionMinimumCompositePrice | AddPrice.NewSubscriptionPercentCompositePrice | AddPrice.NewSubscriptionEventOutputPrice | null;
+        price?: SubscriptionsAPI.NewSubscriptionUnitPrice | SubscriptionsAPI.NewSubscriptionTieredPrice | SubscriptionsAPI.NewSubscriptionBulkPrice | AddPrice.NewSubscriptionBulkWithFiltersPrice | SubscriptionsAPI.NewSubscriptionPackagePrice | SubscriptionsAPI.NewSubscriptionMatrixPrice | SubscriptionsAPI.NewSubscriptionThresholdTotalAmountPrice | SubscriptionsAPI.NewSubscriptionTieredPackagePrice | SubscriptionsAPI.NewSubscriptionTieredWithMinimumPrice | SubscriptionsAPI.NewSubscriptionGroupedTieredPrice | SubscriptionsAPI.NewSubscriptionTieredPackageWithMinimumPrice | SubscriptionsAPI.NewSubscriptionPackageWithAllocationPrice | SubscriptionsAPI.NewSubscriptionUnitWithPercentPrice | SubscriptionsAPI.NewSubscriptionMatrixWithAllocationPrice | AddPrice.NewSubscriptionMatrixWithThresholdDiscountsPrice | AddPrice.NewSubscriptionTieredWithProrationPrice | SubscriptionsAPI.NewSubscriptionUnitWithProrationPrice | SubscriptionsAPI.NewSubscriptionGroupedAllocationPrice | SubscriptionsAPI.NewSubscriptionBulkWithProrationPrice | SubscriptionsAPI.NewSubscriptionGroupedWithProratedMinimumPrice | SubscriptionsAPI.NewSubscriptionGroupedWithMeteredMinimumPrice | AddPrice.NewSubscriptionGroupedWithMinMaxThresholdsPrice | SubscriptionsAPI.NewSubscriptionMatrixWithDisplayNamePrice | SubscriptionsAPI.NewSubscriptionGroupedTieredPackagePrice | SubscriptionsAPI.NewSubscriptionMaxGroupTieredPackagePrice | SubscriptionsAPI.NewSubscriptionScalableMatrixWithUnitPricingPrice | SubscriptionsAPI.NewSubscriptionScalableMatrixWithTieredPricingPrice | SubscriptionsAPI.NewSubscriptionCumulativeGroupedBulkPrice | AddPrice.NewSubscriptionCumulativeGroupedAllocationPrice | AddPrice.NewSubscriptionDailyCreditAllowancePrice | AddPrice.NewSubscriptionMeteredAllowancePrice | SubscriptionsAPI.NewSubscriptionMinimumCompositePrice | AddPrice.NewSubscriptionPercentCompositePrice | AddPrice.NewSubscriptionEventOutputPrice | null;
         /**
          * The id of the price to add to the subscription.
          */
@@ -4249,6 +4539,145 @@ export declare namespace SubscriptionCreateParams {
                 }
             }
         }
+        interface NewSubscriptionMatrixWithThresholdDiscountsPrice {
+            /**
+             * The cadence to bill for this price on.
+             */
+            cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+            /**
+             * The id of the item the price will be associated with.
+             */
+            item_id: string;
+            /**
+             * Configuration for matrix_with_threshold_discounts pricing
+             */
+            matrix_with_threshold_discounts_config: NewSubscriptionMatrixWithThresholdDiscountsPrice.MatrixWithThresholdDiscountsConfig;
+            /**
+             * The pricing model type
+             */
+            model_type: 'matrix_with_threshold_discounts';
+            /**
+             * The name of the price.
+             */
+            name: string;
+            /**
+             * The id of the billable metric for the price. Only needed if the price is
+             * usage-based.
+             */
+            billable_metric_id?: string | null;
+            /**
+             * If the Price represents a fixed cost, the price will be billed in-advance if
+             * this is true, and in-arrears if this is false.
+             */
+            billed_in_advance?: boolean | null;
+            /**
+             * For custom cadence: specifies the duration of the billing period in days or
+             * months.
+             */
+            billing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+            /**
+             * The per unit conversion rate of the price currency to the invoicing currency.
+             */
+            conversion_rate?: number | null;
+            /**
+             * The configuration for the rate of the price currency to the invoicing currency.
+             */
+            conversion_rate_config?: Shared.UnitConversionRateConfig | Shared.TieredConversionRateConfig | null;
+            /**
+             * An ISO 4217 currency string, or custom pricing unit identifier, in which this
+             * price is billed.
+             */
+            currency?: string | null;
+            /**
+             * For dimensional price: specifies a price group and dimension values
+             */
+            dimensional_price_configuration?: Shared.NewDimensionalPriceConfiguration | null;
+            /**
+             * An alias for the price.
+             */
+            external_price_id?: string | null;
+            /**
+             * If the Price represents a fixed cost, this represents the quantity of units
+             * applied.
+             */
+            fixed_price_quantity?: number | null;
+            /**
+             * The property used to group this price on an invoice
+             */
+            invoice_grouping_key?: string | null;
+            /**
+             * Within each billing cycle, specifies the cadence at which invoices are produced.
+             * If unspecified, a single invoice is produced per billing cycle.
+             */
+            invoicing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+            /**
+             * The ID of the license type to associate with this price.
+             */
+            license_type_id?: string | null;
+            /**
+             * User-specified key/value pairs for the resource. Individual keys can be removed
+             * by setting the value to `null`, and the entire metadata mapping can be cleared
+             * by setting `metadata` to `null`.
+             */
+            metadata?: {
+                [key: string]: string | null;
+            } | null;
+            /**
+             * A transient ID that can be used to reference this price when adding adjustments
+             * in the same API call.
+             */
+            reference_id?: string | null;
+        }
+        namespace NewSubscriptionMatrixWithThresholdDiscountsPrice {
+            /**
+             * Configuration for matrix_with_threshold_discounts pricing
+             */
+            interface MatrixWithThresholdDiscountsConfig {
+                /**
+                 * Unit price used for usage that does not match any defined matrix cell.
+                 */
+                default_unit_amount: string;
+                /**
+                 * First matrix dimension key.
+                 */
+                first_dimension: string;
+                /**
+                 * Per-cell unit prices.
+                 */
+                matrix_values: Array<MatrixWithThresholdDiscountsConfig.MatrixValue>;
+                /**
+                 * Optional second matrix dimension key.
+                 */
+                second_dimension?: string | null;
+                threshold_discount_groups?: Array<MatrixWithThresholdDiscountsConfig.ThresholdDiscountGroup>;
+            }
+            namespace MatrixWithThresholdDiscountsConfig {
+                interface MatrixValue {
+                    first_dimension_value: string;
+                    unit_amount: string;
+                    second_dimension_value?: string | null;
+                }
+                interface ThresholdDiscountGroup {
+                    /**
+                     * Discount rate applied to spend above the threshold.
+                     */
+                    above_threshold_discount_percentage: string;
+                    /**
+                     * Discount rate applied to spend at or below the threshold. Set to 0 for no
+                     * baseline discount.
+                     */
+                    below_threshold_discount_percentage: string;
+                    /**
+                     * Semicolon-separated list of matrix cell coordinates targeted by this group. Each
+                     * coordinate is `first,second` when the matrix has two dimensions, or just `first`
+                     * for a single-dimension matrix. Example: `blue,circle;green,triangle`.
+                     */
+                    cell_coordinates: string;
+                    threshold_amount: string;
+                    description?: string | null;
+                }
+            }
+        }
         interface NewSubscriptionTieredWithProrationPrice {
             /**
              * The cadence to bill for this price on.
@@ -4589,11 +5018,15 @@ export declare namespace SubscriptionCreateParams {
                 unit_amount: string;
             }
         }
-        interface NewSubscriptionPercentCompositePrice {
+        interface NewSubscriptionDailyCreditAllowancePrice {
             /**
              * The cadence to bill for this price on.
              */
             cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+            /**
+             * Configuration for daily_credit_allowance pricing
+             */
+            daily_credit_allowance_config: NewSubscriptionDailyCreditAllowancePrice.DailyCreditAllowanceConfig;
             /**
              * The id of the item the price will be associated with.
              */
@@ -4601,15 +5034,11 @@ export declare namespace SubscriptionCreateParams {
             /**
              * The pricing model type
              */
-            model_type: 'percent';
+            model_type: 'daily_credit_allowance';
             /**
              * The name of the price.
              */
             name: string;
-            /**
-             * Configuration for percent pricing
-             */
-            percent_config: NewSubscriptionPercentCompositePrice.PercentConfig;
             /**
              * The id of the billable metric for the price. Only needed if the price is
              * usage-based.
@@ -4678,34 +5107,69 @@ export declare namespace SubscriptionCreateParams {
              */
             reference_id?: string | null;
         }
-        namespace NewSubscriptionPercentCompositePrice {
+        namespace NewSubscriptionDailyCreditAllowancePrice {
             /**
-             * Configuration for percent pricing
+             * Configuration for daily_credit_allowance pricing
              */
-            interface PercentConfig {
+            interface DailyCreditAllowanceConfig {
                 /**
-                 * What percent of the component subtotals to charge
+                 * Credits granted per day. Lose-it-or-use-it; does not roll over.
                  */
-                percent: number;
+                daily_allowance: string;
+                /**
+                 * Default per-unit credit rate for any usage not bucketed into a specified
+                 * matrix_value
+                 */
+                default_unit_amount: string;
+                /**
+                 * One or two event property values to evaluate matrix groups by
+                 */
+                dimensions: Array<string | null>;
+                /**
+                 * Event property whose value identifies the day bucket the event belongs to (e.g.
+                 * 'event_day' set to an ISO date string in the customer's timezone). The allowance
+                 * resets per distinct value of this property.
+                 */
+                event_day_property: string;
+                /**
+                 * Per-dimension credit rates
+                 */
+                matrix_values: Array<DailyCreditAllowanceConfig.MatrixValue>;
             }
-        }
-        interface NewSubscriptionEventOutputPrice {
-            /**
-             * The cadence to bill for this price on.
-             */
-            cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
-            /**
-             * Configuration for event_output pricing
+            namespace DailyCreditAllowanceConfig {
+                /**
+                 * Per-dimension credit price for the daily credit allowance model.
+                 */
+                interface MatrixValue {
+                    /**
+                     * One or two matrix keys to filter usage to this value by. For example, ["model"]
+                     * could be used to apply a different credit rate to each AI model.
+                     */
+                    dimension_values: Array<string | null>;
+                    /**
+                     * Credits charged per unit of usage matching the specified dimension_values
+                     */
+                    unit_amount: string;
+                }
+            }
+        }
+        interface NewSubscriptionMeteredAllowancePrice {
+            /**
+             * The cadence to bill for this price on.
              */
-            event_output_config: NewSubscriptionEventOutputPrice.EventOutputConfig;
+            cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
             /**
              * The id of the item the price will be associated with.
              */
             item_id: string;
+            /**
+             * Configuration for metered_allowance pricing
+             */
+            metered_allowance_config: NewSubscriptionMeteredAllowancePrice.MeteredAllowanceConfig;
             /**
              * The pricing model type
              */
-            model_type: 'event_output';
+            model_type: 'metered_allowance';
             /**
              * The name of the price.
              */
@@ -4778,109 +5242,43 @@ export declare namespace SubscriptionCreateParams {
              */
             reference_id?: string | null;
         }
-        namespace NewSubscriptionEventOutputPrice {
+        namespace NewSubscriptionMeteredAllowancePrice {
             /**
-             * Configuration for event_output pricing
+             * Configuration for metered_allowance pricing
              */
-            interface EventOutputConfig {
+            interface MeteredAllowanceConfig {
                 /**
-                 * The key in the event data to extract the unit rate from.
+                 * The grouping_key value whose summed quantity represents the allowance for this
+                 * period (e.g. 'storage_snapshot' emitting 3 × avg storage). Capped at consumption
+                 * — credit can never exceed actual usage.
                  */
-                unit_rating_key: string;
+                allowance_grouping_value: string;
                 /**
-                 * If provided, this amount will be used as the unit rate when an event does not
-                 * have a value for the `unit_rating_key`. If not provided, events missing a unit
-                 * rate will be ignored.
+                 * The grouping_key value whose summed quantity represents consumption (e.g.
+                 * 'download'). Charged at unit_amount.
                  */
-                default_unit_rate?: string | null;
+                consumption_grouping_value: string;
                 /**
-                 * An optional key in the event data to group by (e.g., event ID). All events will
-                 * also be grouped by their unit rate.
+                 * Event property used to partition the metric into consumption and allowance
+                 * quantities (e.g. 'event_name'). The metric is queried with this key and the two
+                 * values below select which partition is which.
                  */
-                grouping_key?: string | null;
+                grouping_key: string;
+                /**
+                 * Per-unit price applied to gross consumption and to the allowance credit.
+                 */
+                unit_amount: string;
+                /**
+                 * Sub-line label for the credit row (e.g. 'Up to 3x free egress').
+                 */
+                allowance_display_name?: string;
+                /**
+                 * Sub-line label for the gross consumption row (e.g. 'bytes gotten').
+                 */
+                consumption_display_name?: string;
             }
         }
-    }
-    interface RemoveAdjustment {
-        /**
-         * The id of the adjustment to remove on the subscription.
-         */
-        adjustment_id: string;
-    }
-    interface RemovePrice {
-        /**
-         * The external price id of the price to remove on the subscription.
-         */
-        external_price_id?: string | null;
-        /**
-         * The id of the price to remove on the subscription.
-         */
-        price_id?: string | null;
-    }
-    interface ReplaceAdjustment {
-        /**
-         * The definition of a new adjustment to create and add to the subscription.
-         */
-        adjustment: Shared.NewPercentageDiscount | Shared.NewUsageDiscount | Shared.NewAmountDiscount | Shared.NewMinimum | Shared.NewMaximum;
-        /**
-         * The id of the adjustment on the plan to replace in the subscription.
-         */
-        replaces_adjustment_id: string;
-    }
-    interface ReplacePrice {
-        /**
-         * The id of the price on the plan to replace in the subscription.
-         */
-        replaces_price_id: string;
-        /**
-         * The definition of a new allocation price to create and add to the subscription.
-         */
-        allocation_price?: Shared.NewAllocationPrice | null;
-        /**
-         * @deprecated [DEPRECATED] Use add_adjustments instead. The subscription's
-         * discounts for the replacement price.
-         */
-        discounts?: Array<SubscriptionsAPI.DiscountOverride> | null;
-        /**
-         * The external price id of the price to add to the subscription.
-         */
-        external_price_id?: string | null;
-        /**
-         * The new quantity of the price, if the price is a fixed price.
-         */
-        fixed_price_quantity?: number | null;
-        /**
-         * @deprecated [DEPRECATED] Use add_adjustments instead. The subscription's maximum
-         * amount for the replacement price.
-         */
-        maximum_amount?: string | null;
-        /**
-         * Override values for parameterized billable metric variables. Keys are parameter
-         * names, values are the override values.
-         */
-        metric_parameter_overrides?: {
-            [key: string]: unknown;
-        } | null;
-        /**
-         * @deprecated [DEPRECATED] Use add_adjustments instead. The subscription's minimum
-         * amount for the replacement price.
-         */
-        minimum_amount?: string | null;
-        /**
-         * New subscription price request body params.
-         */
-        price?: SubscriptionsAPI.NewSubscriptionUnitPrice | SubscriptionsAPI.NewSubscriptionTieredPrice | SubscriptionsAPI.NewSubscriptionBulkPrice | ReplacePrice.NewSubscriptionBulkWithFiltersPrice | SubscriptionsAPI.NewSubscriptionPackagePrice | SubscriptionsAPI.NewSubscriptionMatrixPrice | SubscriptionsAPI.NewSubscriptionThresholdTotalAmountPrice | SubscriptionsAPI.NewSubscriptionTieredPackagePrice | SubscriptionsAPI.NewSubscriptionTieredWithMinimumPrice | SubscriptionsAPI.NewSubscriptionGroupedTieredPrice | SubscriptionsAPI.NewSubscriptionTieredPackageWithMinimumPrice | SubscriptionsAPI.NewSubscriptionPackageWithAllocationPrice | SubscriptionsAPI.NewSubscriptionUnitWithPercentPrice | SubscriptionsAPI.NewSubscriptionMatrixWithAllocationPrice | ReplacePrice.NewSubscriptionTieredWithProrationPrice | SubscriptionsAPI.NewSubscriptionUnitWithProrationPrice | SubscriptionsAPI.NewSubscriptionGroupedAllocationPrice | SubscriptionsAPI.NewSubscriptionBulkWithProrationPrice | SubscriptionsAPI.NewSubscriptionGroupedWithProratedMinimumPrice | SubscriptionsAPI.NewSubscriptionGroupedWithMeteredMinimumPrice | ReplacePrice.NewSubscriptionGroupedWithMinMaxThresholdsPrice | SubscriptionsAPI.NewSubscriptionMatrixWithDisplayNamePrice | SubscriptionsAPI.NewSubscriptionGroupedTieredPackagePrice | SubscriptionsAPI.NewSubscriptionMaxGroupTieredPackagePrice | SubscriptionsAPI.NewSubscriptionScalableMatrixWithUnitPricingPrice | SubscriptionsAPI.NewSubscriptionScalableMatrixWithTieredPricingPrice | SubscriptionsAPI.NewSubscriptionCumulativeGroupedBulkPrice | ReplacePrice.NewSubscriptionCumulativeGroupedAllocationPrice | SubscriptionsAPI.NewSubscriptionMinimumCompositePrice | ReplacePrice.NewSubscriptionPercentCompositePrice | ReplacePrice.NewSubscriptionEventOutputPrice | null;
-        /**
-         * The id of the price to add to the subscription.
-         */
-        price_id?: string | null;
-    }
-    namespace ReplacePrice {
-        interface NewSubscriptionBulkWithFiltersPrice {
-            /**
-             * Configuration for bulk_with_filters pricing
-             */
-            bulk_with_filters_config: NewSubscriptionBulkWithFiltersPrice.BulkWithFiltersConfig;
+        interface NewSubscriptionPercentCompositePrice {
             /**
              * The cadence to bill for this price on.
              */
@@ -4892,11 +5290,15 @@ export declare namespace SubscriptionCreateParams {
             /**
              * The pricing model type
              */
-            model_type: 'bulk_with_filters';
+            model_type: 'percent';
             /**
              * The name of the price.
              */
             name: string;
+            /**
+             * Configuration for percent pricing
+             */
+            percent_config: NewSubscriptionPercentCompositePrice.PercentConfig;
             /**
              * The id of the billable metric for the price. Only needed if the price is
              * usage-based.
@@ -4965,54 +5367,40 @@ export declare namespace SubscriptionCreateParams {
              */
             reference_id?: string | null;
         }
-        namespace NewSubscriptionBulkWithFiltersPrice {
+        namespace NewSubscriptionPercentCompositePrice {
             /**
-             * Configuration for bulk_with_filters pricing
+             * Configuration for percent pricing
              */
-            interface BulkWithFiltersConfig {
+            interface PercentConfig {
                 /**
-                 * Property filters to apply (all must match)
+                 * Fraction of the component subtotals to charge (0 < percent <= 1).
                  */
-                filters: Array<BulkWithFiltersConfig.Filter>;
+                percent: number;
                 /**
-                 * Bulk tiers for rating based on total usage volume
+                 * Maximum amount to charge. If unset, the fee has no upper bound.
                  */
-                tiers: Array<BulkWithFiltersConfig.Tier>;
-            }
-            namespace BulkWithFiltersConfig {
+                maximum_amount?: string | null;
                 /**
-                 * Configuration for a single property filter
+                 * Minimum amount to charge. If unset, the fee is bounded below by 0.
                  */
-                interface Filter {
-                    /**
-                     * Event property key to filter on
-                     */
-                    property_key: string;
-                    /**
-                     * Event property value to match
-                     */
-                    property_value: string;
-                }
+                minimum_amount?: string | null;
                 /**
-                 * Configuration for a single bulk pricing tier
+                 * If true, the minimum_amount is prorated based on the service period. The
+                 * maximum_amount is an absolute cap (never prorated), and the percent applied to
+                 * upstream subtotals is never prorated either.
                  */
-                interface Tier {
-                    /**
-                     * Amount per unit
-                     */
-                    unit_amount: string;
-                    /**
-                     * The lower bound for this tier
-                     */
-                    tier_lower_bound?: string | null;
-                }
+                prorated?: boolean;
             }
         }
-        interface NewSubscriptionTieredWithProrationPrice {
+        interface NewSubscriptionEventOutputPrice {
             /**
              * The cadence to bill for this price on.
              */
             cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+            /**
+             * Configuration for event_output pricing
+             */
+            event_output_config: NewSubscriptionEventOutputPrice.EventOutputConfig;
             /**
              * The id of the item the price will be associated with.
              */
@@ -5020,15 +5408,11 @@ export declare namespace SubscriptionCreateParams {
             /**
              * The pricing model type
              */
-            model_type: 'tiered_with_proration';
+            model_type: 'event_output';
             /**
              * The name of the price.
              */
             name: string;
-            /**
-             * Configuration for tiered_with_proration pricing
-             */
-            tiered_with_proration_config: NewSubscriptionTieredWithProrationPrice.TieredWithProrationConfig;
             /**
              * The id of the billable metric for the price. Only needed if the price is
              * usage-based.
@@ -5097,73 +5481,209 @@ export declare namespace SubscriptionCreateParams {
              */
             reference_id?: string | null;
         }
-        namespace NewSubscriptionTieredWithProrationPrice {
+        namespace NewSubscriptionEventOutputPrice {
             /**
-             * Configuration for tiered_with_proration pricing
+             * Configuration for event_output pricing
              */
-            interface TieredWithProrationConfig {
+            interface EventOutputConfig {
                 /**
-                 * Tiers for rating based on total usage quantities into the specified tier with
-                 * proration
+                 * The key in the event data to extract the unit rate from.
                  */
-                tiers: Array<TieredWithProrationConfig.Tier>;
-            }
-            namespace TieredWithProrationConfig {
+                unit_rating_key: string;
                 /**
-                 * Configuration for a single tiered with proration tier
+                 * If provided, this amount will be used as the unit rate when an event does not
+                 * have a value for the `unit_rating_key`. If not provided, events missing a unit
+                 * rate will be ignored.
                  */
-                interface Tier {
-                    /**
-                     * Inclusive tier starting value
-                     */
-                    tier_lower_bound: string;
-                    /**
-                     * Amount per unit
-                     */
-                    unit_amount: string;
-                }
+                default_unit_rate?: string | null;
+                /**
+                 * An optional key in the event data to group by (e.g., event ID). All events will
+                 * also be grouped by their unit rate.
+                 */
+                grouping_key?: string | null;
             }
         }
-        interface NewSubscriptionGroupedWithMinMaxThresholdsPrice {
-            /**
-             * The cadence to bill for this price on.
-             */
-            cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
-            /**
-             * Configuration for grouped_with_min_max_thresholds pricing
-             */
-            grouped_with_min_max_thresholds_config: NewSubscriptionGroupedWithMinMaxThresholdsPrice.GroupedWithMinMaxThresholdsConfig;
+    }
+    interface RemoveAdjustment {
+        /**
+         * The id of the adjustment to remove on the subscription.
+         */
+        adjustment_id: string;
+    }
+    interface RemovePrice {
+        /**
+         * The external price id of the price to remove on the subscription.
+         */
+        external_price_id?: string | null;
+        /**
+         * The id of the price to remove on the subscription.
+         */
+        price_id?: string | null;
+    }
+    interface ReplaceAdjustment {
+        /**
+         * The definition of a new adjustment to create and add to the subscription.
+         */
+        adjustment: Shared.NewPercentageDiscount | Shared.NewUsageDiscount | Shared.NewAmountDiscount | Shared.NewMinimum | Shared.NewMaximum | ReplaceAdjustment.NewTieredPercentageDiscount;
+        /**
+         * The id of the adjustment on the plan to replace in the subscription.
+         */
+        replaces_adjustment_id: string;
+    }
+    namespace ReplaceAdjustment {
+        interface NewTieredPercentageDiscount {
+            adjustment_type: 'tiered_percentage_discount';
+            tiers: Array<NewTieredPercentageDiscount.Tier>;
             /**
-             * The id of the item the price will be associated with.
+             * If set, the adjustment will apply to every price on the subscription.
              */
-            item_id: string;
+            applies_to_all?: true | null;
             /**
-             * The pricing model type
+             * The set of item IDs to which this adjustment applies.
              */
-            model_type: 'grouped_with_min_max_thresholds';
+            applies_to_item_ids?: Array<string> | null;
             /**
-             * The name of the price.
+             * The set of price IDs to which this adjustment applies.
              */
-            name: string;
+            applies_to_price_ids?: Array<string> | null;
             /**
-             * The id of the billable metric for the price. Only needed if the price is
-             * usage-based.
+             * If set, only prices in the specified currency will have the adjustment applied.
              */
-            billable_metric_id?: string | null;
+            currency?: string | null;
             /**
-             * If the Price represents a fixed cost, the price will be billed in-advance if
-             * this is true, and in-arrears if this is false.
+             * A list of filters that determine which prices this adjustment will apply to.
              */
-            billed_in_advance?: boolean | null;
+            filters?: Array<NewTieredPercentageDiscount.Filter> | null;
             /**
-             * For custom cadence: specifies the duration of the billing period in days or
-             * months.
+             * When false, this adjustment will be applied to a single price. Otherwise, it
+             * will be applied at the invoice level, possibly to multiple prices.
              */
-            billing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+            is_invoice_level?: boolean;
             /**
-             * The per unit conversion rate of the price currency to the invoicing currency.
+             * If set, only prices of the specified type will have the adjustment applied.
              */
-            conversion_rate?: number | null;
+            price_type?: 'usage' | 'fixed_in_advance' | 'fixed_in_arrears' | 'fixed' | 'in_arrears' | null;
+        }
+        namespace NewTieredPercentageDiscount {
+            interface Tier {
+                /**
+                 * Exclusive lower bound of cumulative spend for this tier.
+                 */
+                lower_bound: number;
+                /**
+                 * The percentage (0-1) discounted from spend in this tier.
+                 */
+                percentage: number;
+                /**
+                 * Inclusive upper bound of cumulative spend; null for the final open-ended tier.
+                 */
+                upper_bound?: number | null;
+            }
+            interface Filter {
+                /**
+                 * The property of the price to filter on.
+                 */
+                field: 'price_id' | 'item_id' | 'price_type' | 'currency' | 'pricing_unit_id';
+                /**
+                 * Should prices that match the filter be included or excluded.
+                 */
+                operator: 'includes' | 'excludes';
+                /**
+                 * The IDs or values that match this filter.
+                 */
+                values: Array<string>;
+            }
+        }
+    }
+    interface ReplacePrice {
+        /**
+         * The id of the price on the plan to replace in the subscription.
+         */
+        replaces_price_id: string;
+        /**
+         * The definition of a new allocation price to create and add to the subscription.
+         */
+        allocation_price?: Shared.NewAllocationPrice | null;
+        /**
+         * @deprecated [DEPRECATED] Use add_adjustments instead. The subscription's
+         * discounts for the replacement price.
+         */
+        discounts?: Array<SubscriptionsAPI.DiscountOverride> | null;
+        /**
+         * The external price id of the price to add to the subscription.
+         */
+        external_price_id?: string | null;
+        /**
+         * The new quantity of the price, if the price is a fixed price.
+         */
+        fixed_price_quantity?: number | null;
+        /**
+         * @deprecated [DEPRECATED] Use add_adjustments instead. The subscription's maximum
+         * amount for the replacement price.
+         */
+        maximum_amount?: string | null;
+        /**
+         * Override values for parameterized billable metric variables. Keys are parameter
+         * names, values are the override values.
+         */
+        metric_parameter_overrides?: {
+            [key: string]: unknown;
+        } | null;
+        /**
+         * @deprecated [DEPRECATED] Use add_adjustments instead. The subscription's minimum
+         * amount for the replacement price.
+         */
+        minimum_amount?: string | null;
+        /**
+         * New subscription price request body params.
+         */
+        price?: SubscriptionsAPI.NewSubscriptionUnitPrice | SubscriptionsAPI.NewSubscriptionTieredPrice | SubscriptionsAPI.NewSubscriptionBulkPrice | ReplacePrice.NewSubscriptionBulkWithFiltersPrice | SubscriptionsAPI.NewSubscriptionPackagePrice | SubscriptionsAPI.NewSubscriptionMatrixPrice | SubscriptionsAPI.NewSubscriptionThresholdTotalAmountPrice | SubscriptionsAPI.NewSubscriptionTieredPackagePrice | SubscriptionsAPI.NewSubscriptionTieredWithMinimumPrice | SubscriptionsAPI.NewSubscriptionGroupedTieredPrice | SubscriptionsAPI.NewSubscriptionTieredPackageWithMinimumPrice | SubscriptionsAPI.NewSubscriptionPackageWithAllocationPrice | SubscriptionsAPI.NewSubscriptionUnitWithPercentPrice | SubscriptionsAPI.NewSubscriptionMatrixWithAllocationPrice | ReplacePrice.NewSubscriptionMatrixWithThresholdDiscountsPrice | ReplacePrice.NewSubscriptionTieredWithProrationPrice | SubscriptionsAPI.NewSubscriptionUnitWithProrationPrice | SubscriptionsAPI.NewSubscriptionGroupedAllocationPrice | SubscriptionsAPI.NewSubscriptionBulkWithProrationPrice | SubscriptionsAPI.NewSubscriptionGroupedWithProratedMinimumPrice | SubscriptionsAPI.NewSubscriptionGroupedWithMeteredMinimumPrice | ReplacePrice.NewSubscriptionGroupedWithMinMaxThresholdsPrice | SubscriptionsAPI.NewSubscriptionMatrixWithDisplayNamePrice | SubscriptionsAPI.NewSubscriptionGroupedTieredPackagePrice | SubscriptionsAPI.NewSubscriptionMaxGroupTieredPackagePrice | SubscriptionsAPI.NewSubscriptionScalableMatrixWithUnitPricingPrice | SubscriptionsAPI.NewSubscriptionScalableMatrixWithTieredPricingPrice | SubscriptionsAPI.NewSubscriptionCumulativeGroupedBulkPrice | ReplacePrice.NewSubscriptionCumulativeGroupedAllocationPrice | ReplacePrice.NewSubscriptionDailyCreditAllowancePrice | ReplacePrice.NewSubscriptionMeteredAllowancePrice | SubscriptionsAPI.NewSubscriptionMinimumCompositePrice | ReplacePrice.NewSubscriptionPercentCompositePrice | ReplacePrice.NewSubscriptionEventOutputPrice | null;
+        /**
+         * The id of the price to add to the subscription.
+         */
+        price_id?: string | null;
+    }
+    namespace ReplacePrice {
+        interface NewSubscriptionBulkWithFiltersPrice {
+            /**
+             * Configuration for bulk_with_filters pricing
+             */
+            bulk_with_filters_config: NewSubscriptionBulkWithFiltersPrice.BulkWithFiltersConfig;
+            /**
+             * The cadence to bill for this price on.
+             */
+            cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+            /**
+             * The id of the item the price will be associated with.
+             */
+            item_id: string;
+            /**
+             * The pricing model type
+             */
+            model_type: 'bulk_with_filters';
+            /**
+             * The name of the price.
+             */
+            name: string;
+            /**
+             * The id of the billable metric for the price. Only needed if the price is
+             * usage-based.
+             */
+            billable_metric_id?: string | null;
+            /**
+             * If the Price represents a fixed cost, the price will be billed in-advance if
+             * this is true, and in-arrears if this is false.
+             */
+            billed_in_advance?: boolean | null;
+            /**
+             * For custom cadence: specifies the duration of the billing period in days or
+             * months.
+             */
+            billing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+            /**
+             * The per unit conversion rate of the price currency to the invoicing currency.
+             */
+            conversion_rate?: number | null;
             /**
              * The configuration for the rate of the price currency to the invoicing currency.
              */
@@ -5213,46 +5733,66 @@ export declare namespace SubscriptionCreateParams {
              */
             reference_id?: string | null;
         }
-        namespace NewSubscriptionGroupedWithMinMaxThresholdsPrice {
+        namespace NewSubscriptionBulkWithFiltersPrice {
             /**
-             * Configuration for grouped_with_min_max_thresholds pricing
+             * Configuration for bulk_with_filters pricing
              */
-            interface GroupedWithMinMaxThresholdsConfig {
+            interface BulkWithFiltersConfig {
                 /**
-                 * The event property used to group before applying thresholds
+                 * Property filters to apply (all must match)
                  */
-                grouping_key: string;
+                filters: Array<BulkWithFiltersConfig.Filter>;
                 /**
-                 * The maximum amount to charge each group
+                 * Bulk tiers for rating based on total usage volume
                  */
-                maximum_charge: string;
+                tiers: Array<BulkWithFiltersConfig.Tier>;
+            }
+            namespace BulkWithFiltersConfig {
                 /**
-                 * The minimum amount to charge each group, regardless of usage
+                 * Configuration for a single property filter
                  */
-                minimum_charge: string;
+                interface Filter {
+                    /**
+                     * Event property key to filter on
+                     */
+                    property_key: string;
+                    /**
+                     * Event property value to match
+                     */
+                    property_value: string;
+                }
                 /**
-                 * The base price charged per group
+                 * Configuration for a single bulk pricing tier
                  */
-                per_unit_rate: string;
+                interface Tier {
+                    /**
+                     * Amount per unit
+                     */
+                    unit_amount: string;
+                    /**
+                     * The lower bound for this tier
+                     */
+                    tier_lower_bound?: string | null;
+                }
             }
         }
-        interface NewSubscriptionCumulativeGroupedAllocationPrice {
+        interface NewSubscriptionMatrixWithThresholdDiscountsPrice {
             /**
              * The cadence to bill for this price on.
              */
             cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
-            /**
-             * Configuration for cumulative_grouped_allocation pricing
-             */
-            cumulative_grouped_allocation_config: NewSubscriptionCumulativeGroupedAllocationPrice.CumulativeGroupedAllocationConfig;
             /**
              * The id of the item the price will be associated with.
              */
             item_id: string;
+            /**
+             * Configuration for matrix_with_threshold_discounts pricing
+             */
+            matrix_with_threshold_discounts_config: NewSubscriptionMatrixWithThresholdDiscountsPrice.MatrixWithThresholdDiscountsConfig;
             /**
              * The pricing model type
              */
-            model_type: 'cumulative_grouped_allocation';
+            model_type: 'matrix_with_threshold_discounts';
             /**
              * The name of the price.
              */
@@ -5325,30 +5865,57 @@ export declare namespace SubscriptionCreateParams {
              */
             reference_id?: string | null;
         }
-        namespace NewSubscriptionCumulativeGroupedAllocationPrice {
+        namespace NewSubscriptionMatrixWithThresholdDiscountsPrice {
             /**
-             * Configuration for cumulative_grouped_allocation pricing
+             * Configuration for matrix_with_threshold_discounts pricing
              */
-            interface CumulativeGroupedAllocationConfig {
+            interface MatrixWithThresholdDiscountsConfig {
                 /**
-                 * The overall allocation across all groups
+                 * Unit price used for usage that does not match any defined matrix cell.
                  */
-                cumulative_allocation: string;
+                default_unit_amount: string;
                 /**
-                 * The allocation per individual group
+                 * First matrix dimension key.
                  */
-                group_allocation: string;
+                first_dimension: string;
                 /**
-                 * The event property used to group usage before applying allocations
+                 * Per-cell unit prices.
                  */
-                grouping_key: string;
+                matrix_values: Array<MatrixWithThresholdDiscountsConfig.MatrixValue>;
                 /**
-                 * The amount to charge for each unit outside of the allocation
+                 * Optional second matrix dimension key.
                  */
-                unit_amount: string;
+                second_dimension?: string | null;
+                threshold_discount_groups?: Array<MatrixWithThresholdDiscountsConfig.ThresholdDiscountGroup>;
+            }
+            namespace MatrixWithThresholdDiscountsConfig {
+                interface MatrixValue {
+                    first_dimension_value: string;
+                    unit_amount: string;
+                    second_dimension_value?: string | null;
+                }
+                interface ThresholdDiscountGroup {
+                    /**
+                     * Discount rate applied to spend above the threshold.
+                     */
+                    above_threshold_discount_percentage: string;
+                    /**
+                     * Discount rate applied to spend at or below the threshold. Set to 0 for no
+                     * baseline discount.
+                     */
+                    below_threshold_discount_percentage: string;
+                    /**
+                     * Semicolon-separated list of matrix cell coordinates targeted by this group. Each
+                     * coordinate is `first,second` when the matrix has two dimensions, or just `first`
+                     * for a single-dimension matrix. Example: `blue,circle;green,triangle`.
+                     */
+                    cell_coordinates: string;
+                    threshold_amount: string;
+                    description?: string | null;
+                }
             }
         }
-        interface NewSubscriptionPercentCompositePrice {
+        interface NewSubscriptionTieredWithProrationPrice {
             /**
              * The cadence to bill for this price on.
              */
@@ -5360,15 +5927,15 @@ export declare namespace SubscriptionCreateParams {
             /**
              * The pricing model type
              */
-            model_type: 'percent';
+            model_type: 'tiered_with_proration';
             /**
              * The name of the price.
              */
             name: string;
             /**
-             * Configuration for percent pricing
+             * Configuration for tiered_with_proration pricing
              */
-            percent_config: NewSubscriptionPercentCompositePrice.PercentConfig;
+            tiered_with_proration_config: NewSubscriptionTieredWithProrationPrice.TieredWithProrationConfig;
             /**
              * The id of the billable metric for the price. Only needed if the price is
              * usage-based.
@@ -5437,26 +6004,42 @@ export declare namespace SubscriptionCreateParams {
              */
             reference_id?: string | null;
         }
-        namespace NewSubscriptionPercentCompositePrice {
+        namespace NewSubscriptionTieredWithProrationPrice {
             /**
-             * Configuration for percent pricing
+             * Configuration for tiered_with_proration pricing
              */
-            interface PercentConfig {
+            interface TieredWithProrationConfig {
+                /**
+                 * Tiers for rating based on total usage quantities into the specified tier with
+                 * proration
+                 */
+                tiers: Array<TieredWithProrationConfig.Tier>;
+            }
+            namespace TieredWithProrationConfig {
                 /**
-                 * What percent of the component subtotals to charge
+                 * Configuration for a single tiered with proration tier
                  */
-                percent: number;
+                interface Tier {
+                    /**
+                     * Inclusive tier starting value
+                     */
+                    tier_lower_bound: string;
+                    /**
+                     * Amount per unit
+                     */
+                    unit_amount: string;
+                }
             }
         }
-        interface NewSubscriptionEventOutputPrice {
+        interface NewSubscriptionGroupedWithMinMaxThresholdsPrice {
             /**
              * The cadence to bill for this price on.
              */
             cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
             /**
-             * Configuration for event_output pricing
+             * Configuration for grouped_with_min_max_thresholds pricing
              */
-            event_output_config: NewSubscriptionEventOutputPrice.EventOutputConfig;
+            grouped_with_min_max_thresholds_config: NewSubscriptionGroupedWithMinMaxThresholdsPrice.GroupedWithMinMaxThresholdsConfig;
             /**
              * The id of the item the price will be associated with.
              */
@@ -5464,7 +6047,7 @@ export declare namespace SubscriptionCreateParams {
             /**
              * The pricing model type
              */
-            model_type: 'event_output';
+            model_type: 'grouped_with_min_max_thresholds';
             /**
              * The name of the price.
              */
@@ -5537,42 +6120,647 @@ export declare namespace SubscriptionCreateParams {
              */
             reference_id?: string | null;
         }
-        namespace NewSubscriptionEventOutputPrice {
+        namespace NewSubscriptionGroupedWithMinMaxThresholdsPrice {
             /**
-             * Configuration for event_output pricing
+             * Configuration for grouped_with_min_max_thresholds pricing
              */
-            interface EventOutputConfig {
+            interface GroupedWithMinMaxThresholdsConfig {
                 /**
-                 * The key in the event data to extract the unit rate from.
+                 * The event property used to group before applying thresholds
                  */
-                unit_rating_key: string;
+                grouping_key: string;
                 /**
-                 * If provided, this amount will be used as the unit rate when an event does not
-                 * have a value for the `unit_rating_key`. If not provided, events missing a unit
-                 * rate will be ignored.
+                 * The maximum amount to charge each group
                  */
-                default_unit_rate?: string | null;
+                maximum_charge: string;
                 /**
-                 * An optional key in the event data to group by (e.g., event ID). All events will
-                 * also be grouped by their unit rate.
+                 * The minimum amount to charge each group, regardless of usage
                  */
-                grouping_key?: string | null;
+                minimum_charge: string;
+                /**
+                 * The base price charged per group
+                 */
+                per_unit_rate: string;
             }
         }
-    }
-}
-export interface SubscriptionUpdateParams {
-    /**
-     * Determines whether issued invoices for this subscription will automatically be
-     * charged with the saved payment method on the due date. This property defaults to
-     * the plan's behavior.
-     */
-    auto_collection?: boolean | null;
-    /**
-     * Determines the default memo on this subscription's invoices. Note that if this
-     * is not provided, it is determined by the plan configuration.
-     */
-    default_invoice_memo?: string | null;
+        interface NewSubscriptionCumulativeGroupedAllocationPrice {
+            /**
+             * The cadence to bill for this price on.
+             */
+            cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+            /**
+             * Configuration for cumulative_grouped_allocation pricing
+             */
+            cumulative_grouped_allocation_config: NewSubscriptionCumulativeGroupedAllocationPrice.CumulativeGroupedAllocationConfig;
+            /**
+             * The id of the item the price will be associated with.
+             */
+            item_id: string;
+            /**
+             * The pricing model type
+             */
+            model_type: 'cumulative_grouped_allocation';
+            /**
+             * The name of the price.
+             */
+            name: string;
+            /**
+             * The id of the billable metric for the price. Only needed if the price is
+             * usage-based.
+             */
+            billable_metric_id?: string | null;
+            /**
+             * If the Price represents a fixed cost, the price will be billed in-advance if
+             * this is true, and in-arrears if this is false.
+             */
+            billed_in_advance?: boolean | null;
+            /**
+             * For custom cadence: specifies the duration of the billing period in days or
+             * months.
+             */
+            billing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+            /**
+             * The per unit conversion rate of the price currency to the invoicing currency.
+             */
+            conversion_rate?: number | null;
+            /**
+             * The configuration for the rate of the price currency to the invoicing currency.
+             */
+            conversion_rate_config?: Shared.UnitConversionRateConfig | Shared.TieredConversionRateConfig | null;
+            /**
+             * An ISO 4217 currency string, or custom pricing unit identifier, in which this
+             * price is billed.
+             */
+            currency?: string | null;
+            /**
+             * For dimensional price: specifies a price group and dimension values
+             */
+            dimensional_price_configuration?: Shared.NewDimensionalPriceConfiguration | null;
+            /**
+             * An alias for the price.
+             */
+            external_price_id?: string | null;
+            /**
+             * If the Price represents a fixed cost, this represents the quantity of units
+             * applied.
+             */
+            fixed_price_quantity?: number | null;
+            /**
+             * The property used to group this price on an invoice
+             */
+            invoice_grouping_key?: string | null;
+            /**
+             * Within each billing cycle, specifies the cadence at which invoices are produced.
+             * If unspecified, a single invoice is produced per billing cycle.
+             */
+            invoicing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+            /**
+             * The ID of the license type to associate with this price.
+             */
+            license_type_id?: string | null;
+            /**
+             * User-specified key/value pairs for the resource. Individual keys can be removed
+             * by setting the value to `null`, and the entire metadata mapping can be cleared
+             * by setting `metadata` to `null`.
+             */
+            metadata?: {
+                [key: string]: string | null;
+            } | null;
+            /**
+             * A transient ID that can be used to reference this price when adding adjustments
+             * in the same API call.
+             */
+            reference_id?: string | null;
+        }
+        namespace NewSubscriptionCumulativeGroupedAllocationPrice {
+            /**
+             * Configuration for cumulative_grouped_allocation pricing
+             */
+            interface CumulativeGroupedAllocationConfig {
+                /**
+                 * The overall allocation across all groups
+                 */
+                cumulative_allocation: string;
+                /**
+                 * The allocation per individual group
+                 */
+                group_allocation: string;
+                /**
+                 * The event property used to group usage before applying allocations
+                 */
+                grouping_key: string;
+                /**
+                 * The amount to charge for each unit outside of the allocation
+                 */
+                unit_amount: string;
+            }
+        }
+        interface NewSubscriptionDailyCreditAllowancePrice {
+            /**
+             * The cadence to bill for this price on.
+             */
+            cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+            /**
+             * Configuration for daily_credit_allowance pricing
+             */
+            daily_credit_allowance_config: NewSubscriptionDailyCreditAllowancePrice.DailyCreditAllowanceConfig;
+            /**
+             * The id of the item the price will be associated with.
+             */
+            item_id: string;
+            /**
+             * The pricing model type
+             */
+            model_type: 'daily_credit_allowance';
+            /**
+             * The name of the price.
+             */
+            name: string;
+            /**
+             * The id of the billable metric for the price. Only needed if the price is
+             * usage-based.
+             */
+            billable_metric_id?: string | null;
+            /**
+             * If the Price represents a fixed cost, the price will be billed in-advance if
+             * this is true, and in-arrears if this is false.
+             */
+            billed_in_advance?: boolean | null;
+            /**
+             * For custom cadence: specifies the duration of the billing period in days or
+             * months.
+             */
+            billing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+            /**
+             * The per unit conversion rate of the price currency to the invoicing currency.
+             */
+            conversion_rate?: number | null;
+            /**
+             * The configuration for the rate of the price currency to the invoicing currency.
+             */
+            conversion_rate_config?: Shared.UnitConversionRateConfig | Shared.TieredConversionRateConfig | null;
+            /**
+             * An ISO 4217 currency string, or custom pricing unit identifier, in which this
+             * price is billed.
+             */
+            currency?: string | null;
+            /**
+             * For dimensional price: specifies a price group and dimension values
+             */
+            dimensional_price_configuration?: Shared.NewDimensionalPriceConfiguration | null;
+            /**
+             * An alias for the price.
+             */
+            external_price_id?: string | null;
+            /**
+             * If the Price represents a fixed cost, this represents the quantity of units
+             * applied.
+             */
+            fixed_price_quantity?: number | null;
+            /**
+             * The property used to group this price on an invoice
+             */
+            invoice_grouping_key?: string | null;
+            /**
+             * Within each billing cycle, specifies the cadence at which invoices are produced.
+             * If unspecified, a single invoice is produced per billing cycle.
+             */
+            invoicing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+            /**
+             * The ID of the license type to associate with this price.
+             */
+            license_type_id?: string | null;
+            /**
+             * User-specified key/value pairs for the resource. Individual keys can be removed
+             * by setting the value to `null`, and the entire metadata mapping can be cleared
+             * by setting `metadata` to `null`.
+             */
+            metadata?: {
+                [key: string]: string | null;
+            } | null;
+            /**
+             * A transient ID that can be used to reference this price when adding adjustments
+             * in the same API call.
+             */
+            reference_id?: string | null;
+        }
+        namespace NewSubscriptionDailyCreditAllowancePrice {
+            /**
+             * Configuration for daily_credit_allowance pricing
+             */
+            interface DailyCreditAllowanceConfig {
+                /**
+                 * Credits granted per day. Lose-it-or-use-it; does not roll over.
+                 */
+                daily_allowance: string;
+                /**
+                 * Default per-unit credit rate for any usage not bucketed into a specified
+                 * matrix_value
+                 */
+                default_unit_amount: string;
+                /**
+                 * One or two event property values to evaluate matrix groups by
+                 */
+                dimensions: Array<string | null>;
+                /**
+                 * Event property whose value identifies the day bucket the event belongs to (e.g.
+                 * 'event_day' set to an ISO date string in the customer's timezone). The allowance
+                 * resets per distinct value of this property.
+                 */
+                event_day_property: string;
+                /**
+                 * Per-dimension credit rates
+                 */
+                matrix_values: Array<DailyCreditAllowanceConfig.MatrixValue>;
+            }
+            namespace DailyCreditAllowanceConfig {
+                /**
+                 * Per-dimension credit price for the daily credit allowance model.
+                 */
+                interface MatrixValue {
+                    /**
+                     * One or two matrix keys to filter usage to this value by. For example, ["model"]
+                     * could be used to apply a different credit rate to each AI model.
+                     */
+                    dimension_values: Array<string | null>;
+                    /**
+                     * Credits charged per unit of usage matching the specified dimension_values
+                     */
+                    unit_amount: string;
+                }
+            }
+        }
+        interface NewSubscriptionMeteredAllowancePrice {
+            /**
+             * The cadence to bill for this price on.
+             */
+            cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+            /**
+             * The id of the item the price will be associated with.
+             */
+            item_id: string;
+            /**
+             * Configuration for metered_allowance pricing
+             */
+            metered_allowance_config: NewSubscriptionMeteredAllowancePrice.MeteredAllowanceConfig;
+            /**
+             * The pricing model type
+             */
+            model_type: 'metered_allowance';
+            /**
+             * The name of the price.
+             */
+            name: string;
+            /**
+             * The id of the billable metric for the price. Only needed if the price is
+             * usage-based.
+             */
+            billable_metric_id?: string | null;
+            /**
+             * If the Price represents a fixed cost, the price will be billed in-advance if
+             * this is true, and in-arrears if this is false.
+             */
+            billed_in_advance?: boolean | null;
+            /**
+             * For custom cadence: specifies the duration of the billing period in days or
+             * months.
+             */
+            billing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+            /**
+             * The per unit conversion rate of the price currency to the invoicing currency.
+             */
+            conversion_rate?: number | null;
+            /**
+             * The configuration for the rate of the price currency to the invoicing currency.
+             */
+            conversion_rate_config?: Shared.UnitConversionRateConfig | Shared.TieredConversionRateConfig | null;
+            /**
+             * An ISO 4217 currency string, or custom pricing unit identifier, in which this
+             * price is billed.
+             */
+            currency?: string | null;
+            /**
+             * For dimensional price: specifies a price group and dimension values
+             */
+            dimensional_price_configuration?: Shared.NewDimensionalPriceConfiguration | null;
+            /**
+             * An alias for the price.
+             */
+            external_price_id?: string | null;
+            /**
+             * If the Price represents a fixed cost, this represents the quantity of units
+             * applied.
+             */
+            fixed_price_quantity?: number | null;
+            /**
+             * The property used to group this price on an invoice
+             */
+            invoice_grouping_key?: string | null;
+            /**
+             * Within each billing cycle, specifies the cadence at which invoices are produced.
+             * If unspecified, a single invoice is produced per billing cycle.
+             */
+            invoicing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+            /**
+             * The ID of the license type to associate with this price.
+             */
+            license_type_id?: string | null;
+            /**
+             * User-specified key/value pairs for the resource. Individual keys can be removed
+             * by setting the value to `null`, and the entire metadata mapping can be cleared
+             * by setting `metadata` to `null`.
+             */
+            metadata?: {
+                [key: string]: string | null;
+            } | null;
+            /**
+             * A transient ID that can be used to reference this price when adding adjustments
+             * in the same API call.
+             */
+            reference_id?: string | null;
+        }
+        namespace NewSubscriptionMeteredAllowancePrice {
+            /**
+             * Configuration for metered_allowance pricing
+             */
+            interface MeteredAllowanceConfig {
+                /**
+                 * The grouping_key value whose summed quantity represents the allowance for this
+                 * period (e.g. 'storage_snapshot' emitting 3 × avg storage). Capped at consumption
+                 * — credit can never exceed actual usage.
+                 */
+                allowance_grouping_value: string;
+                /**
+                 * The grouping_key value whose summed quantity represents consumption (e.g.
+                 * 'download'). Charged at unit_amount.
+                 */
+                consumption_grouping_value: string;
+                /**
+                 * Event property used to partition the metric into consumption and allowance
+                 * quantities (e.g. 'event_name'). The metric is queried with this key and the two
+                 * values below select which partition is which.
+                 */
+                grouping_key: string;
+                /**
+                 * Per-unit price applied to gross consumption and to the allowance credit.
+                 */
+                unit_amount: string;
+                /**
+                 * Sub-line label for the credit row (e.g. 'Up to 3x free egress').
+                 */
+                allowance_display_name?: string;
+                /**
+                 * Sub-line label for the gross consumption row (e.g. 'bytes gotten').
+                 */
+                consumption_display_name?: string;
+            }
+        }
+        interface NewSubscriptionPercentCompositePrice {
+            /**
+             * The cadence to bill for this price on.
+             */
+            cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+            /**
+             * The id of the item the price will be associated with.
+             */
+            item_id: string;
+            /**
+             * The pricing model type
+             */
+            model_type: 'percent';
+            /**
+             * The name of the price.
+             */
+            name: string;
+            /**
+             * Configuration for percent pricing
+             */
+            percent_config: NewSubscriptionPercentCompositePrice.PercentConfig;
+            /**
+             * The id of the billable metric for the price. Only needed if the price is
+             * usage-based.
+             */
+            billable_metric_id?: string | null;
+            /**
+             * If the Price represents a fixed cost, the price will be billed in-advance if
+             * this is true, and in-arrears if this is false.
+             */
+            billed_in_advance?: boolean | null;
+            /**
+             * For custom cadence: specifies the duration of the billing period in days or
+             * months.
+             */
+            billing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+            /**
+             * The per unit conversion rate of the price currency to the invoicing currency.
+             */
+            conversion_rate?: number | null;
+            /**
+             * The configuration for the rate of the price currency to the invoicing currency.
+             */
+            conversion_rate_config?: Shared.UnitConversionRateConfig | Shared.TieredConversionRateConfig | null;
+            /**
+             * An ISO 4217 currency string, or custom pricing unit identifier, in which this
+             * price is billed.
+             */
+            currency?: string | null;
+            /**
+             * For dimensional price: specifies a price group and dimension values
+             */
+            dimensional_price_configuration?: Shared.NewDimensionalPriceConfiguration | null;
+            /**
+             * An alias for the price.
+             */
+            external_price_id?: string | null;
+            /**
+             * If the Price represents a fixed cost, this represents the quantity of units
+             * applied.
+             */
+            fixed_price_quantity?: number | null;
+            /**
+             * The property used to group this price on an invoice
+             */
+            invoice_grouping_key?: string | null;
+            /**
+             * Within each billing cycle, specifies the cadence at which invoices are produced.
+             * If unspecified, a single invoice is produced per billing cycle.
+             */
+            invoicing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+            /**
+             * The ID of the license type to associate with this price.
+             */
+            license_type_id?: string | null;
+            /**
+             * User-specified key/value pairs for the resource. Individual keys can be removed
+             * by setting the value to `null`, and the entire metadata mapping can be cleared
+             * by setting `metadata` to `null`.
+             */
+            metadata?: {
+                [key: string]: string | null;
+            } | null;
+            /**
+             * A transient ID that can be used to reference this price when adding adjustments
+             * in the same API call.
+             */
+            reference_id?: string | null;
+        }
+        namespace NewSubscriptionPercentCompositePrice {
+            /**
+             * Configuration for percent pricing
+             */
+            interface PercentConfig {
+                /**
+                 * Fraction of the component subtotals to charge (0 < percent <= 1).
+                 */
+                percent: number;
+                /**
+                 * Maximum amount to charge. If unset, the fee has no upper bound.
+                 */
+                maximum_amount?: string | null;
+                /**
+                 * Minimum amount to charge. If unset, the fee is bounded below by 0.
+                 */
+                minimum_amount?: string | null;
+                /**
+                 * If true, the minimum_amount is prorated based on the service period. The
+                 * maximum_amount is an absolute cap (never prorated), and the percent applied to
+                 * upstream subtotals is never prorated either.
+                 */
+                prorated?: boolean;
+            }
+        }
+        interface NewSubscriptionEventOutputPrice {
+            /**
+             * The cadence to bill for this price on.
+             */
+            cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+            /**
+             * Configuration for event_output pricing
+             */
+            event_output_config: NewSubscriptionEventOutputPrice.EventOutputConfig;
+            /**
+             * The id of the item the price will be associated with.
+             */
+            item_id: string;
+            /**
+             * The pricing model type
+             */
+            model_type: 'event_output';
+            /**
+             * The name of the price.
+             */
+            name: string;
+            /**
+             * The id of the billable metric for the price. Only needed if the price is
+             * usage-based.
+             */
+            billable_metric_id?: string | null;
+            /**
+             * If the Price represents a fixed cost, the price will be billed in-advance if
+             * this is true, and in-arrears if this is false.
+             */
+            billed_in_advance?: boolean | null;
+            /**
+             * For custom cadence: specifies the duration of the billing period in days or
+             * months.
+             */
+            billing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+            /**
+             * The per unit conversion rate of the price currency to the invoicing currency.
+             */
+            conversion_rate?: number | null;
+            /**
+             * The configuration for the rate of the price currency to the invoicing currency.
+             */
+            conversion_rate_config?: Shared.UnitConversionRateConfig | Shared.TieredConversionRateConfig | null;
+            /**
+             * An ISO 4217 currency string, or custom pricing unit identifier, in which this
+             * price is billed.
+             */
+            currency?: string | null;
+            /**
+             * For dimensional price: specifies a price group and dimension values
+             */
+            dimensional_price_configuration?: Shared.NewDimensionalPriceConfiguration | null;
+            /**
+             * An alias for the price.
+             */
+            external_price_id?: string | null;
+            /**
+             * If the Price represents a fixed cost, this represents the quantity of units
+             * applied.
+             */
+            fixed_price_quantity?: number | null;
+            /**
+             * The property used to group this price on an invoice
+             */
+            invoice_grouping_key?: string | null;
+            /**
+             * Within each billing cycle, specifies the cadence at which invoices are produced.
+             * If unspecified, a single invoice is produced per billing cycle.
+             */
+            invoicing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+            /**
+             * The ID of the license type to associate with this price.
+             */
+            license_type_id?: string | null;
+            /**
+             * User-specified key/value pairs for the resource. Individual keys can be removed
+             * by setting the value to `null`, and the entire metadata mapping can be cleared
+             * by setting `metadata` to `null`.
+             */
+            metadata?: {
+                [key: string]: string | null;
+            } | null;
+            /**
+             * A transient ID that can be used to reference this price when adding adjustments
+             * in the same API call.
+             */
+            reference_id?: string | null;
+        }
+        namespace NewSubscriptionEventOutputPrice {
+            /**
+             * Configuration for event_output pricing
+             */
+            interface EventOutputConfig {
+                /**
+                 * The key in the event data to extract the unit rate from.
+                 */
+                unit_rating_key: string;
+                /**
+                 * If provided, this amount will be used as the unit rate when an event does not
+                 * have a value for the `unit_rating_key`. If not provided, events missing a unit
+                 * rate will be ignored.
+                 */
+                default_unit_rate?: string | null;
+                /**
+                 * An optional key in the event data to group by (e.g., event ID). All events will
+                 * also be grouped by their unit rate.
+                 */
+                grouping_key?: string | null;
+            }
+        }
+    }
+}
+export interface SubscriptionUpdateParams {
+    /**
+     * Determines whether issued invoices for this subscription will automatically be
+     * charged with the saved payment method on the due date. This property defaults to
+     * the plan's behavior.
+     */
+    auto_collection?: boolean | null;
+    /**
+     * Used to determine if invoices for this subscription will be automatically
+     * issued. If true, invoices will be automatically issued. If false, invoices will
+     * require manual approval. If `null` is specified, this defaults to the behavior
+     * configured for this customer.
+     */
+    auto_issuance?: boolean | null;
+    /**
+     * Determines the default memo on this subscription's invoices. Note that if this
+     * is not provided, it is determined by the plan configuration.
+     */
+    default_invoice_memo?: string | null;
     /**
      * When this subscription's accrued usage reaches this threshold, an invoice will
      * be issued for the subscription. If not specified, invoices will only be issued
@@ -5775,7 +6963,7 @@ export declare namespace SubscriptionPriceIntervalsParams {
         /**
          * New floating price request body params.
          */
-        price?: Shared.NewFloatingUnitPrice | Shared.NewFloatingTieredPrice | Shared.NewFloatingBulkPrice | Add.NewFloatingBulkWithFiltersPrice | Shared.NewFloatingPackagePrice | Shared.NewFloatingMatrixPrice | Shared.NewFloatingThresholdTotalAmountPrice | Shared.NewFloatingTieredPackagePrice | Shared.NewFloatingTieredWithMinimumPrice | Shared.NewFloatingGroupedTieredPrice | Shared.NewFloatingTieredPackageWithMinimumPrice | Shared.NewFloatingPackageWithAllocationPrice | Shared.NewFloatingUnitWithPercentPrice | Shared.NewFloatingMatrixWithAllocationPrice | Shared.NewFloatingTieredWithProrationPrice | Shared.NewFloatingUnitWithProrationPrice | Shared.NewFloatingGroupedAllocationPrice | Shared.NewFloatingBulkWithProrationPrice | Shared.NewFloatingGroupedWithProratedMinimumPrice | Shared.NewFloatingGroupedWithMeteredMinimumPrice | Add.NewFloatingGroupedWithMinMaxThresholdsPrice | Shared.NewFloatingMatrixWithDisplayNamePrice | Shared.NewFloatingGroupedTieredPackagePrice | Shared.NewFloatingMaxGroupTieredPackagePrice | Shared.NewFloatingScalableMatrixWithUnitPricingPrice | Shared.NewFloatingScalableMatrixWithTieredPricingPrice | Shared.NewFloatingCumulativeGroupedBulkPrice | Add.NewFloatingCumulativeGroupedAllocationPrice | Shared.NewFloatingMinimumCompositePrice | Add.NewFloatingPercentCompositePrice | Add.NewFloatingEventOutputPrice | null;
+        price?: Shared.NewFloatingUnitPrice | Shared.NewFloatingTieredPrice | Shared.NewFloatingBulkPrice | Add.NewFloatingBulkWithFiltersPrice | Shared.NewFloatingPackagePrice | Shared.NewFloatingMatrixPrice | Shared.NewFloatingThresholdTotalAmountPrice | Shared.NewFloatingTieredPackagePrice | Shared.NewFloatingTieredWithMinimumPrice | Shared.NewFloatingGroupedTieredPrice | Shared.NewFloatingTieredPackageWithMinimumPrice | Shared.NewFloatingPackageWithAllocationPrice | Shared.NewFloatingUnitWithPercentPrice | Shared.NewFloatingMatrixWithAllocationPrice | Add.NewFloatingMatrixWithThresholdDiscountsPrice | Shared.NewFloatingTieredWithProrationPrice | Shared.NewFloatingUnitWithProrationPrice | Shared.NewFloatingGroupedAllocationPrice | Shared.NewFloatingBulkWithProrationPrice | Shared.NewFloatingGroupedWithProratedMinimumPrice | Shared.NewFloatingGroupedWithMeteredMinimumPrice | Add.NewFloatingGroupedWithMinMaxThresholdsPrice | Shared.NewFloatingMatrixWithDisplayNamePrice | Shared.NewFloatingGroupedTieredPackagePrice | Shared.NewFloatingMaxGroupTieredPackagePrice | Shared.NewFloatingScalableMatrixWithUnitPricingPrice | Shared.NewFloatingScalableMatrixWithTieredPricingPrice | Shared.NewFloatingCumulativeGroupedBulkPrice | Add.NewFloatingCumulativeGroupedAllocationPrice | Add.NewFloatingDailyCreditAllowancePrice | Add.NewFloatingMeteredAllowancePrice | Shared.NewFloatingMinimumCompositePrice | Add.NewFloatingPercentCompositePrice | Add.NewFloatingEventOutputPrice | null;
         /**
          * The id of the price to add to the subscription.
          */
@@ -5793,42 +6981,297 @@ export declare namespace SubscriptionPriceIntervalsParams {
     namespace Add {
         interface AmountDiscountCreationParams {
             /**
-             * Only available if discount_type is `amount`.
+             * Only available if discount_type is `amount`.
+             */
+            amount_discount: number;
+            discount_type: 'amount';
+        }
+        interface PercentageDiscountCreationParams {
+            discount_type: 'percentage';
+            /**
+             * Only available if discount_type is `percentage`. This is a number between 0
+             * and 1.
+             */
+            percentage_discount: number;
+        }
+        interface UsageDiscountCreationParams {
+            discount_type: 'usage';
+            /**
+             * Only available if discount_type is `usage`. Number of usage units that this
+             * discount is for.
+             */
+            usage_discount: number;
+        }
+        interface FixedFeeQuantityTransition {
+            /**
+             * The date that the fixed fee quantity transition should take effect.
+             */
+            effective_date: string;
+            /**
+             * The quantity of the fixed fee quantity transition.
+             */
+            quantity: number;
+        }
+        interface NewFloatingBulkWithFiltersPrice {
+            /**
+             * Configuration for bulk_with_filters pricing
+             */
+            bulk_with_filters_config: NewFloatingBulkWithFiltersPrice.BulkWithFiltersConfig;
+            /**
+             * The cadence to bill for this price on.
+             */
+            cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+            /**
+             * An ISO 4217 currency string for which this price is billed in.
+             */
+            currency: string;
+            /**
+             * The id of the item the price will be associated with.
+             */
+            item_id: string;
+            /**
+             * The pricing model type
+             */
+            model_type: 'bulk_with_filters';
+            /**
+             * The name of the price.
+             */
+            name: string;
+            /**
+             * The id of the billable metric for the price. Only needed if the price is
+             * usage-based.
+             */
+            billable_metric_id?: string | null;
+            /**
+             * If the Price represents a fixed cost, the price will be billed in-advance if
+             * this is true, and in-arrears if this is false.
+             */
+            billed_in_advance?: boolean | null;
+            /**
+             * For custom cadence: specifies the duration of the billing period in days or
+             * months.
+             */
+            billing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+            /**
+             * The per unit conversion rate of the price currency to the invoicing currency.
+             */
+            conversion_rate?: number | null;
+            /**
+             * The configuration for the rate of the price currency to the invoicing currency.
+             */
+            conversion_rate_config?: Shared.UnitConversionRateConfig | Shared.TieredConversionRateConfig | null;
+            /**
+             * For dimensional price: specifies a price group and dimension values
+             */
+            dimensional_price_configuration?: Shared.NewDimensionalPriceConfiguration | null;
+            /**
+             * An alias for the price.
+             */
+            external_price_id?: string | null;
+            /**
+             * If the Price represents a fixed cost, this represents the quantity of units
+             * applied.
+             */
+            fixed_price_quantity?: number | null;
+            /**
+             * The property used to group this price on an invoice
+             */
+            invoice_grouping_key?: string | null;
+            /**
+             * Within each billing cycle, specifies the cadence at which invoices are produced.
+             * If unspecified, a single invoice is produced per billing cycle.
+             */
+            invoicing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+            /**
+             * The ID of the license type to associate with this price.
+             */
+            license_type_id?: string | null;
+            /**
+             * User-specified key/value pairs for the resource. Individual keys can be removed
+             * by setting the value to `null`, and the entire metadata mapping can be cleared
+             * by setting `metadata` to `null`.
+             */
+            metadata?: {
+                [key: string]: string | null;
+            } | null;
+        }
+        namespace NewFloatingBulkWithFiltersPrice {
+            /**
+             * Configuration for bulk_with_filters pricing
+             */
+            interface BulkWithFiltersConfig {
+                /**
+                 * Property filters to apply (all must match)
+                 */
+                filters: Array<BulkWithFiltersConfig.Filter>;
+                /**
+                 * Bulk tiers for rating based on total usage volume
+                 */
+                tiers: Array<BulkWithFiltersConfig.Tier>;
+            }
+            namespace BulkWithFiltersConfig {
+                /**
+                 * Configuration for a single property filter
+                 */
+                interface Filter {
+                    /**
+                     * Event property key to filter on
+                     */
+                    property_key: string;
+                    /**
+                     * Event property value to match
+                     */
+                    property_value: string;
+                }
+                /**
+                 * Configuration for a single bulk pricing tier
+                 */
+                interface Tier {
+                    /**
+                     * Amount per unit
+                     */
+                    unit_amount: string;
+                    /**
+                     * The lower bound for this tier
+                     */
+                    tier_lower_bound?: string | null;
+                }
+            }
+        }
+        interface NewFloatingMatrixWithThresholdDiscountsPrice {
+            /**
+             * The cadence to bill for this price on.
              */
-            amount_discount: number;
-            discount_type: 'amount';
-        }
-        interface PercentageDiscountCreationParams {
-            discount_type: 'percentage';
+            cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
             /**
-             * Only available if discount_type is `percentage`. This is a number between 0
-             * and 1.
+             * An ISO 4217 currency string for which this price is billed in.
              */
-            percentage_discount: number;
-        }
-        interface UsageDiscountCreationParams {
-            discount_type: 'usage';
+            currency: string;
             /**
-             * Only available if discount_type is `usage`. Number of usage units that this
-             * discount is for.
+             * The id of the item the price will be associated with.
              */
-            usage_discount: number;
-        }
-        interface FixedFeeQuantityTransition {
+            item_id: string;
             /**
-             * The date that the fixed fee quantity transition should take effect.
+             * Configuration for matrix_with_threshold_discounts pricing
              */
-            effective_date: string;
+            matrix_with_threshold_discounts_config: NewFloatingMatrixWithThresholdDiscountsPrice.MatrixWithThresholdDiscountsConfig;
             /**
-             * The quantity of the fixed fee quantity transition.
+             * The pricing model type
              */
-            quantity: number;
+            model_type: 'matrix_with_threshold_discounts';
+            /**
+             * The name of the price.
+             */
+            name: string;
+            /**
+             * The id of the billable metric for the price. Only needed if the price is
+             * usage-based.
+             */
+            billable_metric_id?: string | null;
+            /**
+             * If the Price represents a fixed cost, the price will be billed in-advance if
+             * this is true, and in-arrears if this is false.
+             */
+            billed_in_advance?: boolean | null;
+            /**
+             * For custom cadence: specifies the duration of the billing period in days or
+             * months.
+             */
+            billing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+            /**
+             * The per unit conversion rate of the price currency to the invoicing currency.
+             */
+            conversion_rate?: number | null;
+            /**
+             * The configuration for the rate of the price currency to the invoicing currency.
+             */
+            conversion_rate_config?: Shared.UnitConversionRateConfig | Shared.TieredConversionRateConfig | null;
+            /**
+             * For dimensional price: specifies a price group and dimension values
+             */
+            dimensional_price_configuration?: Shared.NewDimensionalPriceConfiguration | null;
+            /**
+             * An alias for the price.
+             */
+            external_price_id?: string | null;
+            /**
+             * If the Price represents a fixed cost, this represents the quantity of units
+             * applied.
+             */
+            fixed_price_quantity?: number | null;
+            /**
+             * The property used to group this price on an invoice
+             */
+            invoice_grouping_key?: string | null;
+            /**
+             * Within each billing cycle, specifies the cadence at which invoices are produced.
+             * If unspecified, a single invoice is produced per billing cycle.
+             */
+            invoicing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+            /**
+             * The ID of the license type to associate with this price.
+             */
+            license_type_id?: string | null;
+            /**
+             * User-specified key/value pairs for the resource. Individual keys can be removed
+             * by setting the value to `null`, and the entire metadata mapping can be cleared
+             * by setting `metadata` to `null`.
+             */
+            metadata?: {
+                [key: string]: string | null;
+            } | null;
         }
-        interface NewFloatingBulkWithFiltersPrice {
+        namespace NewFloatingMatrixWithThresholdDiscountsPrice {
             /**
-             * Configuration for bulk_with_filters pricing
+             * Configuration for matrix_with_threshold_discounts pricing
              */
-            bulk_with_filters_config: NewFloatingBulkWithFiltersPrice.BulkWithFiltersConfig;
+            interface MatrixWithThresholdDiscountsConfig {
+                /**
+                 * Unit price used for usage that does not match any defined matrix cell.
+                 */
+                default_unit_amount: string;
+                /**
+                 * First matrix dimension key.
+                 */
+                first_dimension: string;
+                /**
+                 * Per-cell unit prices.
+                 */
+                matrix_values: Array<MatrixWithThresholdDiscountsConfig.MatrixValue>;
+                /**
+                 * Optional second matrix dimension key.
+                 */
+                second_dimension?: string | null;
+                threshold_discount_groups?: Array<MatrixWithThresholdDiscountsConfig.ThresholdDiscountGroup>;
+            }
+            namespace MatrixWithThresholdDiscountsConfig {
+                interface MatrixValue {
+                    first_dimension_value: string;
+                    unit_amount: string;
+                    second_dimension_value?: string | null;
+                }
+                interface ThresholdDiscountGroup {
+                    /**
+                     * Discount rate applied to spend above the threshold.
+                     */
+                    above_threshold_discount_percentage: string;
+                    /**
+                     * Discount rate applied to spend at or below the threshold. Set to 0 for no
+                     * baseline discount.
+                     */
+                    below_threshold_discount_percentage: string;
+                    /**
+                     * Semicolon-separated list of matrix cell coordinates targeted by this group. Each
+                     * coordinate is `first,second` when the matrix has two dimensions, or just `first`
+                     * for a single-dimension matrix. Example: `blue,circle;green,triangle`.
+                     */
+                    cell_coordinates: string;
+                    threshold_amount: string;
+                    description?: string | null;
+                }
+            }
+        }
+        interface NewFloatingGroupedWithMinMaxThresholdsPrice {
             /**
              * The cadence to bill for this price on.
              */
@@ -5837,6 +7280,10 @@ export declare namespace SubscriptionPriceIntervalsParams {
              * An ISO 4217 currency string for which this price is billed in.
              */
             currency: string;
+            /**
+             * Configuration for grouped_with_min_max_thresholds pricing
+             */
+            grouped_with_min_max_thresholds_config: NewFloatingGroupedWithMinMaxThresholdsPrice.GroupedWithMinMaxThresholdsConfig;
             /**
              * The id of the item the price will be associated with.
              */
@@ -5844,7 +7291,7 @@ export declare namespace SubscriptionPriceIntervalsParams {
             /**
              * The pricing model type
              */
-            model_type: 'bulk_with_filters';
+            model_type: 'grouped_with_min_max_thresholds';
             /**
              * The name of the price.
              */
@@ -5907,50 +7354,136 @@ export declare namespace SubscriptionPriceIntervalsParams {
                 [key: string]: string | null;
             } | null;
         }
-        namespace NewFloatingBulkWithFiltersPrice {
+        namespace NewFloatingGroupedWithMinMaxThresholdsPrice {
             /**
-             * Configuration for bulk_with_filters pricing
+             * Configuration for grouped_with_min_max_thresholds pricing
              */
-            interface BulkWithFiltersConfig {
+            interface GroupedWithMinMaxThresholdsConfig {
                 /**
-                 * Property filters to apply (all must match)
+                 * The event property used to group before applying thresholds
                  */
-                filters: Array<BulkWithFiltersConfig.Filter>;
+                grouping_key: string;
                 /**
-                 * Bulk tiers for rating based on total usage volume
+                 * The maximum amount to charge each group
                  */
-                tiers: Array<BulkWithFiltersConfig.Tier>;
+                maximum_charge: string;
+                /**
+                 * The minimum amount to charge each group, regardless of usage
+                 */
+                minimum_charge: string;
+                /**
+                 * The base price charged per group
+                 */
+                per_unit_rate: string;
             }
-            namespace BulkWithFiltersConfig {
+        }
+        interface NewFloatingCumulativeGroupedAllocationPrice {
+            /**
+             * The cadence to bill for this price on.
+             */
+            cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+            /**
+             * Configuration for cumulative_grouped_allocation pricing
+             */
+            cumulative_grouped_allocation_config: NewFloatingCumulativeGroupedAllocationPrice.CumulativeGroupedAllocationConfig;
+            /**
+             * An ISO 4217 currency string for which this price is billed in.
+             */
+            currency: string;
+            /**
+             * The id of the item the price will be associated with.
+             */
+            item_id: string;
+            /**
+             * The pricing model type
+             */
+            model_type: 'cumulative_grouped_allocation';
+            /**
+             * The name of the price.
+             */
+            name: string;
+            /**
+             * The id of the billable metric for the price. Only needed if the price is
+             * usage-based.
+             */
+            billable_metric_id?: string | null;
+            /**
+             * If the Price represents a fixed cost, the price will be billed in-advance if
+             * this is true, and in-arrears if this is false.
+             */
+            billed_in_advance?: boolean | null;
+            /**
+             * For custom cadence: specifies the duration of the billing period in days or
+             * months.
+             */
+            billing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+            /**
+             * The per unit conversion rate of the price currency to the invoicing currency.
+             */
+            conversion_rate?: number | null;
+            /**
+             * The configuration for the rate of the price currency to the invoicing currency.
+             */
+            conversion_rate_config?: Shared.UnitConversionRateConfig | Shared.TieredConversionRateConfig | null;
+            /**
+             * For dimensional price: specifies a price group and dimension values
+             */
+            dimensional_price_configuration?: Shared.NewDimensionalPriceConfiguration | null;
+            /**
+             * An alias for the price.
+             */
+            external_price_id?: string | null;
+            /**
+             * If the Price represents a fixed cost, this represents the quantity of units
+             * applied.
+             */
+            fixed_price_quantity?: number | null;
+            /**
+             * The property used to group this price on an invoice
+             */
+            invoice_grouping_key?: string | null;
+            /**
+             * Within each billing cycle, specifies the cadence at which invoices are produced.
+             * If unspecified, a single invoice is produced per billing cycle.
+             */
+            invoicing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+            /**
+             * The ID of the license type to associate with this price.
+             */
+            license_type_id?: string | null;
+            /**
+             * User-specified key/value pairs for the resource. Individual keys can be removed
+             * by setting the value to `null`, and the entire metadata mapping can be cleared
+             * by setting `metadata` to `null`.
+             */
+            metadata?: {
+                [key: string]: string | null;
+            } | null;
+        }
+        namespace NewFloatingCumulativeGroupedAllocationPrice {
+            /**
+             * Configuration for cumulative_grouped_allocation pricing
+             */
+            interface CumulativeGroupedAllocationConfig {
                 /**
-                 * Configuration for a single property filter
+                 * The overall allocation across all groups
                  */
-                interface Filter {
-                    /**
-                     * Event property key to filter on
-                     */
-                    property_key: string;
-                    /**
-                     * Event property value to match
-                     */
-                    property_value: string;
-                }
+                cumulative_allocation: string;
+                /**
+                 * The allocation per individual group
+                 */
+                group_allocation: string;
                 /**
-                 * Configuration for a single bulk pricing tier
+                 * The event property used to group usage before applying allocations
                  */
-                interface Tier {
-                    /**
-                     * Amount per unit
-                     */
-                    unit_amount: string;
-                    /**
-                     * The lower bound for this tier
-                     */
-                    tier_lower_bound?: string | null;
-                }
+                grouping_key: string;
+                /**
+                 * The amount to charge for each unit outside of the allocation
+                 */
+                unit_amount: string;
             }
         }
-        interface NewFloatingGroupedWithMinMaxThresholdsPrice {
+        interface NewFloatingDailyCreditAllowancePrice {
             /**
              * The cadence to bill for this price on.
              */
@@ -5960,9 +7493,9 @@ export declare namespace SubscriptionPriceIntervalsParams {
              */
             currency: string;
             /**
-             * Configuration for grouped_with_min_max_thresholds pricing
+             * Configuration for daily_credit_allowance pricing
              */
-            grouped_with_min_max_thresholds_config: NewFloatingGroupedWithMinMaxThresholdsPrice.GroupedWithMinMaxThresholdsConfig;
+            daily_credit_allowance_config: NewFloatingDailyCreditAllowancePrice.DailyCreditAllowanceConfig;
             /**
              * The id of the item the price will be associated with.
              */
@@ -5970,7 +7503,7 @@ export declare namespace SubscriptionPriceIntervalsParams {
             /**
              * The pricing model type
              */
-            model_type: 'grouped_with_min_max_thresholds';
+            model_type: 'daily_credit_allowance';
             /**
              * The name of the price.
              */
@@ -6033,38 +7566,57 @@ export declare namespace SubscriptionPriceIntervalsParams {
                 [key: string]: string | null;
             } | null;
         }
-        namespace NewFloatingGroupedWithMinMaxThresholdsPrice {
+        namespace NewFloatingDailyCreditAllowancePrice {
             /**
-             * Configuration for grouped_with_min_max_thresholds pricing
+             * Configuration for daily_credit_allowance pricing
              */
-            interface GroupedWithMinMaxThresholdsConfig {
+            interface DailyCreditAllowanceConfig {
                 /**
-                 * The event property used to group before applying thresholds
+                 * Credits granted per day. Lose-it-or-use-it; does not roll over.
                  */
-                grouping_key: string;
+                daily_allowance: string;
                 /**
-                 * The maximum amount to charge each group
+                 * Default per-unit credit rate for any usage not bucketed into a specified
+                 * matrix_value
                  */
-                maximum_charge: string;
+                default_unit_amount: string;
                 /**
-                 * The minimum amount to charge each group, regardless of usage
+                 * One or two event property values to evaluate matrix groups by
                  */
-                minimum_charge: string;
+                dimensions: Array<string | null>;
                 /**
-                 * The base price charged per group
+                 * Event property whose value identifies the day bucket the event belongs to (e.g.
+                 * 'event_day' set to an ISO date string in the customer's timezone). The allowance
+                 * resets per distinct value of this property.
                  */
-                per_unit_rate: string;
+                event_day_property: string;
+                /**
+                 * Per-dimension credit rates
+                 */
+                matrix_values: Array<DailyCreditAllowanceConfig.MatrixValue>;
+            }
+            namespace DailyCreditAllowanceConfig {
+                /**
+                 * Per-dimension credit price for the daily credit allowance model.
+                 */
+                interface MatrixValue {
+                    /**
+                     * One or two matrix keys to filter usage to this value by. For example, ["model"]
+                     * could be used to apply a different credit rate to each AI model.
+                     */
+                    dimension_values: Array<string | null>;
+                    /**
+                     * Credits charged per unit of usage matching the specified dimension_values
+                     */
+                    unit_amount: string;
+                }
             }
         }
-        interface NewFloatingCumulativeGroupedAllocationPrice {
+        interface NewFloatingMeteredAllowancePrice {
             /**
              * The cadence to bill for this price on.
              */
             cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
-            /**
-             * Configuration for cumulative_grouped_allocation pricing
-             */
-            cumulative_grouped_allocation_config: NewFloatingCumulativeGroupedAllocationPrice.CumulativeGroupedAllocationConfig;
             /**
              * An ISO 4217 currency string for which this price is billed in.
              */
@@ -6073,10 +7625,14 @@ export declare namespace SubscriptionPriceIntervalsParams {
              * The id of the item the price will be associated with.
              */
             item_id: string;
+            /**
+             * Configuration for metered_allowance pricing
+             */
+            metered_allowance_config: NewFloatingMeteredAllowancePrice.MeteredAllowanceConfig;
             /**
              * The pricing model type
              */
-            model_type: 'cumulative_grouped_allocation';
+            model_type: 'metered_allowance';
             /**
              * The name of the price.
              */
@@ -6139,27 +7695,40 @@ export declare namespace SubscriptionPriceIntervalsParams {
                 [key: string]: string | null;
             } | null;
         }
-        namespace NewFloatingCumulativeGroupedAllocationPrice {
+        namespace NewFloatingMeteredAllowancePrice {
             /**
-             * Configuration for cumulative_grouped_allocation pricing
+             * Configuration for metered_allowance pricing
              */
-            interface CumulativeGroupedAllocationConfig {
+            interface MeteredAllowanceConfig {
                 /**
-                 * The overall allocation across all groups
+                 * The grouping_key value whose summed quantity represents the allowance for this
+                 * period (e.g. 'storage_snapshot' emitting 3 × avg storage). Capped at consumption
+                 * — credit can never exceed actual usage.
                  */
-                cumulative_allocation: string;
+                allowance_grouping_value: string;
                 /**
-                 * The allocation per individual group
+                 * The grouping_key value whose summed quantity represents consumption (e.g.
+                 * 'download'). Charged at unit_amount.
                  */
-                group_allocation: string;
+                consumption_grouping_value: string;
                 /**
-                 * The event property used to group usage before applying allocations
+                 * Event property used to partition the metric into consumption and allowance
+                 * quantities (e.g. 'event_name'). The metric is queried with this key and the two
+                 * values below select which partition is which.
                  */
                 grouping_key: string;
                 /**
-                 * The amount to charge for each unit outside of the allocation
+                 * Per-unit price applied to gross consumption and to the allowance credit.
                  */
                 unit_amount: string;
+                /**
+                 * Sub-line label for the credit row (e.g. 'Up to 3x free egress').
+                 */
+                allowance_display_name?: string;
+                /**
+                 * Sub-line label for the gross consumption row (e.g. 'bytes gotten').
+                 */
+                consumption_display_name?: string;
             }
         }
         interface NewFloatingPercentCompositePrice {
@@ -6251,9 +7820,23 @@ export declare namespace SubscriptionPriceIntervalsParams {
              */
             interface PercentConfig {
                 /**
-                 * What percent of the component subtotals to charge
+                 * Fraction of the component subtotals to charge (0 < percent <= 1).
                  */
                 percent: number;
+                /**
+                 * Maximum amount to charge. If unset, the fee has no upper bound.
+                 */
+                maximum_amount?: string | null;
+                /**
+                 * Minimum amount to charge. If unset, the fee is bounded below by 0.
+                 */
+                minimum_amount?: string | null;
+                /**
+                 * If true, the minimum_amount is prorated based on the service period. The
+                 * maximum_amount is an absolute cap (never prorated), and the percent applied to
+                 * upstream subtotals is never prorated either.
+                 */
+                prorated?: boolean;
             }
         }
         interface NewFloatingEventOutputPrice {
@@ -6373,7 +7956,7 @@ export declare namespace SubscriptionPriceIntervalsParams {
         /**
          * The definition of a new adjustment to create and add to the subscription.
          */
-        adjustment?: Shared.NewPercentageDiscount | Shared.NewUsageDiscount | Shared.NewAmountDiscount | Shared.NewMinimum | Shared.NewMaximum | null;
+        adjustment?: Shared.NewPercentageDiscount | Shared.NewUsageDiscount | Shared.NewAmountDiscount | Shared.NewMinimum | Shared.NewMaximum | AddAdjustment.NewTieredPercentageDiscount | null;
         /**
          * The ID of the adjustment to add to the subscription. Adjustment IDs can be
          * re-used from existing subscriptions or plans, but adjustments associated with
@@ -6388,6 +7971,71 @@ export declare namespace SubscriptionPriceIntervalsParams {
          */
         end_date?: (string & {}) | Shared.BillingCycleRelativeDate | null;
     }
+    namespace AddAdjustment {
+        interface NewTieredPercentageDiscount {
+            adjustment_type: 'tiered_percentage_discount';
+            tiers: Array<NewTieredPercentageDiscount.Tier>;
+            /**
+             * If set, the adjustment will apply to every price on the subscription.
+             */
+            applies_to_all?: true | null;
+            /**
+             * The set of item IDs to which this adjustment applies.
+             */
+            applies_to_item_ids?: Array<string> | null;
+            /**
+             * The set of price IDs to which this adjustment applies.
+             */
+            applies_to_price_ids?: Array<string> | null;
+            /**
+             * If set, only prices in the specified currency will have the adjustment applied.
+             */
+            currency?: string | null;
+            /**
+             * A list of filters that determine which prices this adjustment will apply to.
+             */
+            filters?: Array<NewTieredPercentageDiscount.Filter> | null;
+            /**
+             * When false, this adjustment will be applied to a single price. Otherwise, it
+             * will be applied at the invoice level, possibly to multiple prices.
+             */
+            is_invoice_level?: boolean;
+            /**
+             * If set, only prices of the specified type will have the adjustment applied.
+             */
+            price_type?: 'usage' | 'fixed_in_advance' | 'fixed_in_arrears' | 'fixed' | 'in_arrears' | null;
+        }
+        namespace NewTieredPercentageDiscount {
+            interface Tier {
+                /**
+                 * Exclusive lower bound of cumulative spend for this tier.
+                 */
+                lower_bound: number;
+                /**
+                 * The percentage (0-1) discounted from spend in this tier.
+                 */
+                percentage: number;
+                /**
+                 * Inclusive upper bound of cumulative spend; null for the final open-ended tier.
+                 */
+                upper_bound?: number | null;
+            }
+            interface Filter {
+                /**
+                 * The property of the price to filter on.
+                 */
+                field: 'price_id' | 'item_id' | 'price_type' | 'currency' | 'pricing_unit_id';
+                /**
+                 * Should prices that match the filter be included or excluded.
+                 */
+                operator: 'includes' | 'excludes';
+                /**
+                 * The IDs or values that match this filter.
+                 */
+                values: Array<string>;
+            }
+        }
+    }
     interface Edit {
         /**
          * The id of the price interval to edit.
@@ -6519,6 +8167,13 @@ export interface SubscriptionSchedulePlanChangeParams {
      * defaults to the behavior configured for this customer.
      */
     auto_collection?: boolean | null;
+    /**
+     * Used to determine if invoices for this subscription will be automatically
+     * issued. If true, invoices will be automatically issued. If false, invoices will
+     * require manual approval. If `null` is specified, this defaults to the behavior
+     * configured for this customer.
+     */
+    auto_issuance?: boolean | null;
     /**
      * Reset billing periods to be aligned with the plan change's effective date or
      * start of the month. Defaults to `unchanged` which keeps subscription's existing
@@ -6635,7 +8290,7 @@ export declare namespace SubscriptionSchedulePlanChangeParams {
         /**
          * The definition of a new adjustment to create and add to the subscription.
          */
-        adjustment: Shared.NewPercentageDiscount | Shared.NewUsageDiscount | Shared.NewAmountDiscount | Shared.NewMinimum | Shared.NewMaximum;
+        adjustment: Shared.NewPercentageDiscount | Shared.NewUsageDiscount | Shared.NewAmountDiscount | Shared.NewMinimum | Shared.NewMaximum | AddAdjustment.NewTieredPercentageDiscount;
         /**
          * The end date of the adjustment interval. This is the date that the adjustment
          * will stop affecting prices on the subscription.
@@ -6652,6 +8307,71 @@ export declare namespace SubscriptionSchedulePlanChangeParams {
          */
         start_date?: string | null;
     }
+    namespace AddAdjustment {
+        interface NewTieredPercentageDiscount {
+            adjustment_type: 'tiered_percentage_discount';
+            tiers: Array<NewTieredPercentageDiscount.Tier>;
+            /**
+             * If set, the adjustment will apply to every price on the subscription.
+             */
+            applies_to_all?: true | null;
+            /**
+             * The set of item IDs to which this adjustment applies.
+             */
+            applies_to_item_ids?: Array<string> | null;
+            /**
+             * The set of price IDs to which this adjustment applies.
+             */
+            applies_to_price_ids?: Array<string> | null;
+            /**
+             * If set, only prices in the specified currency will have the adjustment applied.
+             */
+            currency?: string | null;
+            /**
+             * A list of filters that determine which prices this adjustment will apply to.
+             */
+            filters?: Array<NewTieredPercentageDiscount.Filter> | null;
+            /**
+             * When false, this adjustment will be applied to a single price. Otherwise, it
+             * will be applied at the invoice level, possibly to multiple prices.
+             */
+            is_invoice_level?: boolean;
+            /**
+             * If set, only prices of the specified type will have the adjustment applied.
+             */
+            price_type?: 'usage' | 'fixed_in_advance' | 'fixed_in_arrears' | 'fixed' | 'in_arrears' | null;
+        }
+        namespace NewTieredPercentageDiscount {
+            interface Tier {
+                /**
+                 * Exclusive lower bound of cumulative spend for this tier.
+                 */
+                lower_bound: number;
+                /**
+                 * The percentage (0-1) discounted from spend in this tier.
+                 */
+                percentage: number;
+                /**
+                 * Inclusive upper bound of cumulative spend; null for the final open-ended tier.
+                 */
+                upper_bound?: number | null;
+            }
+            interface Filter {
+                /**
+                 * The property of the price to filter on.
+                 */
+                field: 'price_id' | 'item_id' | 'price_type' | 'currency' | 'pricing_unit_id';
+                /**
+                 * Should prices that match the filter be included or excluded.
+                 */
+                operator: 'includes' | 'excludes';
+                /**
+                 * The IDs or values that match this filter.
+                 */
+                values: Array<string>;
+            }
+        }
+    }
     interface AddPrice {
         /**
          * The definition of a new allocation price to create and add to the subscription.
@@ -6696,7 +8416,7 @@ export declare namespace SubscriptionSchedulePlanChangeParams {
         /**
          * New subscription price request body params.
          */
-        price?: SubscriptionsAPI.NewSubscriptionUnitPrice | SubscriptionsAPI.NewSubscriptionTieredPrice | SubscriptionsAPI.NewSubscriptionBulkPrice | AddPrice.NewSubscriptionBulkWithFiltersPrice | SubscriptionsAPI.NewSubscriptionPackagePrice | SubscriptionsAPI.NewSubscriptionMatrixPrice | SubscriptionsAPI.NewSubscriptionThresholdTotalAmountPrice | SubscriptionsAPI.NewSubscriptionTieredPackagePrice | SubscriptionsAPI.NewSubscriptionTieredWithMinimumPrice | SubscriptionsAPI.NewSubscriptionGroupedTieredPrice | SubscriptionsAPI.NewSubscriptionTieredPackageWithMinimumPrice | SubscriptionsAPI.NewSubscriptionPackageWithAllocationPrice | SubscriptionsAPI.NewSubscriptionUnitWithPercentPrice | SubscriptionsAPI.NewSubscriptionMatrixWithAllocationPrice | AddPrice.NewSubscriptionTieredWithProrationPrice | SubscriptionsAPI.NewSubscriptionUnitWithProrationPrice | SubscriptionsAPI.NewSubscriptionGroupedAllocationPrice | SubscriptionsAPI.NewSubscriptionBulkWithProrationPrice | SubscriptionsAPI.NewSubscriptionGroupedWithProratedMinimumPrice | SubscriptionsAPI.NewSubscriptionGroupedWithMeteredMinimumPrice | AddPrice.NewSubscriptionGroupedWithMinMaxThresholdsPrice | SubscriptionsAPI.NewSubscriptionMatrixWithDisplayNamePrice | SubscriptionsAPI.NewSubscriptionGroupedTieredPackagePrice | SubscriptionsAPI.NewSubscriptionMaxGroupTieredPackagePrice | SubscriptionsAPI.NewSubscriptionScalableMatrixWithUnitPricingPrice | SubscriptionsAPI.NewSubscriptionScalableMatrixWithTieredPricingPrice | SubscriptionsAPI.NewSubscriptionCumulativeGroupedBulkPrice | AddPrice.NewSubscriptionCumulativeGroupedAllocationPrice | SubscriptionsAPI.NewSubscriptionMinimumCompositePrice | AddPrice.NewSubscriptionPercentCompositePrice | AddPrice.NewSubscriptionEventOutputPrice | null;
+        price?: SubscriptionsAPI.NewSubscriptionUnitPrice | SubscriptionsAPI.NewSubscriptionTieredPrice | SubscriptionsAPI.NewSubscriptionBulkPrice | AddPrice.NewSubscriptionBulkWithFiltersPrice | SubscriptionsAPI.NewSubscriptionPackagePrice | SubscriptionsAPI.NewSubscriptionMatrixPrice | SubscriptionsAPI.NewSubscriptionThresholdTotalAmountPrice | SubscriptionsAPI.NewSubscriptionTieredPackagePrice | SubscriptionsAPI.NewSubscriptionTieredWithMinimumPrice | SubscriptionsAPI.NewSubscriptionGroupedTieredPrice | SubscriptionsAPI.NewSubscriptionTieredPackageWithMinimumPrice | SubscriptionsAPI.NewSubscriptionPackageWithAllocationPrice | SubscriptionsAPI.NewSubscriptionUnitWithPercentPrice | SubscriptionsAPI.NewSubscriptionMatrixWithAllocationPrice | AddPrice.NewSubscriptionMatrixWithThresholdDiscountsPrice | AddPrice.NewSubscriptionTieredWithProrationPrice | SubscriptionsAPI.NewSubscriptionUnitWithProrationPrice | SubscriptionsAPI.NewSubscriptionGroupedAllocationPrice | SubscriptionsAPI.NewSubscriptionBulkWithProrationPrice | SubscriptionsAPI.NewSubscriptionGroupedWithProratedMinimumPrice | SubscriptionsAPI.NewSubscriptionGroupedWithMeteredMinimumPrice | AddPrice.NewSubscriptionGroupedWithMinMaxThresholdsPrice | SubscriptionsAPI.NewSubscriptionMatrixWithDisplayNamePrice | SubscriptionsAPI.NewSubscriptionGroupedTieredPackagePrice | SubscriptionsAPI.NewSubscriptionMaxGroupTieredPackagePrice | SubscriptionsAPI.NewSubscriptionScalableMatrixWithUnitPricingPrice | SubscriptionsAPI.NewSubscriptionScalableMatrixWithTieredPricingPrice | SubscriptionsAPI.NewSubscriptionCumulativeGroupedBulkPrice | AddPrice.NewSubscriptionCumulativeGroupedAllocationPrice | AddPrice.NewSubscriptionDailyCreditAllowancePrice | AddPrice.NewSubscriptionMeteredAllowancePrice | SubscriptionsAPI.NewSubscriptionMinimumCompositePrice | AddPrice.NewSubscriptionPercentCompositePrice | AddPrice.NewSubscriptionEventOutputPrice | null;
         /**
          * The id of the price to add to the subscription.
          */
@@ -6725,7 +8445,139 @@ export declare namespace SubscriptionSchedulePlanChangeParams {
             /**
              * The pricing model type
              */
-            model_type: 'bulk_with_filters';
+            model_type: 'bulk_with_filters';
+            /**
+             * The name of the price.
+             */
+            name: string;
+            /**
+             * The id of the billable metric for the price. Only needed if the price is
+             * usage-based.
+             */
+            billable_metric_id?: string | null;
+            /**
+             * If the Price represents a fixed cost, the price will be billed in-advance if
+             * this is true, and in-arrears if this is false.
+             */
+            billed_in_advance?: boolean | null;
+            /**
+             * For custom cadence: specifies the duration of the billing period in days or
+             * months.
+             */
+            billing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+            /**
+             * The per unit conversion rate of the price currency to the invoicing currency.
+             */
+            conversion_rate?: number | null;
+            /**
+             * The configuration for the rate of the price currency to the invoicing currency.
+             */
+            conversion_rate_config?: Shared.UnitConversionRateConfig | Shared.TieredConversionRateConfig | null;
+            /**
+             * An ISO 4217 currency string, or custom pricing unit identifier, in which this
+             * price is billed.
+             */
+            currency?: string | null;
+            /**
+             * For dimensional price: specifies a price group and dimension values
+             */
+            dimensional_price_configuration?: Shared.NewDimensionalPriceConfiguration | null;
+            /**
+             * An alias for the price.
+             */
+            external_price_id?: string | null;
+            /**
+             * If the Price represents a fixed cost, this represents the quantity of units
+             * applied.
+             */
+            fixed_price_quantity?: number | null;
+            /**
+             * The property used to group this price on an invoice
+             */
+            invoice_grouping_key?: string | null;
+            /**
+             * Within each billing cycle, specifies the cadence at which invoices are produced.
+             * If unspecified, a single invoice is produced per billing cycle.
+             */
+            invoicing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+            /**
+             * The ID of the license type to associate with this price.
+             */
+            license_type_id?: string | null;
+            /**
+             * User-specified key/value pairs for the resource. Individual keys can be removed
+             * by setting the value to `null`, and the entire metadata mapping can be cleared
+             * by setting `metadata` to `null`.
+             */
+            metadata?: {
+                [key: string]: string | null;
+            } | null;
+            /**
+             * A transient ID that can be used to reference this price when adding adjustments
+             * in the same API call.
+             */
+            reference_id?: string | null;
+        }
+        namespace NewSubscriptionBulkWithFiltersPrice {
+            /**
+             * Configuration for bulk_with_filters pricing
+             */
+            interface BulkWithFiltersConfig {
+                /**
+                 * Property filters to apply (all must match)
+                 */
+                filters: Array<BulkWithFiltersConfig.Filter>;
+                /**
+                 * Bulk tiers for rating based on total usage volume
+                 */
+                tiers: Array<BulkWithFiltersConfig.Tier>;
+            }
+            namespace BulkWithFiltersConfig {
+                /**
+                 * Configuration for a single property filter
+                 */
+                interface Filter {
+                    /**
+                     * Event property key to filter on
+                     */
+                    property_key: string;
+                    /**
+                     * Event property value to match
+                     */
+                    property_value: string;
+                }
+                /**
+                 * Configuration for a single bulk pricing tier
+                 */
+                interface Tier {
+                    /**
+                     * Amount per unit
+                     */
+                    unit_amount: string;
+                    /**
+                     * The lower bound for this tier
+                     */
+                    tier_lower_bound?: string | null;
+                }
+            }
+        }
+        interface NewSubscriptionMatrixWithThresholdDiscountsPrice {
+            /**
+             * The cadence to bill for this price on.
+             */
+            cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+            /**
+             * The id of the item the price will be associated with.
+             */
+            item_id: string;
+            /**
+             * Configuration for matrix_with_threshold_discounts pricing
+             */
+            matrix_with_threshold_discounts_config: NewSubscriptionMatrixWithThresholdDiscountsPrice.MatrixWithThresholdDiscountsConfig;
+            /**
+             * The pricing model type
+             */
+            model_type: 'matrix_with_threshold_discounts';
             /**
              * The name of the price.
              */
@@ -6798,54 +8650,293 @@ export declare namespace SubscriptionSchedulePlanChangeParams {
              */
             reference_id?: string | null;
         }
-        namespace NewSubscriptionBulkWithFiltersPrice {
+        namespace NewSubscriptionMatrixWithThresholdDiscountsPrice {
             /**
-             * Configuration for bulk_with_filters pricing
+             * Configuration for matrix_with_threshold_discounts pricing
              */
-            interface BulkWithFiltersConfig {
+            interface MatrixWithThresholdDiscountsConfig {
                 /**
-                 * Property filters to apply (all must match)
+                 * Unit price used for usage that does not match any defined matrix cell.
                  */
-                filters: Array<BulkWithFiltersConfig.Filter>;
+                default_unit_amount: string;
                 /**
-                 * Bulk tiers for rating based on total usage volume
+                 * First matrix dimension key.
                  */
-                tiers: Array<BulkWithFiltersConfig.Tier>;
-            }
-            namespace BulkWithFiltersConfig {
+                first_dimension: string;
                 /**
-                 * Configuration for a single property filter
+                 * Per-cell unit prices.
                  */
-                interface Filter {
+                matrix_values: Array<MatrixWithThresholdDiscountsConfig.MatrixValue>;
+                /**
+                 * Optional second matrix dimension key.
+                 */
+                second_dimension?: string | null;
+                threshold_discount_groups?: Array<MatrixWithThresholdDiscountsConfig.ThresholdDiscountGroup>;
+            }
+            namespace MatrixWithThresholdDiscountsConfig {
+                interface MatrixValue {
+                    first_dimension_value: string;
+                    unit_amount: string;
+                    second_dimension_value?: string | null;
+                }
+                interface ThresholdDiscountGroup {
                     /**
-                     * Event property key to filter on
+                     * Discount rate applied to spend above the threshold.
                      */
-                    property_key: string;
+                    above_threshold_discount_percentage: string;
                     /**
-                     * Event property value to match
+                     * Discount rate applied to spend at or below the threshold. Set to 0 for no
+                     * baseline discount.
                      */
-                    property_value: string;
+                    below_threshold_discount_percentage: string;
+                    /**
+                     * Semicolon-separated list of matrix cell coordinates targeted by this group. Each
+                     * coordinate is `first,second` when the matrix has two dimensions, or just `first`
+                     * for a single-dimension matrix. Example: `blue,circle;green,triangle`.
+                     */
+                    cell_coordinates: string;
+                    threshold_amount: string;
+                    description?: string | null;
                 }
+            }
+        }
+        interface NewSubscriptionTieredWithProrationPrice {
+            /**
+             * The cadence to bill for this price on.
+             */
+            cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+            /**
+             * The id of the item the price will be associated with.
+             */
+            item_id: string;
+            /**
+             * The pricing model type
+             */
+            model_type: 'tiered_with_proration';
+            /**
+             * The name of the price.
+             */
+            name: string;
+            /**
+             * Configuration for tiered_with_proration pricing
+             */
+            tiered_with_proration_config: NewSubscriptionTieredWithProrationPrice.TieredWithProrationConfig;
+            /**
+             * The id of the billable metric for the price. Only needed if the price is
+             * usage-based.
+             */
+            billable_metric_id?: string | null;
+            /**
+             * If the Price represents a fixed cost, the price will be billed in-advance if
+             * this is true, and in-arrears if this is false.
+             */
+            billed_in_advance?: boolean | null;
+            /**
+             * For custom cadence: specifies the duration of the billing period in days or
+             * months.
+             */
+            billing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+            /**
+             * The per unit conversion rate of the price currency to the invoicing currency.
+             */
+            conversion_rate?: number | null;
+            /**
+             * The configuration for the rate of the price currency to the invoicing currency.
+             */
+            conversion_rate_config?: Shared.UnitConversionRateConfig | Shared.TieredConversionRateConfig | null;
+            /**
+             * An ISO 4217 currency string, or custom pricing unit identifier, in which this
+             * price is billed.
+             */
+            currency?: string | null;
+            /**
+             * For dimensional price: specifies a price group and dimension values
+             */
+            dimensional_price_configuration?: Shared.NewDimensionalPriceConfiguration | null;
+            /**
+             * An alias for the price.
+             */
+            external_price_id?: string | null;
+            /**
+             * If the Price represents a fixed cost, this represents the quantity of units
+             * applied.
+             */
+            fixed_price_quantity?: number | null;
+            /**
+             * The property used to group this price on an invoice
+             */
+            invoice_grouping_key?: string | null;
+            /**
+             * Within each billing cycle, specifies the cadence at which invoices are produced.
+             * If unspecified, a single invoice is produced per billing cycle.
+             */
+            invoicing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+            /**
+             * The ID of the license type to associate with this price.
+             */
+            license_type_id?: string | null;
+            /**
+             * User-specified key/value pairs for the resource. Individual keys can be removed
+             * by setting the value to `null`, and the entire metadata mapping can be cleared
+             * by setting `metadata` to `null`.
+             */
+            metadata?: {
+                [key: string]: string | null;
+            } | null;
+            /**
+             * A transient ID that can be used to reference this price when adding adjustments
+             * in the same API call.
+             */
+            reference_id?: string | null;
+        }
+        namespace NewSubscriptionTieredWithProrationPrice {
+            /**
+             * Configuration for tiered_with_proration pricing
+             */
+            interface TieredWithProrationConfig {
                 /**
-                 * Configuration for a single bulk pricing tier
+                 * Tiers for rating based on total usage quantities into the specified tier with
+                 * proration
+                 */
+                tiers: Array<TieredWithProrationConfig.Tier>;
+            }
+            namespace TieredWithProrationConfig {
+                /**
+                 * Configuration for a single tiered with proration tier
                  */
                 interface Tier {
                     /**
-                     * Amount per unit
+                     * Inclusive tier starting value
                      */
-                    unit_amount: string;
+                    tier_lower_bound: string;
                     /**
-                     * The lower bound for this tier
+                     * Amount per unit
                      */
-                    tier_lower_bound?: string | null;
+                    unit_amount: string;
                 }
             }
         }
-        interface NewSubscriptionTieredWithProrationPrice {
+        interface NewSubscriptionGroupedWithMinMaxThresholdsPrice {
+            /**
+             * The cadence to bill for this price on.
+             */
+            cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+            /**
+             * Configuration for grouped_with_min_max_thresholds pricing
+             */
+            grouped_with_min_max_thresholds_config: NewSubscriptionGroupedWithMinMaxThresholdsPrice.GroupedWithMinMaxThresholdsConfig;
+            /**
+             * The id of the item the price will be associated with.
+             */
+            item_id: string;
+            /**
+             * The pricing model type
+             */
+            model_type: 'grouped_with_min_max_thresholds';
+            /**
+             * The name of the price.
+             */
+            name: string;
+            /**
+             * The id of the billable metric for the price. Only needed if the price is
+             * usage-based.
+             */
+            billable_metric_id?: string | null;
+            /**
+             * If the Price represents a fixed cost, the price will be billed in-advance if
+             * this is true, and in-arrears if this is false.
+             */
+            billed_in_advance?: boolean | null;
+            /**
+             * For custom cadence: specifies the duration of the billing period in days or
+             * months.
+             */
+            billing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+            /**
+             * The per unit conversion rate of the price currency to the invoicing currency.
+             */
+            conversion_rate?: number | null;
+            /**
+             * The configuration for the rate of the price currency to the invoicing currency.
+             */
+            conversion_rate_config?: Shared.UnitConversionRateConfig | Shared.TieredConversionRateConfig | null;
+            /**
+             * An ISO 4217 currency string, or custom pricing unit identifier, in which this
+             * price is billed.
+             */
+            currency?: string | null;
+            /**
+             * For dimensional price: specifies a price group and dimension values
+             */
+            dimensional_price_configuration?: Shared.NewDimensionalPriceConfiguration | null;
+            /**
+             * An alias for the price.
+             */
+            external_price_id?: string | null;
+            /**
+             * If the Price represents a fixed cost, this represents the quantity of units
+             * applied.
+             */
+            fixed_price_quantity?: number | null;
+            /**
+             * The property used to group this price on an invoice
+             */
+            invoice_grouping_key?: string | null;
+            /**
+             * Within each billing cycle, specifies the cadence at which invoices are produced.
+             * If unspecified, a single invoice is produced per billing cycle.
+             */
+            invoicing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+            /**
+             * The ID of the license type to associate with this price.
+             */
+            license_type_id?: string | null;
+            /**
+             * User-specified key/value pairs for the resource. Individual keys can be removed
+             * by setting the value to `null`, and the entire metadata mapping can be cleared
+             * by setting `metadata` to `null`.
+             */
+            metadata?: {
+                [key: string]: string | null;
+            } | null;
+            /**
+             * A transient ID that can be used to reference this price when adding adjustments
+             * in the same API call.
+             */
+            reference_id?: string | null;
+        }
+        namespace NewSubscriptionGroupedWithMinMaxThresholdsPrice {
+            /**
+             * Configuration for grouped_with_min_max_thresholds pricing
+             */
+            interface GroupedWithMinMaxThresholdsConfig {
+                /**
+                 * The event property used to group before applying thresholds
+                 */
+                grouping_key: string;
+                /**
+                 * The maximum amount to charge each group
+                 */
+                maximum_charge: string;
+                /**
+                 * The minimum amount to charge each group, regardless of usage
+                 */
+                minimum_charge: string;
+                /**
+                 * The base price charged per group
+                 */
+                per_unit_rate: string;
+            }
+        }
+        interface NewSubscriptionCumulativeGroupedAllocationPrice {
             /**
              * The cadence to bill for this price on.
              */
             cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+            /**
+             * Configuration for cumulative_grouped_allocation pricing
+             */
+            cumulative_grouped_allocation_config: NewSubscriptionCumulativeGroupedAllocationPrice.CumulativeGroupedAllocationConfig;
             /**
              * The id of the item the price will be associated with.
              */
@@ -6853,15 +8944,11 @@ export declare namespace SubscriptionSchedulePlanChangeParams {
             /**
              * The pricing model type
              */
-            model_type: 'tiered_with_proration';
+            model_type: 'cumulative_grouped_allocation';
             /**
              * The name of the price.
              */
             name: string;
-            /**
-             * Configuration for tiered_with_proration pricing
-             */
-            tiered_with_proration_config: NewSubscriptionTieredWithProrationPrice.TieredWithProrationConfig;
             /**
              * The id of the billable metric for the price. Only needed if the price is
              * usage-based.
@@ -6930,42 +9017,38 @@ export declare namespace SubscriptionSchedulePlanChangeParams {
              */
             reference_id?: string | null;
         }
-        namespace NewSubscriptionTieredWithProrationPrice {
+        namespace NewSubscriptionCumulativeGroupedAllocationPrice {
             /**
-             * Configuration for tiered_with_proration pricing
+             * Configuration for cumulative_grouped_allocation pricing
              */
-            interface TieredWithProrationConfig {
+            interface CumulativeGroupedAllocationConfig {
                 /**
-                 * Tiers for rating based on total usage quantities into the specified tier with
-                 * proration
+                 * The overall allocation across all groups
                  */
-                tiers: Array<TieredWithProrationConfig.Tier>;
-            }
-            namespace TieredWithProrationConfig {
+                cumulative_allocation: string;
                 /**
-                 * Configuration for a single tiered with proration tier
+                 * The allocation per individual group
                  */
-                interface Tier {
-                    /**
-                     * Inclusive tier starting value
-                     */
-                    tier_lower_bound: string;
-                    /**
-                     * Amount per unit
-                     */
-                    unit_amount: string;
-                }
+                group_allocation: string;
+                /**
+                 * The event property used to group usage before applying allocations
+                 */
+                grouping_key: string;
+                /**
+                 * The amount to charge for each unit outside of the allocation
+                 */
+                unit_amount: string;
             }
         }
-        interface NewSubscriptionGroupedWithMinMaxThresholdsPrice {
+        interface NewSubscriptionDailyCreditAllowancePrice {
             /**
              * The cadence to bill for this price on.
              */
             cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
             /**
-             * Configuration for grouped_with_min_max_thresholds pricing
+             * Configuration for daily_credit_allowance pricing
              */
-            grouped_with_min_max_thresholds_config: NewSubscriptionGroupedWithMinMaxThresholdsPrice.GroupedWithMinMaxThresholdsConfig;
+            daily_credit_allowance_config: NewSubscriptionDailyCreditAllowancePrice.DailyCreditAllowanceConfig;
             /**
              * The id of the item the price will be associated with.
              */
@@ -6973,7 +9056,7 @@ export declare namespace SubscriptionSchedulePlanChangeParams {
             /**
              * The pricing model type
              */
-            model_type: 'grouped_with_min_max_thresholds';
+            model_type: 'daily_credit_allowance';
             /**
              * The name of the price.
              */
@@ -7046,46 +9129,69 @@ export declare namespace SubscriptionSchedulePlanChangeParams {
              */
             reference_id?: string | null;
         }
-        namespace NewSubscriptionGroupedWithMinMaxThresholdsPrice {
+        namespace NewSubscriptionDailyCreditAllowancePrice {
             /**
-             * Configuration for grouped_with_min_max_thresholds pricing
+             * Configuration for daily_credit_allowance pricing
              */
-            interface GroupedWithMinMaxThresholdsConfig {
+            interface DailyCreditAllowanceConfig {
                 /**
-                 * The event property used to group before applying thresholds
+                 * Credits granted per day. Lose-it-or-use-it; does not roll over.
                  */
-                grouping_key: string;
+                daily_allowance: string;
                 /**
-                 * The maximum amount to charge each group
+                 * Default per-unit credit rate for any usage not bucketed into a specified
+                 * matrix_value
                  */
-                maximum_charge: string;
+                default_unit_amount: string;
                 /**
-                 * The minimum amount to charge each group, regardless of usage
+                 * One or two event property values to evaluate matrix groups by
                  */
-                minimum_charge: string;
+                dimensions: Array<string | null>;
                 /**
-                 * The base price charged per group
+                 * Event property whose value identifies the day bucket the event belongs to (e.g.
+                 * 'event_day' set to an ISO date string in the customer's timezone). The allowance
+                 * resets per distinct value of this property.
                  */
-                per_unit_rate: string;
+                event_day_property: string;
+                /**
+                 * Per-dimension credit rates
+                 */
+                matrix_values: Array<DailyCreditAllowanceConfig.MatrixValue>;
+            }
+            namespace DailyCreditAllowanceConfig {
+                /**
+                 * Per-dimension credit price for the daily credit allowance model.
+                 */
+                interface MatrixValue {
+                    /**
+                     * One or two matrix keys to filter usage to this value by. For example, ["model"]
+                     * could be used to apply a different credit rate to each AI model.
+                     */
+                    dimension_values: Array<string | null>;
+                    /**
+                     * Credits charged per unit of usage matching the specified dimension_values
+                     */
+                    unit_amount: string;
+                }
             }
         }
-        interface NewSubscriptionCumulativeGroupedAllocationPrice {
+        interface NewSubscriptionMeteredAllowancePrice {
             /**
              * The cadence to bill for this price on.
              */
             cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
-            /**
-             * Configuration for cumulative_grouped_allocation pricing
-             */
-            cumulative_grouped_allocation_config: NewSubscriptionCumulativeGroupedAllocationPrice.CumulativeGroupedAllocationConfig;
             /**
              * The id of the item the price will be associated with.
              */
             item_id: string;
+            /**
+             * Configuration for metered_allowance pricing
+             */
+            metered_allowance_config: NewSubscriptionMeteredAllowancePrice.MeteredAllowanceConfig;
             /**
              * The pricing model type
              */
-            model_type: 'cumulative_grouped_allocation';
+            model_type: 'metered_allowance';
             /**
              * The name of the price.
              */
@@ -7158,27 +9264,40 @@ export declare namespace SubscriptionSchedulePlanChangeParams {
              */
             reference_id?: string | null;
         }
-        namespace NewSubscriptionCumulativeGroupedAllocationPrice {
+        namespace NewSubscriptionMeteredAllowancePrice {
             /**
-             * Configuration for cumulative_grouped_allocation pricing
+             * Configuration for metered_allowance pricing
              */
-            interface CumulativeGroupedAllocationConfig {
+            interface MeteredAllowanceConfig {
                 /**
-                 * The overall allocation across all groups
+                 * The grouping_key value whose summed quantity represents the allowance for this
+                 * period (e.g. 'storage_snapshot' emitting 3 × avg storage). Capped at consumption
+                 * — credit can never exceed actual usage.
                  */
-                cumulative_allocation: string;
+                allowance_grouping_value: string;
                 /**
-                 * The allocation per individual group
+                 * The grouping_key value whose summed quantity represents consumption (e.g.
+                 * 'download'). Charged at unit_amount.
                  */
-                group_allocation: string;
+                consumption_grouping_value: string;
                 /**
-                 * The event property used to group usage before applying allocations
+                 * Event property used to partition the metric into consumption and allowance
+                 * quantities (e.g. 'event_name'). The metric is queried with this key and the two
+                 * values below select which partition is which.
                  */
                 grouping_key: string;
                 /**
-                 * The amount to charge for each unit outside of the allocation
+                 * Per-unit price applied to gross consumption and to the allowance credit.
                  */
                 unit_amount: string;
+                /**
+                 * Sub-line label for the credit row (e.g. 'Up to 3x free egress').
+                 */
+                allowance_display_name?: string;
+                /**
+                 * Sub-line label for the gross consumption row (e.g. 'bytes gotten').
+                 */
+                consumption_display_name?: string;
             }
         }
         interface NewSubscriptionPercentCompositePrice {
@@ -7276,9 +9395,23 @@ export declare namespace SubscriptionSchedulePlanChangeParams {
              */
             interface PercentConfig {
                 /**
-                 * What percent of the component subtotals to charge
+                 * Fraction of the component subtotals to charge (0 < percent <= 1).
                  */
                 percent: number;
+                /**
+                 * Maximum amount to charge. If unset, the fee has no upper bound.
+                 */
+                maximum_amount?: string | null;
+                /**
+                 * Minimum amount to charge. If unset, the fee is bounded below by 0.
+                 */
+                minimum_amount?: string | null;
+                /**
+                 * If true, the minimum_amount is prorated based on the service period. The
+                 * maximum_amount is an absolute cap (never prorated), and the percent applied to
+                 * upstream subtotals is never prorated either.
+                 */
+                prorated?: boolean;
             }
         }
         interface NewSubscriptionEventOutputPrice {
@@ -7413,12 +9546,77 @@ export declare namespace SubscriptionSchedulePlanChangeParams {
         /**
          * The definition of a new adjustment to create and add to the subscription.
          */
-        adjustment: Shared.NewPercentageDiscount | Shared.NewUsageDiscount | Shared.NewAmountDiscount | Shared.NewMinimum | Shared.NewMaximum;
+        adjustment: Shared.NewPercentageDiscount | Shared.NewUsageDiscount | Shared.NewAmountDiscount | Shared.NewMinimum | Shared.NewMaximum | ReplaceAdjustment.NewTieredPercentageDiscount;
         /**
          * The id of the adjustment on the plan to replace in the subscription.
          */
         replaces_adjustment_id: string;
     }
+    namespace ReplaceAdjustment {
+        interface NewTieredPercentageDiscount {
+            adjustment_type: 'tiered_percentage_discount';
+            tiers: Array<NewTieredPercentageDiscount.Tier>;
+            /**
+             * If set, the adjustment will apply to every price on the subscription.
+             */
+            applies_to_all?: true | null;
+            /**
+             * The set of item IDs to which this adjustment applies.
+             */
+            applies_to_item_ids?: Array<string> | null;
+            /**
+             * The set of price IDs to which this adjustment applies.
+             */
+            applies_to_price_ids?: Array<string> | null;
+            /**
+             * If set, only prices in the specified currency will have the adjustment applied.
+             */
+            currency?: string | null;
+            /**
+             * A list of filters that determine which prices this adjustment will apply to.
+             */
+            filters?: Array<NewTieredPercentageDiscount.Filter> | null;
+            /**
+             * When false, this adjustment will be applied to a single price. Otherwise, it
+             * will be applied at the invoice level, possibly to multiple prices.
+             */
+            is_invoice_level?: boolean;
+            /**
+             * If set, only prices of the specified type will have the adjustment applied.
+             */
+            price_type?: 'usage' | 'fixed_in_advance' | 'fixed_in_arrears' | 'fixed' | 'in_arrears' | null;
+        }
+        namespace NewTieredPercentageDiscount {
+            interface Tier {
+                /**
+                 * Exclusive lower bound of cumulative spend for this tier.
+                 */
+                lower_bound: number;
+                /**
+                 * The percentage (0-1) discounted from spend in this tier.
+                 */
+                percentage: number;
+                /**
+                 * Inclusive upper bound of cumulative spend; null for the final open-ended tier.
+                 */
+                upper_bound?: number | null;
+            }
+            interface Filter {
+                /**
+                 * The property of the price to filter on.
+                 */
+                field: 'price_id' | 'item_id' | 'price_type' | 'currency' | 'pricing_unit_id';
+                /**
+                 * Should prices that match the filter be included or excluded.
+                 */
+                operator: 'includes' | 'excludes';
+                /**
+                 * The IDs or values that match this filter.
+                 */
+                values: Array<string>;
+            }
+        }
+    }
     interface ReplacePrice {
         /**
          * The id of the price on the plan to replace in the subscription.
@@ -7461,7 +9659,7 @@ export declare namespace SubscriptionSchedulePlanChangeParams {
         /**
          * New subscription price request body params.
          */
-        price?: SubscriptionsAPI.NewSubscriptionUnitPrice | SubscriptionsAPI.NewSubscriptionTieredPrice | SubscriptionsAPI.NewSubscriptionBulkPrice | ReplacePrice.NewSubscriptionBulkWithFiltersPrice | SubscriptionsAPI.NewSubscriptionPackagePrice | SubscriptionsAPI.NewSubscriptionMatrixPrice | SubscriptionsAPI.NewSubscriptionThresholdTotalAmountPrice | SubscriptionsAPI.NewSubscriptionTieredPackagePrice | SubscriptionsAPI.NewSubscriptionTieredWithMinimumPrice | SubscriptionsAPI.NewSubscriptionGroupedTieredPrice | SubscriptionsAPI.NewSubscriptionTieredPackageWithMinimumPrice | SubscriptionsAPI.NewSubscriptionPackageWithAllocationPrice | SubscriptionsAPI.NewSubscriptionUnitWithPercentPrice | SubscriptionsAPI.NewSubscriptionMatrixWithAllocationPrice | ReplacePrice.NewSubscriptionTieredWithProrationPrice | SubscriptionsAPI.NewSubscriptionUnitWithProrationPrice | SubscriptionsAPI.NewSubscriptionGroupedAllocationPrice | SubscriptionsAPI.NewSubscriptionBulkWithProrationPrice | SubscriptionsAPI.NewSubscriptionGroupedWithProratedMinimumPrice | SubscriptionsAPI.NewSubscriptionGroupedWithMeteredMinimumPrice | ReplacePrice.NewSubscriptionGroupedWithMinMaxThresholdsPrice | SubscriptionsAPI.NewSubscriptionMatrixWithDisplayNamePrice | SubscriptionsAPI.NewSubscriptionGroupedTieredPackagePrice | SubscriptionsAPI.NewSubscriptionMaxGroupTieredPackagePrice | SubscriptionsAPI.NewSubscriptionScalableMatrixWithUnitPricingPrice | SubscriptionsAPI.NewSubscriptionScalableMatrixWithTieredPricingPrice | SubscriptionsAPI.NewSubscriptionCumulativeGroupedBulkPrice | ReplacePrice.NewSubscriptionCumulativeGroupedAllocationPrice | SubscriptionsAPI.NewSubscriptionMinimumCompositePrice | ReplacePrice.NewSubscriptionPercentCompositePrice | ReplacePrice.NewSubscriptionEventOutputPrice | null;
+        price?: SubscriptionsAPI.NewSubscriptionUnitPrice | SubscriptionsAPI.NewSubscriptionTieredPrice | SubscriptionsAPI.NewSubscriptionBulkPrice | ReplacePrice.NewSubscriptionBulkWithFiltersPrice | SubscriptionsAPI.NewSubscriptionPackagePrice | SubscriptionsAPI.NewSubscriptionMatrixPrice | SubscriptionsAPI.NewSubscriptionThresholdTotalAmountPrice | SubscriptionsAPI.NewSubscriptionTieredPackagePrice | SubscriptionsAPI.NewSubscriptionTieredWithMinimumPrice | SubscriptionsAPI.NewSubscriptionGroupedTieredPrice | SubscriptionsAPI.NewSubscriptionTieredPackageWithMinimumPrice | SubscriptionsAPI.NewSubscriptionPackageWithAllocationPrice | SubscriptionsAPI.NewSubscriptionUnitWithPercentPrice | SubscriptionsAPI.NewSubscriptionMatrixWithAllocationPrice | ReplacePrice.NewSubscriptionMatrixWithThresholdDiscountsPrice | ReplacePrice.NewSubscriptionTieredWithProrationPrice | SubscriptionsAPI.NewSubscriptionUnitWithProrationPrice | SubscriptionsAPI.NewSubscriptionGroupedAllocationPrice | SubscriptionsAPI.NewSubscriptionBulkWithProrationPrice | SubscriptionsAPI.NewSubscriptionGroupedWithProratedMinimumPrice | SubscriptionsAPI.NewSubscriptionGroupedWithMeteredMinimumPrice | ReplacePrice.NewSubscriptionGroupedWithMinMaxThresholdsPrice | SubscriptionsAPI.NewSubscriptionMatrixWithDisplayNamePrice | SubscriptionsAPI.NewSubscriptionGroupedTieredPackagePrice | SubscriptionsAPI.NewSubscriptionMaxGroupTieredPackagePrice | SubscriptionsAPI.NewSubscriptionScalableMatrixWithUnitPricingPrice | SubscriptionsAPI.NewSubscriptionScalableMatrixWithTieredPricingPrice | SubscriptionsAPI.NewSubscriptionCumulativeGroupedBulkPrice | ReplacePrice.NewSubscriptionCumulativeGroupedAllocationPrice | ReplacePrice.NewSubscriptionDailyCreditAllowancePrice | ReplacePrice.NewSubscriptionMeteredAllowancePrice | SubscriptionsAPI.NewSubscriptionMinimumCompositePrice | ReplacePrice.NewSubscriptionPercentCompositePrice | ReplacePrice.NewSubscriptionEventOutputPrice | null;
         /**
          * The id of the price to add to the subscription.
          */
@@ -7484,7 +9682,139 @@ export declare namespace SubscriptionSchedulePlanChangeParams {
             /**
              * The pricing model type
              */
-            model_type: 'bulk_with_filters';
+            model_type: 'bulk_with_filters';
+            /**
+             * The name of the price.
+             */
+            name: string;
+            /**
+             * The id of the billable metric for the price. Only needed if the price is
+             * usage-based.
+             */
+            billable_metric_id?: string | null;
+            /**
+             * If the Price represents a fixed cost, the price will be billed in-advance if
+             * this is true, and in-arrears if this is false.
+             */
+            billed_in_advance?: boolean | null;
+            /**
+             * For custom cadence: specifies the duration of the billing period in days or
+             * months.
+             */
+            billing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+            /**
+             * The per unit conversion rate of the price currency to the invoicing currency.
+             */
+            conversion_rate?: number | null;
+            /**
+             * The configuration for the rate of the price currency to the invoicing currency.
+             */
+            conversion_rate_config?: Shared.UnitConversionRateConfig | Shared.TieredConversionRateConfig | null;
+            /**
+             * An ISO 4217 currency string, or custom pricing unit identifier, in which this
+             * price is billed.
+             */
+            currency?: string | null;
+            /**
+             * For dimensional price: specifies a price group and dimension values
+             */
+            dimensional_price_configuration?: Shared.NewDimensionalPriceConfiguration | null;
+            /**
+             * An alias for the price.
+             */
+            external_price_id?: string | null;
+            /**
+             * If the Price represents a fixed cost, this represents the quantity of units
+             * applied.
+             */
+            fixed_price_quantity?: number | null;
+            /**
+             * The property used to group this price on an invoice
+             */
+            invoice_grouping_key?: string | null;
+            /**
+             * Within each billing cycle, specifies the cadence at which invoices are produced.
+             * If unspecified, a single invoice is produced per billing cycle.
+             */
+            invoicing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+            /**
+             * The ID of the license type to associate with this price.
+             */
+            license_type_id?: string | null;
+            /**
+             * User-specified key/value pairs for the resource. Individual keys can be removed
+             * by setting the value to `null`, and the entire metadata mapping can be cleared
+             * by setting `metadata` to `null`.
+             */
+            metadata?: {
+                [key: string]: string | null;
+            } | null;
+            /**
+             * A transient ID that can be used to reference this price when adding adjustments
+             * in the same API call.
+             */
+            reference_id?: string | null;
+        }
+        namespace NewSubscriptionBulkWithFiltersPrice {
+            /**
+             * Configuration for bulk_with_filters pricing
+             */
+            interface BulkWithFiltersConfig {
+                /**
+                 * Property filters to apply (all must match)
+                 */
+                filters: Array<BulkWithFiltersConfig.Filter>;
+                /**
+                 * Bulk tiers for rating based on total usage volume
+                 */
+                tiers: Array<BulkWithFiltersConfig.Tier>;
+            }
+            namespace BulkWithFiltersConfig {
+                /**
+                 * Configuration for a single property filter
+                 */
+                interface Filter {
+                    /**
+                     * Event property key to filter on
+                     */
+                    property_key: string;
+                    /**
+                     * Event property value to match
+                     */
+                    property_value: string;
+                }
+                /**
+                 * Configuration for a single bulk pricing tier
+                 */
+                interface Tier {
+                    /**
+                     * Amount per unit
+                     */
+                    unit_amount: string;
+                    /**
+                     * The lower bound for this tier
+                     */
+                    tier_lower_bound?: string | null;
+                }
+            }
+        }
+        interface NewSubscriptionMatrixWithThresholdDiscountsPrice {
+            /**
+             * The cadence to bill for this price on.
+             */
+            cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+            /**
+             * The id of the item the price will be associated with.
+             */
+            item_id: string;
+            /**
+             * Configuration for matrix_with_threshold_discounts pricing
+             */
+            matrix_with_threshold_discounts_config: NewSubscriptionMatrixWithThresholdDiscountsPrice.MatrixWithThresholdDiscountsConfig;
+            /**
+             * The pricing model type
+             */
+            model_type: 'matrix_with_threshold_discounts';
             /**
              * The name of the price.
              */
@@ -7557,46 +9887,53 @@ export declare namespace SubscriptionSchedulePlanChangeParams {
              */
             reference_id?: string | null;
         }
-        namespace NewSubscriptionBulkWithFiltersPrice {
+        namespace NewSubscriptionMatrixWithThresholdDiscountsPrice {
             /**
-             * Configuration for bulk_with_filters pricing
+             * Configuration for matrix_with_threshold_discounts pricing
              */
-            interface BulkWithFiltersConfig {
+            interface MatrixWithThresholdDiscountsConfig {
                 /**
-                 * Property filters to apply (all must match)
+                 * Unit price used for usage that does not match any defined matrix cell.
                  */
-                filters: Array<BulkWithFiltersConfig.Filter>;
+                default_unit_amount: string;
                 /**
-                 * Bulk tiers for rating based on total usage volume
+                 * First matrix dimension key.
                  */
-                tiers: Array<BulkWithFiltersConfig.Tier>;
-            }
-            namespace BulkWithFiltersConfig {
+                first_dimension: string;
                 /**
-                 * Configuration for a single property filter
+                 * Per-cell unit prices.
                  */
-                interface Filter {
-                    /**
-                     * Event property key to filter on
-                     */
-                    property_key: string;
-                    /**
-                     * Event property value to match
-                     */
-                    property_value: string;
-                }
+                matrix_values: Array<MatrixWithThresholdDiscountsConfig.MatrixValue>;
                 /**
-                 * Configuration for a single bulk pricing tier
+                 * Optional second matrix dimension key.
                  */
-                interface Tier {
+                second_dimension?: string | null;
+                threshold_discount_groups?: Array<MatrixWithThresholdDiscountsConfig.ThresholdDiscountGroup>;
+            }
+            namespace MatrixWithThresholdDiscountsConfig {
+                interface MatrixValue {
+                    first_dimension_value: string;
+                    unit_amount: string;
+                    second_dimension_value?: string | null;
+                }
+                interface ThresholdDiscountGroup {
                     /**
-                     * Amount per unit
+                     * Discount rate applied to spend above the threshold.
                      */
-                    unit_amount: string;
+                    above_threshold_discount_percentage: string;
                     /**
-                     * The lower bound for this tier
+                     * Discount rate applied to spend at or below the threshold. Set to 0 for no
+                     * baseline discount.
                      */
-                    tier_lower_bound?: string | null;
+                    below_threshold_discount_percentage: string;
+                    /**
+                     * Semicolon-separated list of matrix cell coordinates targeted by this group. Each
+                     * coordinate is `first,second` when the matrix has two dimensions, or just `first`
+                     * for a single-dimension matrix. Example: `blue,circle;green,triangle`.
+                     */
+                    cell_coordinates: string;
+                    threshold_amount: string;
+                    description?: string | null;
                 }
             }
         }
@@ -7940,6 +10277,266 @@ export declare namespace SubscriptionSchedulePlanChangeParams {
                 unit_amount: string;
             }
         }
+        interface NewSubscriptionDailyCreditAllowancePrice {
+            /**
+             * The cadence to bill for this price on.
+             */
+            cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+            /**
+             * Configuration for daily_credit_allowance pricing
+             */
+            daily_credit_allowance_config: NewSubscriptionDailyCreditAllowancePrice.DailyCreditAllowanceConfig;
+            /**
+             * The id of the item the price will be associated with.
+             */
+            item_id: string;
+            /**
+             * The pricing model type
+             */
+            model_type: 'daily_credit_allowance';
+            /**
+             * The name of the price.
+             */
+            name: string;
+            /**
+             * The id of the billable metric for the price. Only needed if the price is
+             * usage-based.
+             */
+            billable_metric_id?: string | null;
+            /**
+             * If the Price represents a fixed cost, the price will be billed in-advance if
+             * this is true, and in-arrears if this is false.
+             */
+            billed_in_advance?: boolean | null;
+            /**
+             * For custom cadence: specifies the duration of the billing period in days or
+             * months.
+             */
+            billing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+            /**
+             * The per unit conversion rate of the price currency to the invoicing currency.
+             */
+            conversion_rate?: number | null;
+            /**
+             * The configuration for the rate of the price currency to the invoicing currency.
+             */
+            conversion_rate_config?: Shared.UnitConversionRateConfig | Shared.TieredConversionRateConfig | null;
+            /**
+             * An ISO 4217 currency string, or custom pricing unit identifier, in which this
+             * price is billed.
+             */
+            currency?: string | null;
+            /**
+             * For dimensional price: specifies a price group and dimension values
+             */
+            dimensional_price_configuration?: Shared.NewDimensionalPriceConfiguration | null;
+            /**
+             * An alias for the price.
+             */
+            external_price_id?: string | null;
+            /**
+             * If the Price represents a fixed cost, this represents the quantity of units
+             * applied.
+             */
+            fixed_price_quantity?: number | null;
+            /**
+             * The property used to group this price on an invoice
+             */
+            invoice_grouping_key?: string | null;
+            /**
+             * Within each billing cycle, specifies the cadence at which invoices are produced.
+             * If unspecified, a single invoice is produced per billing cycle.
+             */
+            invoicing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+            /**
+             * The ID of the license type to associate with this price.
+             */
+            license_type_id?: string | null;
+            /**
+             * User-specified key/value pairs for the resource. Individual keys can be removed
+             * by setting the value to `null`, and the entire metadata mapping can be cleared
+             * by setting `metadata` to `null`.
+             */
+            metadata?: {
+                [key: string]: string | null;
+            } | null;
+            /**
+             * A transient ID that can be used to reference this price when adding adjustments
+             * in the same API call.
+             */
+            reference_id?: string | null;
+        }
+        namespace NewSubscriptionDailyCreditAllowancePrice {
+            /**
+             * Configuration for daily_credit_allowance pricing
+             */
+            interface DailyCreditAllowanceConfig {
+                /**
+                 * Credits granted per day. Lose-it-or-use-it; does not roll over.
+                 */
+                daily_allowance: string;
+                /**
+                 * Default per-unit credit rate for any usage not bucketed into a specified
+                 * matrix_value
+                 */
+                default_unit_amount: string;
+                /**
+                 * One or two event property values to evaluate matrix groups by
+                 */
+                dimensions: Array<string | null>;
+                /**
+                 * Event property whose value identifies the day bucket the event belongs to (e.g.
+                 * 'event_day' set to an ISO date string in the customer's timezone). The allowance
+                 * resets per distinct value of this property.
+                 */
+                event_day_property: string;
+                /**
+                 * Per-dimension credit rates
+                 */
+                matrix_values: Array<DailyCreditAllowanceConfig.MatrixValue>;
+            }
+            namespace DailyCreditAllowanceConfig {
+                /**
+                 * Per-dimension credit price for the daily credit allowance model.
+                 */
+                interface MatrixValue {
+                    /**
+                     * One or two matrix keys to filter usage to this value by. For example, ["model"]
+                     * could be used to apply a different credit rate to each AI model.
+                     */
+                    dimension_values: Array<string | null>;
+                    /**
+                     * Credits charged per unit of usage matching the specified dimension_values
+                     */
+                    unit_amount: string;
+                }
+            }
+        }
+        interface NewSubscriptionMeteredAllowancePrice {
+            /**
+             * The cadence to bill for this price on.
+             */
+            cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+            /**
+             * The id of the item the price will be associated with.
+             */
+            item_id: string;
+            /**
+             * Configuration for metered_allowance pricing
+             */
+            metered_allowance_config: NewSubscriptionMeteredAllowancePrice.MeteredAllowanceConfig;
+            /**
+             * The pricing model type
+             */
+            model_type: 'metered_allowance';
+            /**
+             * The name of the price.
+             */
+            name: string;
+            /**
+             * The id of the billable metric for the price. Only needed if the price is
+             * usage-based.
+             */
+            billable_metric_id?: string | null;
+            /**
+             * If the Price represents a fixed cost, the price will be billed in-advance if
+             * this is true, and in-arrears if this is false.
+             */
+            billed_in_advance?: boolean | null;
+            /**
+             * For custom cadence: specifies the duration of the billing period in days or
+             * months.
+             */
+            billing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+            /**
+             * The per unit conversion rate of the price currency to the invoicing currency.
+             */
+            conversion_rate?: number | null;
+            /**
+             * The configuration for the rate of the price currency to the invoicing currency.
+             */
+            conversion_rate_config?: Shared.UnitConversionRateConfig | Shared.TieredConversionRateConfig | null;
+            /**
+             * An ISO 4217 currency string, or custom pricing unit identifier, in which this
+             * price is billed.
+             */
+            currency?: string | null;
+            /**
+             * For dimensional price: specifies a price group and dimension values
+             */
+            dimensional_price_configuration?: Shared.NewDimensionalPriceConfiguration | null;
+            /**
+             * An alias for the price.
+             */
+            external_price_id?: string | null;
+            /**
+             * If the Price represents a fixed cost, this represents the quantity of units
+             * applied.
+             */
+            fixed_price_quantity?: number | null;
+            /**
+             * The property used to group this price on an invoice
+             */
+            invoice_grouping_key?: string | null;
+            /**
+             * Within each billing cycle, specifies the cadence at which invoices are produced.
+             * If unspecified, a single invoice is produced per billing cycle.
+             */
+            invoicing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+            /**
+             * The ID of the license type to associate with this price.
+             */
+            license_type_id?: string | null;
+            /**
+             * User-specified key/value pairs for the resource. Individual keys can be removed
+             * by setting the value to `null`, and the entire metadata mapping can be cleared
+             * by setting `metadata` to `null`.
+             */
+            metadata?: {
+                [key: string]: string | null;
+            } | null;
+            /**
+             * A transient ID that can be used to reference this price when adding adjustments
+             * in the same API call.
+             */
+            reference_id?: string | null;
+        }
+        namespace NewSubscriptionMeteredAllowancePrice {
+            /**
+             * Configuration for metered_allowance pricing
+             */
+            interface MeteredAllowanceConfig {
+                /**
+                 * The grouping_key value whose summed quantity represents the allowance for this
+                 * period (e.g. 'storage_snapshot' emitting 3 × avg storage). Capped at consumption
+                 * — credit can never exceed actual usage.
+                 */
+                allowance_grouping_value: string;
+                /**
+                 * The grouping_key value whose summed quantity represents consumption (e.g.
+                 * 'download'). Charged at unit_amount.
+                 */
+                consumption_grouping_value: string;
+                /**
+                 * Event property used to partition the metric into consumption and allowance
+                 * quantities (e.g. 'event_name'). The metric is queried with this key and the two
+                 * values below select which partition is which.
+                 */
+                grouping_key: string;
+                /**
+                 * Per-unit price applied to gross consumption and to the allowance credit.
+                 */
+                unit_amount: string;
+                /**
+                 * Sub-line label for the credit row (e.g. 'Up to 3x free egress').
+                 */
+                allowance_display_name?: string;
+                /**
+                 * Sub-line label for the gross consumption row (e.g. 'bytes gotten').
+                 */
+                consumption_display_name?: string;
+            }
+        }
         interface NewSubscriptionPercentCompositePrice {
             /**
              * The cadence to bill for this price on.
@@ -8035,9 +10632,23 @@ export declare namespace SubscriptionSchedulePlanChangeParams {
              */
             interface PercentConfig {
                 /**
-                 * What percent of the component subtotals to charge
+                 * Fraction of the component subtotals to charge (0 < percent <= 1).
                  */
                 percent: number;
+                /**
+                 * Maximum amount to charge. If unset, the fee has no upper bound.
+                 */
+                maximum_amount?: string | null;
+                /**
+                 * Minimum amount to charge. If unset, the fee is bounded below by 0.
+                 */
+                minimum_amount?: string | null;
+                /**
+                 * If true, the minimum_amount is prorated based on the service period. The
+                 * maximum_amount is an absolute cap (never prorated), and the percent applied to
+                 * upstream subtotals is never prorated either.
+                 */
+                prorated?: boolean;
             }
         }
         interface NewSubscriptionEventOutputPrice {