Skip to main content
POST
Preview a plan change (v2, swap in place)

Authorizations

x-api-key
string
header
required

Enter your API key in the format x-api-key <api-key>*

Path Parameters

id
string
required

Subscription ID

Body

application/json

Plan change request

proration_behavior
enum<string>
required
Available options:
create_prorations,
none
target_plan_id
string
required
billing_period_behaviour
enum<string>
Available options:
unchanged,
anchor_at_effect,
anchor_at_config
billing_period_config
object
change_at
enum<string>
Available options:
immediate,
end_of_period
entity_policies
object
idempotency_key
string
metadata
object
on_conflict_policies
object

Response

OK

billing_period
object
change_type
enum<string>
Available options:
upgrade,
downgrade,
lateral
changed_resources
object
effective_at
string<date-time>
entity_changes
object[]
from_plan
object
is_scheduled
boolean

IsScheduled is true when the change was deferred to the period end instead of being applied immediately.

metadata
object
schedule_id
string
scheduled_at
string<date-time>
subscription
object
superseded_schedules
string[]

SupersededSchedules lists the plan-change schedules this request cancelled under on_conflict_policies.on_pending_schedule. Preview reports what execute would cancel.

to_plan
object
warnings
string[]