orb-billing 4.29.0 → 4.31.0

package/src/resources/subscriptions.ts

@@ -1053,6 +1053,34 @@ export class Subscriptions extends APIResource {
       ...options,
     });
   }
+
+  /**
+   * This endpoint is used to update the trial end date for a subscription. The new
+   * trial end date must be within the time range of the current plan (i.e. the new
+   * trial end date must be on or after the subscription's start date on the current
+   * plan, and on or before the subscription end date).
+   *
+   * In order to retroactively remove a trial completely, the end date can be set to
+   * the transition date of the subscription to this plan (or, if this is the first
+   * plan for this subscription, the subscription's start date). In order to end a
+   * trial immediately, the keyword `immediate` can be provided as the trial end
+   * date.
+   *
+   * By default, Orb will shift only the trial end date (and price intervals that
+   * start or end on the previous trial end date), and leave all other future price
+   * intervals untouched. If the `shift` parameter is set to `true`, Orb will shift
+   * all subsequent price and adjustment intervals by the same amount as the trial
+   * end date shift (so, e.g., if a plan change is scheduled or an add-on price was
+   * added, that change will be pushed back by the same amount of time the trial is
+   * extended).
+   */
+  updateTrial(
+    subscriptionId: string,
+    body: SubscriptionUpdateTrialParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<Subscription> {
+    return this._client.post(`/subscriptions/${subscriptionId}/update_trial`, { body, ...options });
+  }
 }
 
 export class SubscriptionsPage extends Page<Subscription> {}
