orb-billing 6.25.0 → 6.27.0

package/resources/subscriptions.js

@@ -510,9 +510,9 @@ class Subscriptions extends resource_1.APIResource {
      * but do not have the key set). Currently, it is only possible to view usage
      * grouped by a single attribute at a time.
      *
-     * When viewing grouped usage, Orb uses pagination to limit the response size to
-     * 1000 groups by default. If there are more groups for a given subscription,
-     * pagination metadata in the response can be used to fetch all of the data.
+     * When viewing grouped usage, all groups are returned in a single response. For
+     * metrics with a large number of groups, Orb recommends using a shorter timeframe
+     * to keep response size and latency manageable.
      *
      * The following example shows usage for an "API Requests" billable metric grouped
      * by `region`. Note the extra `metric_group` dictionary in the response, which

package/resources/subscriptions.mjs

@@ -507,9 +507,9 @@ export class Subscriptions extends APIResource {
      * but do not have the key set). Currently, it is only possible to view usage
      * grouped by a single attribute at a time.
      *
-     * When viewing grouped usage, Orb uses pagination to limit the response size to
-     * 1000 groups by default. If there are more groups for a given subscription,
-     * pagination metadata in the response can be used to fetch all of the data.
+     * When viewing grouped usage, all groups are returned in a single response. For
+     * metrics with a large number of groups, Orb recommends using a shorter timeframe
+     * to keep response size and latency manageable.
      *
      * The following example shows usage for an "API Requests" billable metric grouped
      * by `region`. Note the extra `metric_group` dictionary in the response, which

package/src/resources/beta/beta.ts

@@ -409,7 +409,7 @@ export namespace BetaCreatePlanVersionParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * The id of the item the price will be associated with.
@@ -551,7 +551,7 @@ export namespace BetaCreatePlanVersionParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * The id of the item the price will be associated with.
@@ -705,7 +705,7 @@ export namespace BetaCreatePlanVersionParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * Configuration for grouped_tiered_matrix pricing
@@ -857,7 +857,7 @@ export namespace BetaCreatePlanVersionParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * The id of the item the price will be associated with.
@@ -1018,7 +1018,7 @@ export namespace BetaCreatePlanVersionParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * The id of the item the price will be associated with.
@@ -1191,7 +1191,7 @@ export namespace BetaCreatePlanVersionParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * The id of the item the price will be associated with.
@@ -1331,7 +1331,7 @@ export namespace BetaCreatePlanVersionParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * Configuration for grouped_with_min_max_thresholds pricing
@@ -1468,7 +1468,7 @@ export namespace BetaCreatePlanVersionParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * Configuration for cumulative_grouped_allocation pricing
@@ -1605,7 +1605,7 @@ export namespace BetaCreatePlanVersionParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * Configuration for daily_credit_allowance pricing
@@ -1768,7 +1768,7 @@ export namespace BetaCreatePlanVersionParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * The id of the item the price will be associated with.
@@ -1920,7 +1920,7 @@ export namespace BetaCreatePlanVersionParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * The id of the item the price will be associated with.
@@ -2059,7 +2059,7 @@ export namespace BetaCreatePlanVersionParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * Configuration for event_output pricing
@@ -2390,7 +2390,7 @@ export namespace BetaCreatePlanVersionParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * The id of the item the price will be associated with.
@@ -2532,7 +2532,7 @@ export namespace BetaCreatePlanVersionParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * The id of the item the price will be associated with.
@@ -2686,7 +2686,7 @@ export namespace BetaCreatePlanVersionParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * Configuration for grouped_tiered_matrix pricing
@@ -2838,7 +2838,7 @@ export namespace BetaCreatePlanVersionParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * The id of the item the price will be associated with.
@@ -2999,7 +2999,7 @@ export namespace BetaCreatePlanVersionParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * The id of the item the price will be associated with.
@@ -3172,7 +3172,7 @@ export namespace BetaCreatePlanVersionParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * The id of the item the price will be associated with.
@@ -3312,7 +3312,7 @@ export namespace BetaCreatePlanVersionParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * Configuration for grouped_with_min_max_thresholds pricing
@@ -3449,7 +3449,7 @@ export namespace BetaCreatePlanVersionParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * Configuration for cumulative_grouped_allocation pricing
@@ -3586,7 +3586,7 @@ export namespace BetaCreatePlanVersionParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * Configuration for daily_credit_allowance pricing
@@ -3749,7 +3749,7 @@ export namespace BetaCreatePlanVersionParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * The id of the item the price will be associated with.
@@ -3901,7 +3901,7 @@ export namespace BetaCreatePlanVersionParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * The id of the item the price will be associated with.
@@ -4040,7 +4040,7 @@ export namespace BetaCreatePlanVersionParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * Configuration for event_output pricing

package/src/resources/beta/external-plan-id.ts

