orb-billing 5.48.0 → 5.76.0

package/src/resources/prices/prices.ts

@@ -33,6 +33,18 @@ export class Prices extends APIResource {
    *
    * See the [Price resource](/product-catalog/price-configuration) for the
    * specification of different price model configurations possible in this endpoint.
+   *
+   * @example
+   * ```ts
+   * const price = await client.prices.create({
+   *   cadence: 'annual',
+   *   currency: 'currency',
+   *   item_id: 'item_id',
+   *   model_type: 'unit',
+   *   name: 'Annual fee',
+   *   unit_config: { unit_amount: 'unit_amount' },
+   * });
+   * ```
    */
   create(body: PriceCreateParams, options?: Core.RequestOptions): Core.APIPromise<Shared.Price> {
     return this._client.post('/prices', { body, ...options });
@@ -42,6 +54,11 @@ export class Prices extends APIResource {
    * This endpoint allows you to update the `metadata` property on a price. If you
    * pass null for the metadata value, it will clear any existing metadata for that
    * price.
+   *
+   * @example
+   * ```ts
+   * const price = await client.prices.update('price_id');
+   * ```
    */
   update(
     priceId: string,
@@ -54,6 +71,14 @@ export class Prices extends APIResource {
   /**
    * This endpoint is used to list all add-on prices created using the
    * [price creation endpoint](/api-reference/price/create-price).
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const price of client.prices.list()) {
+   *   // ...
+   * }
+   * ```
    */
   list(query?: PriceListParams, options?: Core.RequestOptions): Core.PagePromise<PricesPage, Shared.Price>;
   list(options?: Core.RequestOptions): Core.PagePromise<PricesPage, Shared.Price>;
@@ -93,6 +118,14 @@ export class Prices extends APIResource {
    * the length of the results must be no greater than 1000. Note that this is a POST
    * endpoint rather than a GET endpoint because it employs a JSON body rather than
    * query parameters.
+   *
+   * @example
+   * ```ts
+   * const response = await client.prices.evaluate('price_id', {
+   *   timeframe_end: '2019-12-27T18:11:19.117Z',
+   *   timeframe_start: '2019-12-27T18:11:19.117Z',
+   * });
+   * ```
    */
   evaluate(
     priceId: string,
@@ -132,6 +165,14 @@ export class Prices extends APIResource {
    *
    * Note that this is a POST endpoint rather than a GET endpoint because it employs
    * a JSON body rather than query parameters.
+   *
+   * @example
+   * ```ts
+   * const response = await client.prices.evaluateMultiple({
+   *   timeframe_end: '2019-12-27T18:11:19.117Z',
+   *   timeframe_start: '2019-12-27T18:11:19.117Z',
+   * });
+   * ```
    */
   evaluateMultiple(
     body: PriceEvaluateMultipleParams,
@@ -159,6 +200,14 @@ export class Prices extends APIResource {
    *
    * Note that this is a POST endpoint rather than a GET endpoint because it employs
    * a JSON body rather than query parameters.
+   *
+   * @example
+   * ```ts
+   * const response = await client.prices.evaluatePreviewEvents({
+   *   timeframe_end: '2019-12-27T18:11:19.117Z',
+   *   timeframe_start: '2019-12-27T18:11:19.117Z',
+   * });
+   * ```
    */
   evaluatePreviewEvents(
     body: PriceEvaluatePreviewEventsParams,
@@ -169,6 +218,11 @@ export class Prices extends APIResource {
 
   /**
    * This endpoint returns a price given an identifier.
+   *
+   * @example
+   * ```ts
+   * const price = await client.prices.fetch('price_id');
+   * ```
    */
   fetch(priceId: string, options?: Core.RequestOptions): Core.APIPromise<Shared.Price> {
     return this._client.get(`/prices/${priceId}`, options);
@@ -277,6 +331,7 @@ export type PriceCreateParams =
   | PriceCreateParams.NewFloatingPackageWithAllocationPrice
   | PriceCreateParams.NewFloatingUnitWithPercentPrice
   | PriceCreateParams.NewFloatingMatrixWithAllocationPrice
+  | PriceCreateParams.NewFloatingMatrixWithThresholdDiscountsPrice
   | PriceCreateParams.NewFloatingTieredWithProrationPrice
   | PriceCreateParams.NewFloatingUnitWithProrationPrice
   | PriceCreateParams.NewFloatingGroupedAllocationPrice
@@ -291,6 +346,8 @@ export type PriceCreateParams =
   | PriceCreateParams.NewFloatingScalableMatrixWithTieredPricingPrice
   | PriceCreateParams.NewFloatingCumulativeGroupedBulkPrice
   | PriceCreateParams.NewFloatingCumulativeGroupedAllocationPrice
+  | PriceCreateParams.NewFloatingDailyCreditAllowancePrice
+  | PriceCreateParams.NewFloatingMeteredAllowancePrice
   | PriceCreateParams.NewFloatingMinimumCompositePrice
   | PriceCreateParams.NewFloatingPercentCompositePrice
   | PriceCreateParams.NewFloatingEventOutputPrice;
@@ -1923,6 +1980,168 @@ export declare namespace PriceCreateParams {
     metadata?: { [key: string]: string | null } | null;
   }
 
+  export interface NewFloatingMatrixWithThresholdDiscountsPrice {
+    /**
+     * 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;
+
+    /**
+     * Configuration for matrix_with_threshold_discounts pricing
+     */
+    matrix_with_threshold_discounts_config: NewFloatingMatrixWithThresholdDiscountsPrice.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;
+
+    /**
+     * 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;
+  }
+
+  export namespace NewFloatingMatrixWithThresholdDiscountsPrice {
+    /**
+     * Configuration for matrix_with_threshold_discounts pricing
+     */
+    export 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>;
+    }
+
+    export namespace MatrixWithThresholdDiscountsConfig {
+      export interface MatrixValue {
+        first_dimension_value: string;
+
+        unit_amount: string;
+
+        second_dimension_value?: string | null;
+      }
+
+      export 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;
+      }
+    }
+  }
+
   export interface NewFloatingTieredWithProrationPrice {
     /**
      * The cadence to bill for this price on.
@@ -3778,7 +3997,7 @@ export declare namespace PriceCreateParams {
     }
   }
 
-  export interface NewFloatingMinimumCompositePrice {
+  export interface NewFloatingDailyCreditAllowancePrice {
     /**
      * The cadence to bill for this price on.
      */
@@ -3790,19 +4009,19 @@ export declare namespace PriceCreateParams {
     currency: string;
 
     /**
-     * The id of the item the price will be associated with.
+     * Configuration for daily_credit_allowance pricing
      */
-    item_id: string;
+    daily_credit_allowance_config: NewFloatingDailyCreditAllowancePrice.DailyCreditAllowanceConfig;
 
     /**
-     * Configuration for minimum_composite pricing
+     * The id of the item the price will be associated with.
      */
-    minimum_composite_config: NewFloatingMinimumCompositePrice.MinimumCompositeConfig;
+    item_id: string;
 
     /**
      * The pricing model type
      */
-    model_type: 'minimum_composite';
+    model_type: 'daily_credit_allowance';
 
     /**
      * The name of the price.
@@ -3877,24 +4096,60 @@ export declare namespace PriceCreateParams {
     metadata?: { [key: string]: string | null } | null;
   }
 
-  export namespace NewFloatingMinimumCompositePrice {
+  export namespace NewFloatingDailyCreditAllowancePrice {
     /**
-     * Configuration for minimum_composite pricing
+     * Configuration for daily_credit_allowance pricing
      */
-    export interface MinimumCompositeConfig {
+    export interface DailyCreditAllowanceConfig {
       /**
-       * The minimum amount to apply
+       * Credits granted per day. Lose-it-or-use-it; does not roll over.
        */
-      minimum_amount: string;
+      daily_allowance: string;
 
       /**
-       * If true, subtotals from this price are prorated based on the service period
+       * Default per-unit credit rate for any usage not bucketed into a specified
+       * matrix_value
        */
-      prorated?: boolean;
+      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>;
+    }
+
+    export namespace DailyCreditAllowanceConfig {
+      /**
+       * Per-dimension credit price for the daily credit allowance model.
+       */
+      export 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;
+      }
     }
   }
 
-  export interface NewFloatingPercentCompositePrice {
+  export interface NewFloatingMeteredAllowancePrice {
     /**
      * The cadence to bill for this price on.
      */
@@ -3911,19 +4166,19 @@ export declare namespace PriceCreateParams {
     item_id: string;
 
     /**
-     * The pricing model type
+     * Configuration for metered_allowance pricing
      */
-    model_type: 'percent';
+    metered_allowance_config: NewFloatingMeteredAllowancePrice.MeteredAllowanceConfig;
 
     /**
-     * The name of the price.
+     * The pricing model type
      */
-    name: string;
+    model_type: 'metered_allowance';
 
     /**
-     * Configuration for percent pricing
+     * The name of the price.
      */
-    percent_config: NewFloatingPercentCompositePrice.PercentConfig;
+    name: string;
 
     /**
      * The id of the billable metric for the price. Only needed if the price is
@@ -3993,19 +4248,49 @@ export declare namespace PriceCreateParams {
     metadata?: { [key: string]: string | null } | null;
   }
 
-  export namespace NewFloatingPercentCompositePrice {
+  export namespace NewFloatingMeteredAllowancePrice {
     /**
-     * Configuration for percent pricing
+     * Configuration for metered_allowance pricing
      */
-    export interface PercentConfig {
+    export interface MeteredAllowanceConfig {
       /**
-       * What percent of the component subtotals to charge
+       * 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.
        */
-      percent: number;
+      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;
     }
   }
 
-  export interface NewFloatingEventOutputPrice {
+  export interface NewFloatingMinimumCompositePrice {
     /**
      * The cadence to bill for this price on.
      */
@@ -4017,19 +4302,19 @@ export declare namespace PriceCreateParams {
     currency: string;
 
     /**
-     * Configuration for event_output pricing
+     * The id of the item the price will be associated with.
      */
-    event_output_config: NewFloatingEventOutputPrice.EventOutputConfig;
+    item_id: string;
 
     /**
-     * The id of the item the price will be associated with.
+     * Configuration for minimum_composite pricing
      */
-    item_id: string;
+    minimum_composite_config: NewFloatingMinimumCompositePrice.MinimumCompositeConfig;
 
     /**
      * The pricing model type
      */
-    model_type: 'event_output';
+    model_type: 'minimum_composite';
 
     /**
      * The name of the price.
@@ -4104,42 +4389,286 @@ export declare namespace PriceCreateParams {
     metadata?: { [key: string]: string | null } | null;
   }
 
-  export namespace NewFloatingEventOutputPrice {
+  export namespace NewFloatingMinimumCompositePrice {
     /**
-     * Configuration for event_output pricing
+     * Configuration for minimum_composite pricing
      */
-    export interface EventOutputConfig {
-      /**
-       * The key in the event data to extract the unit rate from.
-       */
-      unit_rating_key: string;
-
+    export interface MinimumCompositeConfig {
       /**
-       * 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 minimum amount to apply
        */
-      default_unit_rate?: string | null;
+      minimum_amount: 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.
+       * If true, subtotals from this price are prorated based on the service period
        */
-      grouping_key?: string | null;
+      prorated?: boolean;
     }
   }
-}
 
-export interface PriceUpdateParams {
-  /**
-   * 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;
-}
+  export interface NewFloatingPercentCompositePrice {
+    /**
+     * The cadence to bill for this price on.
+     */
+    cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
 
-export interface PriceListParams extends PageParams {}
+    /**
+     * 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: 'percent';
+
+    /**
+     * The name of the price.
+     */
+    name: string;
+
+    /**
+     * Configuration for percent pricing
+     */
+    percent_config: NewFloatingPercentCompositePrice.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;
+
+    /**
+     * 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;
+  }
+
+  export namespace NewFloatingPercentCompositePrice {
+    /**
+     * Configuration for percent pricing
+     */
+    export 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;
+    }
+  }
+
+  export interface NewFloatingEventOutputPrice {
+    /**
+     * 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;
+
+    /**
+     * Configuration for event_output pricing
+     */
+    event_output_config: NewFloatingEventOutputPrice.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;
+
+    /**
+     * 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;
+  }
+
+  export namespace NewFloatingEventOutputPrice {
+    /**
+     * Configuration for event_output pricing
+     */
+    export 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 PriceUpdateParams {
+  /**
+   * 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;
+}
+
+export interface PriceListParams extends PageParams {}
 
 export interface PriceEvaluateParams {
   /**
@@ -4255,6 +4784,7 @@ export namespace PriceEvaluateMultipleParams {
       | Shared.NewFloatingPackageWithAllocationPrice
       | Shared.NewFloatingUnitWithPercentPrice
       | Shared.NewFloatingMatrixWithAllocationPrice
+      | PriceEvaluation.NewFloatingMatrixWithThresholdDiscountsPrice
       | Shared.NewFloatingTieredWithProrationPrice
       | Shared.NewFloatingUnitWithProrationPrice
       | Shared.NewFloatingGroupedAllocationPrice
@@ -4269,6 +4799,8 @@ export namespace PriceEvaluateMultipleParams {
       | Shared.NewFloatingScalableMatrixWithTieredPricingPrice
       | Shared.NewFloatingCumulativeGroupedBulkPrice
       | PriceEvaluation.NewFloatingCumulativeGroupedAllocationPrice
+      | PriceEvaluation.NewFloatingDailyCreditAllowancePrice
+      | PriceEvaluation.NewFloatingMeteredAllowancePrice
       | Shared.NewFloatingMinimumCompositePrice
       | PriceEvaluation.NewFloatingPercentCompositePrice
       | PriceEvaluation.NewFloatingEventOutputPrice
@@ -4429,7 +4961,7 @@ export namespace PriceEvaluateMultipleParams {
       }
     }
 
-    export interface NewFloatingGroupedWithMinMaxThresholdsPrice {
+    export interface NewFloatingMatrixWithThresholdDiscountsPrice {
       /**
        * The cadence to bill for this price on.
        */
@@ -4441,14 +4973,176 @@ export namespace PriceEvaluateMultipleParams {
       currency: string;
 
       /**
-       * Configuration for grouped_with_min_max_thresholds pricing
+       * The id of the item the price will be associated with.
        */
-      grouped_with_min_max_thresholds_config: NewFloatingGroupedWithMinMaxThresholdsPrice.GroupedWithMinMaxThresholdsConfig;
+      item_id: string;
 
       /**
-       * The id of the item the price will be associated with.
+       * Configuration for matrix_with_threshold_discounts pricing
        */
-      item_id: string;
+      matrix_with_threshold_discounts_config: NewFloatingMatrixWithThresholdDiscountsPrice.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;
+
+      /**
+       * 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;
+    }
+
+    export namespace NewFloatingMatrixWithThresholdDiscountsPrice {
+      /**
+       * Configuration for matrix_with_threshold_discounts pricing
+       */
+      export 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>;
+      }
+
+      export namespace MatrixWithThresholdDiscountsConfig {
+        export interface MatrixValue {
+          first_dimension_value: string;
+
+          unit_amount: string;
+
+          second_dimension_value?: string | null;
+        }
+
+        export 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;
+        }
+      }
+    }
+
+    export interface NewFloatingGroupedWithMinMaxThresholdsPrice {
+      /**
+       * 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;
+
+      /**
+       * 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.
+       */
+      item_id: string;
 
       /**
        * The pricing model type
@@ -4681,7 +5375,7 @@ export namespace PriceEvaluateMultipleParams {
       }
     }
 
-    export interface NewFloatingPercentCompositePrice {
+    export interface NewFloatingDailyCreditAllowancePrice {
       /**
        * The cadence to bill for this price on.
        */
@@ -4692,6 +5386,11 @@ export namespace PriceEvaluateMultipleParams {
        */
       currency: string;
 
+      /**
+       * Configuration for daily_credit_allowance pricing
+       */
+      daily_credit_allowance_config: NewFloatingDailyCreditAllowancePrice.DailyCreditAllowanceConfig;
+
       /**
        * The id of the item the price will be associated with.
        */
@@ -4700,18 +5399,13 @@ export namespace PriceEvaluateMultipleParams {
       /**
        * 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: NewFloatingPercentCompositePrice.PercentConfig;
-
       /**
        * The id of the billable metric for the price. Only needed if the price is
        * usage-based.
@@ -4780,19 +5474,60 @@ export namespace PriceEvaluateMultipleParams {
       metadata?: { [key: string]: string | null } | null;
     }
 
-    export namespace NewFloatingPercentCompositePrice {
+    export namespace NewFloatingDailyCreditAllowancePrice {
       /**
-       * Configuration for percent pricing
+       * Configuration for daily_credit_allowance pricing
        */
-      export interface PercentConfig {
+      export 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>;
+      }
+
+      export namespace DailyCreditAllowanceConfig {
+        /**
+         * Per-dimension credit price for the daily credit allowance model.
+         */
+        export 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;
+        }
       }
     }
 
-    export interface NewFloatingEventOutputPrice {
+    export interface NewFloatingMeteredAllowancePrice {
       /**
        * The cadence to bill for this price on.
        */
@@ -4804,19 +5539,19 @@ export namespace PriceEvaluateMultipleParams {
       currency: string;
 
       /**
-       * Configuration for event_output pricing
+       * The id of the item the price will be associated with.
        */
-      event_output_config: NewFloatingEventOutputPrice.EventOutputConfig;
+      item_id: string;
 
       /**
-       * The id of the item the price will be associated with.
+       * Configuration for metered_allowance pricing
        */
-      item_id: string;
+      metered_allowance_config: NewFloatingMeteredAllowancePrice.MeteredAllowanceConfig;
 
       /**
        * The pricing model type
        */
-      model_type: 'event_output';
+      model_type: 'metered_allowance';
 
       /**
        * The name of the price.
@@ -4891,67 +5626,336 @@ export namespace PriceEvaluateMultipleParams {
       metadata?: { [key: string]: string | null } | null;
     }
 
-    export namespace NewFloatingEventOutputPrice {
+    export namespace NewFloatingMeteredAllowancePrice {
       /**
-       * Configuration for event_output pricing
+       * Configuration for metered_allowance pricing
        */
-      export interface EventOutputConfig {
+      export 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;
       }
     }
-  }
-}
 
-export interface PriceEvaluatePreviewEventsParams {
-  /**
-   * The exclusive upper bound for event timestamps
-   */
-  timeframe_end: string;
+    export interface NewFloatingPercentCompositePrice {
+      /**
+       * The cadence to bill for this price on.
+       */
+      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
 
-  /**
-   * The inclusive lower bound for event timestamps
-   */
-  timeframe_start: string;
+      /**
+       * An ISO 4217 currency string for which this price is billed in.
+       */
+      currency: string;
 
-  /**
-   * The ID of the customer to which this evaluation is scoped.
-   */
-  customer_id?: string | null;
+      /**
+       * The id of the item the price will be associated with.
+       */
+      item_id: string;
 
-  /**
-   * List of preview events to use instead of actual usage data
-   */
-  events?: Array<PriceEvaluatePreviewEventsParams.Event>;
+      /**
+       * The pricing model type
+       */
+      model_type: 'percent';
 
-  /**
-   * The external customer ID of the customer to which this evaluation is scoped.
-   */
-  external_customer_id?: string | null;
+      /**
+       * The name of the price.
+       */
+      name: string;
 
-  /**
-   * List of prices to evaluate (max 100)
-   */
-  price_evaluations?: Array<PriceEvaluatePreviewEventsParams.PriceEvaluation>;
-}
+      /**
+       * Configuration for percent pricing
+       */
+      percent_config: NewFloatingPercentCompositePrice.PercentConfig;
 
-export namespace PriceEvaluatePreviewEventsParams {
-  export interface Event {
+      /**
+       * 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;
+    }
+
+    export namespace NewFloatingPercentCompositePrice {
+      /**
+       * Configuration for percent pricing
+       */
+      export 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;
+      }
+    }
+
+    export interface NewFloatingEventOutputPrice {
+      /**
+       * 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;
+
+      /**
+       * Configuration for event_output pricing
+       */
+      event_output_config: NewFloatingEventOutputPrice.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;
+
+      /**
+       * 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;
+    }
+
+    export namespace NewFloatingEventOutputPrice {
+      /**
+       * Configuration for event_output pricing
+       */
+      export 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 PriceEvaluatePreviewEventsParams {
+  /**
+   * The exclusive upper bound for event timestamps
+   */
+  timeframe_end: string;
+
+  /**
+   * The inclusive lower bound for event timestamps
+   */
+  timeframe_start: string;
+
+  /**
+   * The ID of the customer to which this evaluation is scoped.
+   */
+  customer_id?: string | null;
+
+  /**
+   * List of preview events to use instead of actual usage data
+   */
+  events?: Array<PriceEvaluatePreviewEventsParams.Event>;
+
+  /**
+   * The external customer ID of the customer to which this evaluation is scoped.
+   */
+  external_customer_id?: string | null;
+
+  /**
+   * List of prices to evaluate (max 100)
+   */
+  price_evaluations?: Array<PriceEvaluatePreviewEventsParams.PriceEvaluation>;
+}
+
+export namespace PriceEvaluatePreviewEventsParams {
+  export interface Event {
     /**
      * A name to meaningfully identify the action or event type.
      */
@@ -4970,99 +5974,538 @@ export namespace PriceEvaluatePreviewEventsParams {
      */
     timestamp: string;
 
-    /**
-     * The Orb Customer identifier
-     */
-    customer_id?: string | null;
+    /**
+     * The Orb Customer identifier
+     */
+    customer_id?: string | null;
+
+    /**
+     * An alias for the Orb customer, whose mapping is specified when creating the
+     * customer
+     */
+    external_customer_id?: string | null;
+  }
+
+  export interface PriceEvaluation {
+    /**
+     * The external ID of a price to evaluate that exists in your Orb account.
+     */
+    external_price_id?: string | null;
+
+    /**
+     * A boolean
+     * [computed property](/extensibility/advanced-metrics#computed-properties) used to
+     * filter the underlying billable metric
+     */
+    filter?: string | null;
+
+    /**
+     * Properties (or
+     * [computed properties](/extensibility/advanced-metrics#computed-properties)) used
+     * to group the underlying billable metric
+     */
+    grouping_keys?: Array<string>;
+
+    /**
+     * Optional overrides for parameterized billable metric parameters. If the metric
+     * has parameter definitions and no overrides are provided, defaults will be used.
+     */
+    metric_parameter_overrides?: { [key: string]: unknown } | null;
+
+    /**
+     * New floating price request body params.
+     */
+    price?:
+      | Shared.NewFloatingUnitPrice
+      | Shared.NewFloatingTieredPrice
+      | Shared.NewFloatingBulkPrice
+      | PriceEvaluation.NewFloatingBulkWithFiltersPrice
+      | Shared.NewFloatingPackagePrice
+      | Shared.NewFloatingMatrixPrice
+      | Shared.NewFloatingThresholdTotalAmountPrice
+      | Shared.NewFloatingTieredPackagePrice
+      | Shared.NewFloatingTieredWithMinimumPrice
+      | Shared.NewFloatingGroupedTieredPrice
+      | Shared.NewFloatingTieredPackageWithMinimumPrice
+      | Shared.NewFloatingPackageWithAllocationPrice
+      | Shared.NewFloatingUnitWithPercentPrice
+      | Shared.NewFloatingMatrixWithAllocationPrice
+      | PriceEvaluation.NewFloatingMatrixWithThresholdDiscountsPrice
+      | Shared.NewFloatingTieredWithProrationPrice
+      | Shared.NewFloatingUnitWithProrationPrice
+      | Shared.NewFloatingGroupedAllocationPrice
+      | Shared.NewFloatingBulkWithProrationPrice
+      | Shared.NewFloatingGroupedWithProratedMinimumPrice
+      | Shared.NewFloatingGroupedWithMeteredMinimumPrice
+      | PriceEvaluation.NewFloatingGroupedWithMinMaxThresholdsPrice
+      | Shared.NewFloatingMatrixWithDisplayNamePrice
+      | Shared.NewFloatingGroupedTieredPackagePrice
+      | Shared.NewFloatingMaxGroupTieredPackagePrice
+      | Shared.NewFloatingScalableMatrixWithUnitPricingPrice
+      | Shared.NewFloatingScalableMatrixWithTieredPricingPrice
+      | Shared.NewFloatingCumulativeGroupedBulkPrice
+      | PriceEvaluation.NewFloatingCumulativeGroupedAllocationPrice
+      | PriceEvaluation.NewFloatingDailyCreditAllowancePrice
+      | PriceEvaluation.NewFloatingMeteredAllowancePrice
+      | Shared.NewFloatingMinimumCompositePrice
+      | PriceEvaluation.NewFloatingPercentCompositePrice
+      | PriceEvaluation.NewFloatingEventOutputPrice
+      | null;
+
+    /**
+     * The ID of a price to evaluate that exists in your Orb account.
+     */
+    price_id?: string | null;
+  }
+
+  export namespace PriceEvaluation {
+    export 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;
+    }
+
+    export namespace NewFloatingBulkWithFiltersPrice {
+      /**
+       * Configuration for bulk_with_filters pricing
+       */
+      export 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>;
+      }
+
+      export namespace BulkWithFiltersConfig {
+        /**
+         * Configuration for a single property filter
+         */
+        export 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
+         */
+        export interface Tier {
+          /**
+           * Amount per unit
+           */
+          unit_amount: string;
+
+          /**
+           * The lower bound for this tier
+           */
+          tier_lower_bound?: string | null;
+        }
+      }
+    }
+
+    export interface NewFloatingMatrixWithThresholdDiscountsPrice {
+      /**
+       * 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;
+
+      /**
+       * Configuration for matrix_with_threshold_discounts pricing
+       */
+      matrix_with_threshold_discounts_config: NewFloatingMatrixWithThresholdDiscountsPrice.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;
+
+      /**
+       * 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;
+    }
+
+    export namespace NewFloatingMatrixWithThresholdDiscountsPrice {
+      /**
+       * Configuration for matrix_with_threshold_discounts pricing
+       */
+      export 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>;
+      }
+
+      export namespace MatrixWithThresholdDiscountsConfig {
+        export interface MatrixValue {
+          first_dimension_value: string;
+
+          unit_amount: string;
+
+          second_dimension_value?: string | null;
+        }
+
+        export 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;
+        }
+      }
+    }
+
+    export interface NewFloatingGroupedWithMinMaxThresholdsPrice {
+      /**
+       * 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;
+
+      /**
+       * 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.
+       */
+      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 alias for the Orb customer, whose mapping is specified when creating the
-     * customer
-     */
-    external_customer_id?: string | null;
-  }
+      /**
+       * For dimensional price: specifies a price group and dimension values
+       */
+      dimensional_price_configuration?: Shared.NewDimensionalPriceConfiguration | null;
 
-  export interface PriceEvaluation {
-    /**
-     * The external ID of a price to evaluate that exists in your Orb account.
-     */
-    external_price_id?: string | null;
+      /**
+       * An alias for the price.
+       */
+      external_price_id?: string | null;
 
-    /**
-     * A boolean
-     * [computed property](/extensibility/advanced-metrics#computed-properties) used to
-     * filter the underlying billable metric
-     */
-    filter?: string | null;
+      /**
+       * If the Price represents a fixed cost, this represents the quantity of units
+       * applied.
+       */
+      fixed_price_quantity?: number | null;
 
-    /**
-     * Properties (or
-     * [computed properties](/extensibility/advanced-metrics#computed-properties)) used
-     * to group the underlying billable metric
-     */
-    grouping_keys?: Array<string>;
+      /**
+       * The property used to group this price on an invoice
+       */
+      invoice_grouping_key?: string | null;
 
-    /**
-     * Optional overrides for parameterized billable metric parameters. If the metric
-     * has parameter definitions and no overrides are provided, defaults will be used.
-     */
-    metric_parameter_overrides?: { [key: string]: unknown } | 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;
 
-    /**
-     * New floating price request body params.
-     */
-    price?:
-      | Shared.NewFloatingUnitPrice
-      | Shared.NewFloatingTieredPrice
-      | Shared.NewFloatingBulkPrice
-      | PriceEvaluation.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
-      | PriceEvaluation.NewFloatingGroupedWithMinMaxThresholdsPrice
-      | Shared.NewFloatingMatrixWithDisplayNamePrice
-      | Shared.NewFloatingGroupedTieredPackagePrice
-      | Shared.NewFloatingMaxGroupTieredPackagePrice
-      | Shared.NewFloatingScalableMatrixWithUnitPricingPrice
-      | Shared.NewFloatingScalableMatrixWithTieredPricingPrice
-      | Shared.NewFloatingCumulativeGroupedBulkPrice
-      | PriceEvaluation.NewFloatingCumulativeGroupedAllocationPrice
-      | Shared.NewFloatingMinimumCompositePrice
-      | PriceEvaluation.NewFloatingPercentCompositePrice
-      | PriceEvaluation.NewFloatingEventOutputPrice
-      | null;
+      /**
+       * The ID of the license type to associate with this price.
+       */
+      license_type_id?: string | null;
 
-    /**
-     * The ID of a price to evaluate that exists in your Orb account.
-     */
-    price_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;
+    }
 
-  export namespace PriceEvaluation {
-    export interface NewFloatingBulkWithFiltersPrice {
+    export namespace NewFloatingGroupedWithMinMaxThresholdsPrice {
       /**
-       * Configuration for bulk_with_filters pricing
+       * Configuration for grouped_with_min_max_thresholds pricing
        */
-      bulk_with_filters_config: NewFloatingBulkWithFiltersPrice.BulkWithFiltersConfig;
+      export 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;
+      }
+    }
 
+    export 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.
        */
@@ -5076,7 +6519,7 @@ export namespace PriceEvaluatePreviewEventsParams {
       /**
        * The pricing model type
        */
-      model_type: 'bulk_with_filters';
+      model_type: 'cumulative_grouped_allocation';
 
       /**
        * The name of the price.
@@ -5151,56 +6594,34 @@ export namespace PriceEvaluatePreviewEventsParams {
       metadata?: { [key: string]: string | null } | null;
     }
 
-    export namespace NewFloatingBulkWithFiltersPrice {
+    export namespace NewFloatingCumulativeGroupedAllocationPrice {
       /**
-       * Configuration for bulk_with_filters pricing
+       * Configuration for cumulative_grouped_allocation pricing
        */
-      export interface BulkWithFiltersConfig {
+      export interface CumulativeGroupedAllocationConfig {
         /**
-         * Property filters to apply (all must match)
+         * The overall allocation across all groups
          */
-        filters: Array<BulkWithFiltersConfig.Filter>;
+        cumulative_allocation: string;
 
         /**
-         * Bulk tiers for rating based on total usage volume
+         * The allocation per individual group
          */
-        tiers: Array<BulkWithFiltersConfig.Tier>;
-      }
+        group_allocation: string;
 
-      export namespace BulkWithFiltersConfig {
         /**
-         * Configuration for a single property filter
+         * The event property used to group usage before applying allocations
          */
-        export interface Filter {
-          /**
-           * Event property key to filter on
-           */
-          property_key: string;
-
-          /**
-           * Event property value to match
-           */
-          property_value: string;
-        }
+        grouping_key: string;
 
         /**
-         * Configuration for a single bulk pricing tier
+         * The amount to charge for each unit outside of the allocation
          */
-        export interface Tier {
-          /**
-           * Amount per unit
-           */
-          unit_amount: string;
-
-          /**
-           * The lower bound for this tier
-           */
-          tier_lower_bound?: string | null;
-        }
+        unit_amount: string;
       }
     }
 
-    export interface NewFloatingGroupedWithMinMaxThresholdsPrice {
+    export interface NewFloatingDailyCreditAllowancePrice {
       /**
        * The cadence to bill for this price on.
        */
@@ -5212,9 +6633,9 @@ export namespace PriceEvaluatePreviewEventsParams {
       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.
@@ -5224,7 +6645,7 @@ export namespace PriceEvaluatePreviewEventsParams {
       /**
        * The pricing model type
        */
-      model_type: 'grouped_with_min_max_thresholds';
+      model_type: 'daily_credit_allowance';
 
       /**
        * The name of the price.
@@ -5299,44 +6720,65 @@ export namespace PriceEvaluatePreviewEventsParams {
       metadata?: { [key: string]: string | null } | null;
     }
 
-    export namespace NewFloatingGroupedWithMinMaxThresholdsPrice {
+    export namespace NewFloatingDailyCreditAllowancePrice {
       /**
-       * Configuration for grouped_with_min_max_thresholds pricing
+       * Configuration for daily_credit_allowance pricing
        */
-      export interface GroupedWithMinMaxThresholdsConfig {
+      export 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>;
+      }
+
+      export namespace DailyCreditAllowanceConfig {
+        /**
+         * Per-dimension credit price for the daily credit allowance model.
+         */
+        export 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;
+        }
       }
     }
 
-    export interface NewFloatingCumulativeGroupedAllocationPrice {
+    export 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.
        */
@@ -5347,10 +6789,15 @@ export namespace PriceEvaluatePreviewEventsParams {
        */
       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.
@@ -5425,30 +6872,45 @@ export namespace PriceEvaluatePreviewEventsParams {
       metadata?: { [key: string]: string | null } | null;
     }
 
-    export namespace NewFloatingCumulativeGroupedAllocationPrice {
+    export namespace NewFloatingMeteredAllowancePrice {
       /**
-       * Configuration for cumulative_grouped_allocation pricing
+       * Configuration for metered_allowance pricing
        */
-      export interface CumulativeGroupedAllocationConfig {
+      export 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;
       }
     }
 
@@ -5557,9 +7019,26 @@ export namespace PriceEvaluatePreviewEventsParams {
        */
       export 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;
       }
     }