@@ -2305,6 +2333,12 @@ export interface SubscriptionCreateParams {
    */
   plan_id?: string | null;
 
+  /**
+   * Specifies which version of the plan to subscribe to. If null, the default
+   * version will be used.
+   */
+  plan_version_number?: number | null;
+
   /**
    * Optionally provide a list of overrides for prices on the plan
    */
@@ -2331,6 +2365,13 @@ export interface SubscriptionCreateParams {
   > | null;
 
   start_date?: string | null;
+
+  /**
+   * The duration of the trial period in days. If not provided, this defaults to the
+   * value specified in the plan. If `0` is provided, the trial on the plan will be
+   * skipped.
+   */
+  trial_duration_days?: number | null;
 }
 
 export namespace SubscriptionCreateParams {
@@ -2415,23 +2456,12 @@ export namespace SubscriptionCreateParams {
        */
       amount_discount?: string | null;
 
-      /**
-       * List of price_ids that this discount applies to. For plan/plan phase discounts,
-       * this can be a subset of prices.
-       */
-      applies_to_price_ids?: Array<string> | null;
-
       /**
        * Only available if discount_type is `percentage`. This is a number between 0
        * and 1.
        */
       percentage_discount?: number | null;
 
-      /**
-       * Only available if discount_type is `trial`
-       */
-      trial_amount_discount?: string | null;
-
       /**
        * Only available if discount_type is `usage`. Number of usage units that this
        * discount is for
@@ -2504,23 +2534,12 @@ export namespace SubscriptionCreateParams {
        */
       amount_discount?: string | null;
 
-      /**
-       * List of price_ids that this discount applies to. For plan/plan phase discounts,
-       * this can be a subset of prices.
-       */
-      applies_to_price_ids?: Array<string> | null;
-
       /**
        * Only available if discount_type is `percentage`. This is a number between 0
        * and 1.
        */
       percentage_discount?: number | null;
 
-      /**
-       * Only available if discount_type is `trial`
-       */
-      trial_amount_discount?: string | null;
-
       /**
        * Only available if discount_type is `usage`. Number of usage units that this
        * discount is for
@@ -2613,23 +2632,12 @@ export namespace SubscriptionCreateParams {
        */
       amount_discount?: string | null;
 
-      /**
-       * List of price_ids that this discount applies to. For plan/plan phase discounts,
-       * this can be a subset of prices.
-       */
-      applies_to_price_ids?: Array<string> | null;
-
       /**
        * Only available if discount_type is `percentage`. This is a number between 0
        * and 1.
        */
       percentage_discount?: number | null;
 
-      /**
-       * Only available if discount_type is `trial`
-       */
-      trial_amount_discount?: string | null;
-
       /**
        * Only available if discount_type is `usage`. Number of usage units that this
        * discount is for
@@ -2715,23 +2723,12 @@ export namespace SubscriptionCreateParams {
        */
       amount_discount?: string | null;
 
-      /**
-       * List of price_ids that this discount applies to. For plan/plan phase discounts,
-       * this can be a subset of prices.
-       */
-      applies_to_price_ids?: Array<string> | null;
-
       /**
        * Only available if discount_type is `percentage`. This is a number between 0
        * and 1.
        */
       percentage_discount?: number | null;
 
-      /**
-       * Only available if discount_type is `trial`
-       */
-      trial_amount_discount?: string | null;
-
       /**
        * Only available if discount_type is `usage`. Number of usage units that this
        * discount is for
@@ -2823,23 +2820,12 @@ export namespace SubscriptionCreateParams {
        */
       amount_discount?: string | null;
 
-      /**
-       * List of price_ids that this discount applies to. For plan/plan phase discounts,
-       * this can be a subset of prices.
-       */
-      applies_to_price_ids?: Array<string> | null;
-
       /**
        * Only available if discount_type is `percentage`. This is a number between 0
        * and 1.
        */
       percentage_discount?: number | null;
 
-      /**
-       * Only available if discount_type is `trial`
-       */
-      trial_amount_discount?: string | null;
-
       /**
        * Only available if discount_type is `usage`. Number of usage units that this
        * discount is for
@@ -2911,23 +2897,12 @@ export namespace SubscriptionCreateParams {
        */
       amount_discount?: string | null;
 
-      /**
-       * List of price_ids that this discount applies to. For plan/plan phase discounts,
-       * this can be a subset of prices.
-       */
-      applies_to_price_ids?: Array<string> | null;
-
       /**
        * Only available if discount_type is `percentage`. This is a number between 0
        * and 1.
        */
       percentage_discount?: number | null;
 
-      /**
-       * Only available if discount_type is `trial`
-       */
-      trial_amount_discount?: string | null;
-
       /**
        * Only available if discount_type is `usage`. Number of usage units that this
        * discount is for
@@ -3014,23 +2989,12 @@ export namespace SubscriptionCreateParams {
        */
       amount_discount?: string | null;
 
-      /**
-       * List of price_ids that this discount applies to. For plan/plan phase discounts,
-       * this can be a subset of prices.
-       */
-      applies_to_price_ids?: Array<string> | null;
-
       /**
        * Only available if discount_type is `percentage`. This is a number between 0
        * and 1.
        */
       percentage_discount?: number | null;
 
-      /**
-       * Only available if discount_type is `trial`
-       */
-      trial_amount_discount?: string | null;
-
       /**
        * Only available if discount_type is `usage`. Number of usage units that this
        * discount is for
@@ -3111,23 +3075,12 @@ export namespace SubscriptionCreateParams {
        */
       amount_discount?: string | null;
 
-      /**
-       * List of price_ids that this discount applies to. For plan/plan phase discounts,
-       * this can be a subset of prices.
-       */
-      applies_to_price_ids?: Array<string> | null;
-
       /**
        * Only available if discount_type is `percentage`. This is a number between 0
        * and 1.
        */
       percentage_discount?: number | null;
 
-      /**
-       * Only available if discount_type is `trial`
-       */
-      trial_amount_discount?: string | null;
-
       /**
        * Only available if discount_type is `usage`. Number of usage units that this
        * discount is for
@@ -3187,23 +3140,12 @@ export namespace SubscriptionCreateParams {
        */
       amount_discount?: string | null;
 
-      /**
-       * List of price_ids that this discount applies to. For plan/plan phase discounts,
-       * this can be a subset of prices.
-       */
-      applies_to_price_ids?: Array<string> | null;
-
       /**
        * Only available if discount_type is `percentage`. This is a number between 0
        * and 1.
        */
       percentage_discount?: number | null;
 
-      /**
-       * Only available if discount_type is `trial`
-       */
-      trial_amount_discount?: string | null;
-
       /**
        * Only available if discount_type is `usage`. Number of usage units that this
        * discount is for
@@ -3263,23 +3205,12 @@ export namespace SubscriptionCreateParams {
        */
       amount_discount?: string | null;
 
-      /**
-       * List of price_ids that this discount applies to. For plan/plan phase discounts,
-       * this can be a subset of prices.
-       */
-      applies_to_price_ids?: Array<string> | null;
-
       /**
        * Only available if discount_type is `percentage`. This is a number between 0
        * and 1.
        */
       percentage_discount?: number | null;
 
-      /**
-       * Only available if discount_type is `trial`
-       */
-      trial_amount_discount?: string | null;
-
       /**
        * Only available if discount_type is `usage`. Number of usage units that this
        * discount is for
@@ -3339,23 +3270,12 @@ export namespace SubscriptionCreateParams {
        */
       amount_discount?: string | null;
 
-      /**
-       * List of price_ids that this discount applies to. For plan/plan phase discounts,
-       * this can be a subset of prices.
-       */
-      applies_to_price_ids?: Array<string> | null;
-
       /**
        * Only available if discount_type is `percentage`. This is a number between 0
        * and 1.
        */
       percentage_discount?: number | null;
 
-      /**
-       * Only available if discount_type is `trial`
-       */
-      trial_amount_discount?: string | null;
-
       /**
        * Only available if discount_type is `usage`. Number of usage units that this
        * discount is for
@@ -3415,23 +3335,12 @@ export namespace SubscriptionCreateParams {
        */
       amount_discount?: string | null;
 
-      /**
-       * List of price_ids that this discount applies to. For plan/plan phase discounts,
-       * this can be a subset of prices.
-       */
-      applies_to_price_ids?: Array<string> | null;
-
       /**
        * Only available if discount_type is `percentage`. This is a number between 0
        * and 1.
        */
       percentage_discount?: number | null;
 
-      /**
-       * Only available if discount_type is `trial`
-       */
-      trial_amount_discount?: string | null;
-
       /**
        * Only available if discount_type is `usage`. Number of usage units that this
        * discount is for
@@ -3491,23 +3400,12 @@ export namespace SubscriptionCreateParams {
        */
       amount_discount?: string | null;
 
-      /**
-       * List of price_ids that this discount applies to. For plan/plan phase discounts,
-       * this can be a subset of prices.
-       */
-      applies_to_price_ids?: Array<string> | null;
-
       /**
        * Only available if discount_type is `percentage`. This is a number between 0
        * and 1.
        */
       percentage_discount?: number | null;
 
-      /**
-       * Only available if discount_type is `trial`
-       */
-      trial_amount_discount?: string | null;
-
       /**
        * Only available if discount_type is `usage`. Number of usage units that this
        * discount is for
@@ -3567,23 +3465,12 @@ export namespace SubscriptionCreateParams {
        */
       amount_discount?: string | null;
 
-      /**
-       * List of price_ids that this discount applies to. For plan/plan phase discounts,
-       * this can be a subset of prices.
-       */
-      applies_to_price_ids?: Array<string> | null;
-
       /**
        * Only available if discount_type is `percentage`. This is a number between 0
        * and 1.
        */
       percentage_discount?: number | null;
 
-      /**
-       * Only available if discount_type is `trial`
-       */
-      trial_amount_discount?: string | null;
-
       /**
        * Only available if discount_type is `usage`. Number of usage units that this
        * discount is for
@@ -3643,23 +3530,12 @@ export namespace SubscriptionCreateParams {
        */
       amount_discount?: string | null;
 
-      /**
-       * List of price_ids that this discount applies to. For plan/plan phase discounts,
-       * this can be a subset of prices.
-       */
-      applies_to_price_ids?: Array<string> | null;
-
       /**
        * Only available if discount_type is `percentage`. This is a number between 0
        * and 1.
        */
       percentage_discount?: number | null;
 
-      /**
-       * Only available if discount_type is `trial`
-       */
-      trial_amount_discount?: string | null;
-
       /**
        * Only available if discount_type is `usage`. Number of usage units that this
        * discount is for
@@ -3719,23 +3595,12 @@ export namespace SubscriptionCreateParams {
        */
       amount_discount?: string | null;
 
-      /**
-       * List of price_ids that this discount applies to. For plan/plan phase discounts,
-       * this can be a subset of prices.
-       */
-      applies_to_price_ids?: Array<string> | null;
-
       /**
        * Only available if discount_type is `percentage`. This is a number between 0
        * and 1.
        */
       percentage_discount?: number | null;
 
-      /**
-       * Only available if discount_type is `trial`
-       */
-      trial_amount_discount?: string | null;
-
       /**
        * Only available if discount_type is `usage`. Number of usage units that this
        * discount is for
@@ -3795,23 +3660,12 @@ export namespace SubscriptionCreateParams {
        */
       amount_discount?: string | null;
 
-      /**
-       * List of price_ids that this discount applies to. For plan/plan phase discounts,
-       * this can be a subset of prices.
-       */
-      applies_to_price_ids?: Array<string> | null;
-
       /**
        * Only available if discount_type is `percentage`. This is a number between 0
        * and 1.
        */
       percentage_discount?: number | null;
 
-      /**
-       * Only available if discount_type is `trial`
-       */
-      trial_amount_discount?: string | null;
-
       /**
        * Only available if discount_type is `usage`. Number of usage units that this
        * discount is for
@@ -3871,23 +3725,12 @@ export namespace SubscriptionCreateParams {
        */
       amount_discount?: string | null;
 
-      /**
-       * List of price_ids that this discount applies to. For plan/plan phase discounts,
-       * this can be a subset of prices.
-       */
-      applies_to_price_ids?: Array<string> | null;
-
       /**
        * Only available if discount_type is `percentage`. This is a number between 0
        * and 1.
        */
       percentage_discount?: number | null;
 
-      /**
-       * Only available if discount_type is `trial`
-       */
-      trial_amount_discount?: string | null;
-
       /**
        * Only available if discount_type is `usage`. Number of usage units that this
        * discount is for
@@ -3947,23 +3790,12 @@ export namespace SubscriptionCreateParams {
        */
       amount_discount?: string | null;
 
-      /**
-       * List of price_ids that this discount applies to. For plan/plan phase discounts,
-       * this can be a subset of prices.
-       */
-      applies_to_price_ids?: Array<string> | null;
-
       /**
        * Only available if discount_type is `percentage`. This is a number between 0
        * and 1.
        */
       percentage_discount?: number | null;
 
-      /**
-       * Only available if discount_type is `trial`
-       */
-      trial_amount_discount?: string | null;
-
       /**
        * Only available if discount_type is `usage`. Number of usage units that this
        * discount is for
@@ -7186,6 +7018,12 @@ export interface SubscriptionSchedulePlanChangeParams {
    */
   plan_id?: string | null;
 
+  /**
+   * Specifies which version of the plan to change to. If null, the default version
+   * will be used.
+   */
+  plan_version_number?: number | null;
+
   /**
    * Optionally provide a list of overrides for prices on the plan
    */
@@ -7210,6 +7048,13 @@ export interface SubscriptionSchedulePlanChangeParams {
     | SubscriptionSchedulePlanChangeParams.OverrideUnitWithProrationPrice
     | SubscriptionSchedulePlanChangeParams.OverrideTieredWithProrationPrice
   > | null;
+
+  /**
+   * The duration of the trial period in days. If not provided, this defaults to the
+   * value specified in the plan. If `0` is provided, the trial on the plan will be
+   * skipped.
+   */
+  trial_duration_days?: number | null;
 }
 
 export namespace SubscriptionSchedulePlanChangeParams {
@@ -7271,23 +7116,12 @@ export namespace SubscriptionSchedulePlanChangeParams {
        */
       amount_discount?: string | null;
 
-      /**
-       * List of price_ids that this discount applies to. For plan/plan phase discounts,
-       * this can be a subset of prices.
-       */
-      applies_to_price_ids?: Array<string> | null;
-
       /**
        * Only available if discount_type is `percentage`. This is a number between 0
        * and 1.
        */
       percentage_discount?: number | null;
 
-      /**
-       * Only available if discount_type is `trial`
-       */
-      trial_amount_discount?: string | null;
-
       /**
        * Only available if discount_type is `usage`. Number of usage units that this
        * discount is for
@@ -7360,23 +7194,12 @@ export namespace SubscriptionSchedulePlanChangeParams {
        */
       amount_discount?: string | null;
 
-      /**
-       * List of price_ids that this discount applies to. For plan/plan phase discounts,
-       * this can be a subset of prices.
-       */
-      applies_to_price_ids?: Array<string> | null;
-
       /**
        * Only available if discount_type is `percentage`. This is a number between 0
        * and 1.
        */
       percentage_discount?: number | null;
 
-      /**
-       * Only available if discount_type is `trial`
-       */
-      trial_amount_discount?: string | null;
-
       /**
        * Only available if discount_type is `usage`. Number of usage units that this
        * discount is for
@@ -7469,23 +7292,12 @@ export namespace SubscriptionSchedulePlanChangeParams {
        */
       amount_discount?: string | null;
 
-      /**
-       * List of price_ids that this discount applies to. For plan/plan phase discounts,
-       * this can be a subset of prices.
-       */
-      applies_to_price_ids?: Array<string> | null;
-
       /**
        * Only available if discount_type is `percentage`. This is a number between 0
        * and 1.
        */
       percentage_discount?: number | null;
 
-      /**
-       * Only available if discount_type is `trial`
-       */
-      trial_amount_discount?: string | null;
-
       /**
        * Only available if discount_type is `usage`. Number of usage units that this
        * discount is for
@@ -7571,23 +7383,12 @@ export namespace SubscriptionSchedulePlanChangeParams {
        */
       amount_discount?: string | null;
 
-      /**
-       * List of price_ids that this discount applies to. For plan/plan phase discounts,
-       * this can be a subset of prices.
-       */
-      applies_to_price_ids?: Array<string> | null;
-
       /**
        * Only available if discount_type is `percentage`. This is a number between 0
        * and 1.
        */
       percentage_discount?: number | null;
 
-      /**
-       * Only available if discount_type is `trial`
-       */
-      trial_amount_discount?: string | null;
-
       /**
        * Only available if discount_type is `usage`. Number of usage units that this
        * discount is for
@@ -7679,23 +7480,12 @@ export namespace SubscriptionSchedulePlanChangeParams {
        */
       amount_discount?: string | null;
 
-      /**
-       * List of price_ids that this discount applies to. For plan/plan phase discounts,
-       * this can be a subset of prices.
-       */
-      applies_to_price_ids?: Array<string> | null;
-
       /**
        * Only available if discount_type is `percentage`. This is a number between 0
        * and 1.
        */
       percentage_discount?: number | null;
 
-      /**
-       * Only available if discount_type is `trial`
-       */
-      trial_amount_discount?: string | null;
-
       /**
        * Only available if discount_type is `usage`. Number of usage units that this
        * discount is for
@@ -7767,23 +7557,12 @@ export namespace SubscriptionSchedulePlanChangeParams {
        */
       amount_discount?: string | null;
 
-      /**
-       * List of price_ids that this discount applies to. For plan/plan phase discounts,
-       * this can be a subset of prices.
-       */
-      applies_to_price_ids?: Array<string> | null;
-
       /**
        * Only available if discount_type is `percentage`. This is a number between 0
        * and 1.
        */
       percentage_discount?: number | null;
 
-      /**
-       * Only available if discount_type is `trial`
-       */
-      trial_amount_discount?: string | null;
-
       /**
        * Only available if discount_type is `usage`. Number of usage units that this
        * discount is for
@@ -7870,23 +7649,12 @@ export namespace SubscriptionSchedulePlanChangeParams {
        */
       amount_discount?: string | null;
 
-      /**
-       * List of price_ids that this discount applies to. For plan/plan phase discounts,
-       * this can be a subset of prices.
-       */
-      applies_to_price_ids?: Array<string> | null;
-
       /**
        * Only available if discount_type is `percentage`. This is a number between 0
        * and 1.
        */
       percentage_discount?: number | null;
 
-      /**
-       * Only available if discount_type is `trial`
-       */
-      trial_amount_discount?: string | null;
-
       /**
        * Only available if discount_type is `usage`. Number of usage units that this
        * discount is for
@@ -7967,23 +7735,12 @@ export namespace SubscriptionSchedulePlanChangeParams {
        */
       amount_discount?: string | null;
 
-      /**
-       * List of price_ids that this discount applies to. For plan/plan phase discounts,
-       * this can be a subset of prices.
-       */
-      applies_to_price_ids?: Array<string> | null;
-
       /**
        * Only available if discount_type is `percentage`. This is a number between 0
        * and 1.
        */
       percentage_discount?: number | null;
 
-      /**
-       * Only available if discount_type is `trial`
-       */
-      trial_amount_discount?: string | null;
-
       /**
        * Only available if discount_type is `usage`. Number of usage units that this
        * discount is for
@@ -8043,23 +7800,12 @@ export namespace SubscriptionSchedulePlanChangeParams {
        */
       amount_discount?: string | null;
 
-      /**
-       * List of price_ids that this discount applies to. For plan/plan phase discounts,
-       * this can be a subset of prices.
-       */
-      applies_to_price_ids?: Array<string> | null;
-
       /**
        * Only available if discount_type is `percentage`. This is a number between 0
        * and 1.
        */
       percentage_discount?: number | null;
 
-      /**
-       * Only available if discount_type is `trial`
-       */
-      trial_amount_discount?: string | null;
-
       /**
        * Only available if discount_type is `usage`. Number of usage units that this
        * discount is for
@@ -8119,23 +7865,12 @@ export namespace SubscriptionSchedulePlanChangeParams {
        */
       amount_discount?: string | null;
 
-      /**
-       * List of price_ids that this discount applies to. For plan/plan phase discounts,
-       * this can be a subset of prices.
-       */
-      applies_to_price_ids?: Array<string> | null;
-
       /**
        * Only available if discount_type is `percentage`. This is a number between 0
        * and 1.
        */
       percentage_discount?: number | null;
 
-      /**
-       * Only available if discount_type is `trial`
-       */
-      trial_amount_discount?: string | null;
-
       /**
        * Only available if discount_type is `usage`. Number of usage units that this
        * discount is for
@@ -8195,23 +7930,12 @@ export namespace SubscriptionSchedulePlanChangeParams {
        */
       amount_discount?: string | null;
 
-      /**
-       * List of price_ids that this discount applies to. For plan/plan phase discounts,
-       * this can be a subset of prices.
-       */
-      applies_to_price_ids?: Array<string> | null;
-
       /**
        * Only available if discount_type is `percentage`. This is a number between 0
        * and 1.
        */
       percentage_discount?: number | null;
 
-      /**
-       * Only available if discount_type is `trial`
-       */
-      trial_amount_discount?: string | null;
-
       /**
        * Only available if discount_type is `usage`. Number of usage units that this
        * discount is for
@@ -8271,23 +7995,12 @@ export namespace SubscriptionSchedulePlanChangeParams {
        */
       amount_discount?: string | null;
 
-      /**
-       * List of price_ids that this discount applies to. For plan/plan phase discounts,
-       * this can be a subset of prices.
-       */
-      applies_to_price_ids?: Array<string> | null;
-
       /**
        * Only available if discount_type is `percentage`. This is a number between 0
        * and 1.
        */
       percentage_discount?: number | null;
 
-      /**
-       * Only available if discount_type is `trial`
-       */
-      trial_amount_discount?: string | null;
-
       /**
        * Only available if discount_type is `usage`. Number of usage units that this
        * discount is for
@@ -8347,23 +8060,12 @@ export namespace SubscriptionSchedulePlanChangeParams {
        */
       amount_discount?: string | null;
 
-      /**
-       * List of price_ids that this discount applies to. For plan/plan phase discounts,
-       * this can be a subset of prices.
-       */
-      applies_to_price_ids?: Array<string> | null;
-
       /**
        * Only available if discount_type is `percentage`. This is a number between 0
        * and 1.
        */
       percentage_discount?: number | null;
 
-      /**
-       * Only available if discount_type is `trial`
-       */
-      trial_amount_discount?: string | null;
-
       /**
        * Only available if discount_type is `usage`. Number of usage units that this
        * discount is for
@@ -8423,23 +8125,12 @@ export namespace SubscriptionSchedulePlanChangeParams {
        */
       amount_discount?: string | null;
 
-      /**
-       * List of price_ids that this discount applies to. For plan/plan phase discounts,
-       * this can be a subset of prices.
-       */
-      applies_to_price_ids?: Array<string> | null;
-
       /**
        * Only available if discount_type is `percentage`. This is a number between 0
        * and 1.
        */
       percentage_discount?: number | null;
 
-      /**
-       * Only available if discount_type is `trial`
-       */
-      trial_amount_discount?: string | null;
-
       /**
        * Only available if discount_type is `usage`. Number of usage units that this
        * discount is for
@@ -8499,23 +8190,12 @@ export namespace SubscriptionSchedulePlanChangeParams {
        */
       amount_discount?: string | null;
 
-      /**
-       * List of price_ids that this discount applies to. For plan/plan phase discounts,
-       * this can be a subset of prices.
-       */
-      applies_to_price_ids?: Array<string> | null;
-
       /**
        * Only available if discount_type is `percentage`. This is a number between 0
        * and 1.
        */
       percentage_discount?: number | null;
 
-      /**
-       * Only available if discount_type is `trial`
-       */
-      trial_amount_discount?: string | null;
-
       /**
        * Only available if discount_type is `usage`. Number of usage units that this
        * discount is for
@@ -8575,23 +8255,12 @@ export namespace SubscriptionSchedulePlanChangeParams {
        */
       amount_discount?: string | null;
 
-      /**
-       * List of price_ids that this discount applies to. For plan/plan phase discounts,
-       * this can be a subset of prices.
-       */
-      applies_to_price_ids?: Array<string> | null;
-
       /**
        * Only available if discount_type is `percentage`. This is a number between 0
        * and 1.
        */
       percentage_discount?: number | null;
 
-      /**
-       * Only available if discount_type is `trial`
-       */
-      trial_amount_discount?: string | null;
-
       /**
        * Only available if discount_type is `usage`. Number of usage units that this
        * discount is for
@@ -8651,23 +8320,12 @@ export namespace SubscriptionSchedulePlanChangeParams {
        */
       amount_discount?: string | null;
 
-      /**
-       * List of price_ids that this discount applies to. For plan/plan phase discounts,
-       * this can be a subset of prices.
-       */
-      applies_to_price_ids?: Array<string> | null;
-
       /**
        * Only available if discount_type is `percentage`. This is a number between 0
        * and 1.
        */
       percentage_discount?: number | null;
 
-      /**
-       * Only available if discount_type is `trial`
-       */
-      trial_amount_discount?: string | null;
-
       /**
        * Only available if discount_type is `usage`. Number of usage units that this
        * discount is for
@@ -8727,23 +8385,12 @@ export namespace SubscriptionSchedulePlanChangeParams {
        */
       amount_discount?: string | null;
 
-      /**
-       * List of price_ids that this discount applies to. For plan/plan phase discounts,
-       * this can be a subset of prices.
-       */
-      applies_to_price_ids?: Array<string> | null;
-
       /**
        * Only available if discount_type is `percentage`. This is a number between 0
        * and 1.
        */
       percentage_discount?: number | null;
 
-      /**
-       * Only available if discount_type is `trial`
-       */
-      trial_amount_discount?: string | null;
-
       /**
        * Only available if discount_type is `usage`. Number of usage units that this
        * discount is for
@@ -8803,23 +8450,12 @@ export namespace SubscriptionSchedulePlanChangeParams {
        */
       amount_discount?: string | null;
 
-      /**
-       * List of price_ids that this discount applies to. For plan/plan phase discounts,
-       * this can be a subset of prices.
-       */
-      applies_to_price_ids?: Array<string> | null;
-
       /**
        * Only available if discount_type is `percentage`. This is a number between 0
        * and 1.
        */
       percentage_discount?: number | null;
 
-      /**
-       * Only available if discount_type is `trial`
-       */
-      trial_amount_discount?: string | null;
-
       /**
        * Only available if discount_type is `usage`. Number of usage units that this
        * discount is for
@@ -8867,6 +8503,20 @@ export interface SubscriptionUpdateFixedFeeQuantityParams {
   effective_date?: string | null;
 }
 
+export interface SubscriptionUpdateTrialParams {
+  /**
+   * The new date that the trial should end, or the literal string `immediate` to end
+   * the trial immediately.
+   */
+  trial_end_date: (string & {}) | 'immediate';
+
+  /**
+   * If true, shifts subsequent price and adjustment intervals (preserving their
+   * durations, but adjusting their absolute dates).
+   */
+  shift?: boolean;
+}
+
 export namespace Subscriptions {
   export import Subscription = SubscriptionsAPI.Subscription;
   export import SubscriptionUsage = SubscriptionsAPI.SubscriptionUsage;
@@ -8887,4 +8537,5 @@ export namespace Subscriptions {
   export import SubscriptionTriggerPhaseParams = SubscriptionsAPI.SubscriptionTriggerPhaseParams;
   export import SubscriptionUnscheduleFixedFeeQuantityUpdatesParams = SubscriptionsAPI.SubscriptionUnscheduleFixedFeeQuantityUpdatesParams;
   export import SubscriptionUpdateFixedFeeQuantityParams = SubscriptionsAPI.SubscriptionUpdateFixedFeeQuantityParams;
+  export import SubscriptionUpdateTrialParams = SubscriptionsAPI.SubscriptionUpdateTrialParams;
 }