@@ -261,7 +261,7 @@ export namespace ExternalPlanIDCreatePlanVersionParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * The id of the item the price will be associated with.
@@ -403,7 +403,7 @@ export namespace ExternalPlanIDCreatePlanVersionParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * The id of the item the price will be associated with.
@@ -557,7 +557,7 @@ export namespace ExternalPlanIDCreatePlanVersionParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * Configuration for grouped_tiered_matrix pricing
@@ -709,7 +709,7 @@ export namespace ExternalPlanIDCreatePlanVersionParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * The id of the item the price will be associated with.
@@ -870,7 +870,7 @@ export namespace ExternalPlanIDCreatePlanVersionParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * The id of the item the price will be associated with.
@@ -1043,7 +1043,7 @@ export namespace ExternalPlanIDCreatePlanVersionParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * The id of the item the price will be associated with.
@@ -1183,7 +1183,7 @@ export namespace ExternalPlanIDCreatePlanVersionParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * Configuration for grouped_with_min_max_thresholds pricing
@@ -1320,7 +1320,7 @@ export namespace ExternalPlanIDCreatePlanVersionParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * Configuration for cumulative_grouped_allocation pricing
@@ -1457,7 +1457,7 @@ export namespace ExternalPlanIDCreatePlanVersionParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * Configuration for daily_credit_allowance pricing
@@ -1620,7 +1620,7 @@ export namespace ExternalPlanIDCreatePlanVersionParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * The id of the item the price will be associated with.
@@ -1772,7 +1772,7 @@ export namespace ExternalPlanIDCreatePlanVersionParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * The id of the item the price will be associated with.
@@ -1911,7 +1911,7 @@ export namespace ExternalPlanIDCreatePlanVersionParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * Configuration for event_output pricing
@@ -2242,7 +2242,7 @@ export namespace ExternalPlanIDCreatePlanVersionParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * The id of the item the price will be associated with.
@@ -2384,7 +2384,7 @@ export namespace ExternalPlanIDCreatePlanVersionParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * The id of the item the price will be associated with.
@@ -2538,7 +2538,7 @@ export namespace ExternalPlanIDCreatePlanVersionParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * Configuration for grouped_tiered_matrix pricing
@@ -2690,7 +2690,7 @@ export namespace ExternalPlanIDCreatePlanVersionParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * The id of the item the price will be associated with.
@@ -2851,7 +2851,7 @@ export namespace ExternalPlanIDCreatePlanVersionParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * The id of the item the price will be associated with.
@@ -3024,7 +3024,7 @@ export namespace ExternalPlanIDCreatePlanVersionParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * The id of the item the price will be associated with.
@@ -3164,7 +3164,7 @@ export namespace ExternalPlanIDCreatePlanVersionParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * Configuration for grouped_with_min_max_thresholds pricing
@@ -3301,7 +3301,7 @@ export namespace ExternalPlanIDCreatePlanVersionParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * Configuration for cumulative_grouped_allocation pricing
@@ -3438,7 +3438,7 @@ export namespace ExternalPlanIDCreatePlanVersionParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * Configuration for daily_credit_allowance pricing
@@ -3601,7 +3601,7 @@ export namespace ExternalPlanIDCreatePlanVersionParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * The id of the item the price will be associated with.
@@ -3753,7 +3753,7 @@ export namespace ExternalPlanIDCreatePlanVersionParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * The id of the item the price will be associated with.
@@ -3892,7 +3892,7 @@ export namespace ExternalPlanIDCreatePlanVersionParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * Configuration for event_output pricing

package/src/resources/events/backfills.ts

@@ -54,7 +54,9 @@ export class Backfills extends APIResource {
    * the event reporting grace boundary. Matching events that arrive later with
    * timestamps inside the timeframe will also be deprecated.
    *
-   * You may not have multiple backfills in a pending or pending_revert state with
+   * A backfill may not overlap in timeframe with another backfill in a pending or
+   * pending_revert state for the same customer, or with any account-wide backfill in
+   * one of those states. Backfills scoped to different customers may have
    * overlapping timeframes.
    *
    * @example

package/src/resources/invoices.ts

@@ -268,12 +268,14 @@ export class Invoices extends APIResource {
    *
    * @example
    * ```ts
-   * const invoice = await client.invoices.pay('invoice_id', {
-   *   shared_payment_token_id: 'shared_payment_token_id',
-   * });
+   * const invoice = await client.invoices.pay('invoice_id');
    * ```
    */
-  pay(invoiceID: string, body: InvoicePayParams, options?: RequestOptions): APIPromise<Shared.Invoice> {
+  pay(
+    invoiceID: string,
+    body: InvoicePayParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<Shared.Invoice> {
     return this._client.post(path`/invoices/${invoiceID}/pay`, { body, ...options });
   }
 
@@ -2316,7 +2318,7 @@ export interface InvoicePayParams {
   /**
    * The ID of a shared payment token granted by an agent to use for this payment.
    */
-  shared_payment_token_id: string;
+  shared_payment_token_id?: string | null;
 }
 
 export declare namespace Invoices {

package/src/resources/plans/plans.ts

@@ -491,7 +491,7 @@ export namespace PlanCreateParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * The id of the item the price will be associated with.
@@ -633,7 +633,7 @@ export namespace PlanCreateParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * The id of the item the price will be associated with.
@@ -787,7 +787,7 @@ export namespace PlanCreateParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * Configuration for grouped_tiered_matrix pricing
@@ -939,7 +939,7 @@ export namespace PlanCreateParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * The id of the item the price will be associated with.
@@ -1100,7 +1100,7 @@ export namespace PlanCreateParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * The id of the item the price will be associated with.
@@ -1273,7 +1273,7 @@ export namespace PlanCreateParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * The id of the item the price will be associated with.
@@ -1413,7 +1413,7 @@ export namespace PlanCreateParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * Configuration for grouped_with_min_max_thresholds pricing
@@ -1550,7 +1550,7 @@ export namespace PlanCreateParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * Configuration for cumulative_grouped_allocation pricing
@@ -1687,7 +1687,7 @@ export namespace PlanCreateParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * Configuration for daily_credit_allowance pricing
@@ -1850,7 +1850,7 @@ export namespace PlanCreateParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * The id of the item the price will be associated with.
@@ -2002,7 +2002,7 @@ export namespace PlanCreateParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * The id of the item the price will be associated with.
@@ -2141,7 +2141,7 @@ export namespace PlanCreateParams {
       /**
        * The cadence to bill for this price on.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
       /**
        * Configuration for event_output pricing