orb-billing 4.29.0 → 4.31.0

package/resources/subscriptions.d.ts

@@ -878,6 +878,27 @@ export declare class Subscriptions extends APIResource {
      * for the difference for the remainder of the billing period.
      */
     updateFixedFeeQuantity(subscriptionId: string, body: SubscriptionUpdateFixedFeeQuantityParams, options?: Core.RequestOptions): Core.APIPromise<Subscription>;
+    /**
+     * 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>;
 }
 export declare class SubscriptionsPage extends Page<Subscription> {
 }
@@ -1956,11 +1977,22 @@ export interface SubscriptionCreateParams {
      * this property or `external_plan_id` must be specified.
      */
     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
      */
     price_overrides?: Array<SubscriptionCreateParams.OverrideUnitPrice | SubscriptionCreateParams.OverridePackagePrice | SubscriptionCreateParams.OverrideMatrixPrice | SubscriptionCreateParams.OverrideTieredPrice | SubscriptionCreateParams.OverrideTieredBpsPrice | SubscriptionCreateParams.OverrideBpsPrice | SubscriptionCreateParams.OverrideBulkBpsPrice | SubscriptionCreateParams.OverrideBulkPrice | SubscriptionCreateParams.OverrideThresholdTotalAmountPrice | SubscriptionCreateParams.OverrideTieredPackagePrice | SubscriptionCreateParams.OverrideTieredWithMinimumPrice | SubscriptionCreateParams.OverridePackageWithAllocationPrice | SubscriptionCreateParams.OverrideUnitWithPercentPrice | SubscriptionCreateParams.OverrideGroupedAllocationPrice | SubscriptionCreateParams.OverrideGroupedWithProratedMinimumPrice | SubscriptionCreateParams.OverrideGroupedWithMeteredMinimumPrice | SubscriptionCreateParams.OverrideBulkWithProrationPrice | SubscriptionCreateParams.OverrideUnitWithProrationPrice | SubscriptionCreateParams.OverrideTieredWithProrationPrice> | 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 declare namespace SubscriptionCreateParams {
     interface BillingCycleAnchorConfiguration {
@@ -2029,20 +2061,11 @@ export declare namespace SubscriptionCreateParams {
              * Only available if discount_type is `amount`.
              */
             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
@@ -2101,20 +2124,11 @@ export declare namespace SubscriptionCreateParams {
              * Only available if discount_type is `amount`.
              */
             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
@@ -2190,20 +2204,11 @@ export declare namespace SubscriptionCreateParams {
              * Only available if discount_type is `amount`.
              */
             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
@@ -2273,20 +2278,11 @@ export declare namespace SubscriptionCreateParams {
              * Only available if discount_type is `amount`.
              */
             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
@@ -2361,20 +2357,11 @@ export declare namespace SubscriptionCreateParams {
              * Only available if discount_type is `amount`.
              */
             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
@@ -2432,20 +2419,11 @@ export declare namespace SubscriptionCreateParams {
              * Only available if discount_type is `amount`.
              */
             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
@@ -2516,20 +2494,11 @@ export declare namespace SubscriptionCreateParams {
              * Only available if discount_type is `amount`.
              */
             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
@@ -2595,20 +2564,11 @@ export declare namespace SubscriptionCreateParams {
              * Only available if discount_type is `amount`.
              */
             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
@@ -2656,20 +2616,11 @@ export declare namespace SubscriptionCreateParams {
              * Only available if discount_type is `amount`.
              */
             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
@@ -2717,20 +2668,11 @@ export declare namespace SubscriptionCreateParams {
              * Only available if discount_type is `amount`.
              */
             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
@@ -2778,20 +2720,11 @@ export declare namespace SubscriptionCreateParams {
              * Only available if discount_type is `amount`.
              */
             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
@@ -2839,20 +2772,11 @@ export declare namespace SubscriptionCreateParams {
              * Only available if discount_type is `amount`.
              */
             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
@@ -2900,20 +2824,11 @@ export declare namespace SubscriptionCreateParams {
              * Only available if discount_type is `amount`.
              */
             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
@@ -2961,20 +2876,11 @@ export declare namespace SubscriptionCreateParams {
              * Only available if discount_type is `amount`.
              */
             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
@@ -3022,20 +2928,11 @@ export declare namespace SubscriptionCreateParams {
              * Only available if discount_type is `amount`.
              */
             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
@@ -3083,20 +2980,11 @@ export declare namespace SubscriptionCreateParams {
              * Only available if discount_type is `amount`.
              */
             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
@@ -3144,20 +3032,11 @@ export declare namespace SubscriptionCreateParams {
              * Only available if discount_type is `amount`.
              */
             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
@@ -3205,20 +3084,11 @@ export declare namespace SubscriptionCreateParams {
              * Only available if discount_type is `amount`.
              */
             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
@@ -3266,20 +3136,11 @@ export declare namespace SubscriptionCreateParams {
              * Only available if discount_type is `amount`.
              */
             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
@@ -5922,10 +5783,21 @@ export interface SubscriptionSchedulePlanChangeParams {
      * this property or `external_plan_id` must be specified.
      */
     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
      */
     price_overrides?: Array<SubscriptionSchedulePlanChangeParams.OverrideUnitPrice | SubscriptionSchedulePlanChangeParams.OverridePackagePrice | SubscriptionSchedulePlanChangeParams.OverrideMatrixPrice | SubscriptionSchedulePlanChangeParams.OverrideTieredPrice | SubscriptionSchedulePlanChangeParams.OverrideTieredBpsPrice | SubscriptionSchedulePlanChangeParams.OverrideBpsPrice | SubscriptionSchedulePlanChangeParams.OverrideBulkBpsPrice | SubscriptionSchedulePlanChangeParams.OverrideBulkPrice | SubscriptionSchedulePlanChangeParams.OverrideThresholdTotalAmountPrice | SubscriptionSchedulePlanChangeParams.OverrideTieredPackagePrice | SubscriptionSchedulePlanChangeParams.OverrideTieredWithMinimumPrice | SubscriptionSchedulePlanChangeParams.OverridePackageWithAllocationPrice | SubscriptionSchedulePlanChangeParams.OverrideUnitWithPercentPrice | SubscriptionSchedulePlanChangeParams.OverrideGroupedAllocationPrice | SubscriptionSchedulePlanChangeParams.OverrideGroupedWithProratedMinimumPrice | SubscriptionSchedulePlanChangeParams.OverrideGroupedWithMeteredMinimumPrice | SubscriptionSchedulePlanChangeParams.OverrideBulkWithProrationPrice | 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 declare namespace SubscriptionSchedulePlanChangeParams {
     interface OverrideUnitPrice {
@@ -5974,20 +5846,11 @@ export declare namespace SubscriptionSchedulePlanChangeParams {
              * Only available if discount_type is `amount`.
              */
             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
@@ -6046,20 +5909,11 @@ export declare namespace SubscriptionSchedulePlanChangeParams {
              * Only available if discount_type is `amount`.
              */
             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
@@ -6135,20 +5989,11 @@ export declare namespace SubscriptionSchedulePlanChangeParams {
              * Only available if discount_type is `amount`.
              */
             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
@@ -6218,20 +6063,11 @@ export declare namespace SubscriptionSchedulePlanChangeParams {
              * Only available if discount_type is `amount`.
              */
             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
@@ -6306,20 +6142,11 @@ export declare namespace SubscriptionSchedulePlanChangeParams {
              * Only available if discount_type is `amount`.
              */
             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
@@ -6377,20 +6204,11 @@ export declare namespace SubscriptionSchedulePlanChangeParams {
              * Only available if discount_type is `amount`.
              */
             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
@@ -6461,20 +6279,11 @@ export declare namespace SubscriptionSchedulePlanChangeParams {
              * Only available if discount_type is `amount`.
              */
             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
@@ -6540,20 +6349,11 @@ export declare namespace SubscriptionSchedulePlanChangeParams {
              * Only available if discount_type is `amount`.
              */
             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
@@ -6601,20 +6401,11 @@ export declare namespace SubscriptionSchedulePlanChangeParams {
              * Only available if discount_type is `amount`.
              */
             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
@@ -6662,20 +6453,11 @@ export declare namespace SubscriptionSchedulePlanChangeParams {
              * Only available if discount_type is `amount`.
              */
             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
@@ -6723,20 +6505,11 @@ export declare namespace SubscriptionSchedulePlanChangeParams {
              * Only available if discount_type is `amount`.
              */
             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
@@ -6784,20 +6557,11 @@ export declare namespace SubscriptionSchedulePlanChangeParams {
              * Only available if discount_type is `amount`.
              */
             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
@@ -6845,20 +6609,11 @@ export declare namespace SubscriptionSchedulePlanChangeParams {
              * Only available if discount_type is `amount`.
              */
             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
@@ -6906,20 +6661,11 @@ export declare namespace SubscriptionSchedulePlanChangeParams {
              * Only available if discount_type is `amount`.
              */
             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
@@ -6967,20 +6713,11 @@ export declare namespace SubscriptionSchedulePlanChangeParams {
              * Only available if discount_type is `amount`.
              */
             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
@@ -7028,20 +6765,11 @@ export declare namespace SubscriptionSchedulePlanChangeParams {
              * Only available if discount_type is `amount`.
              */
             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
@@ -7089,20 +6817,11 @@ export declare namespace SubscriptionSchedulePlanChangeParams {
              * Only available if discount_type is `amount`.
              */
             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
@@ -7150,20 +6869,11 @@ export declare namespace SubscriptionSchedulePlanChangeParams {
              * Only available if discount_type is `amount`.
              */
             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
@@ -7211,20 +6921,11 @@ export declare namespace SubscriptionSchedulePlanChangeParams {
              * Only available if discount_type is `amount`.
              */
             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
@@ -7265,6 +6966,18 @@ 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 declare namespace Subscriptions {
     export import Subscription = SubscriptionsAPI.Subscription;
     export import SubscriptionUsage = SubscriptionsAPI.SubscriptionUsage;
@@ -7285,5 +6998,6 @@ export declare namespace Subscriptions {
     export import SubscriptionTriggerPhaseParams = SubscriptionsAPI.SubscriptionTriggerPhaseParams;
     export import SubscriptionUnscheduleFixedFeeQuantityUpdatesParams = SubscriptionsAPI.SubscriptionUnscheduleFixedFeeQuantityUpdatesParams;
     export import SubscriptionUpdateFixedFeeQuantityParams = SubscriptionsAPI.SubscriptionUpdateFixedFeeQuantityParams;
+    export import SubscriptionUpdateTrialParams = SubscriptionsAPI.SubscriptionUpdateTrialParams;
 }
 //# sourceMappingURL=subscriptions.d.ts.map