Set the default version
Point the plan’s default at this version, so its floating subscriptions bill from it. Any version may become default, in either direction — this is how you roll a plan back to (or forward to) an earlier price set. Idempotent when the version is already the default.
Authorizations
API key authentication
Path Parameters
Unique identifier for a plan
^plan_[a-zA-Z0-9]+$The version number within the plan (1-based).
x >= 1Body
Sets this version as the plan's default.
Set to true to point the plan's default at this version. Idempotent on the already-default version.
Response
The transitioned plan version
A single plan version, including its price slots. Extends the list summary with the version's prices for draft review.
Unique identifier for a plan version
^pver_[a-zA-Z0-9]+$plan_version Monotonic version number within the plan, starting at 1.
x >= 1Lifecycle status of the version.
draft, published, archived Whether this version is the plan's current default (live) version.
Number of committed-status subscriptions pinned to this version at creation time. Not a live-billing cohort.
x >= 0When this version was last modified. Optimistic-concurrency token: read this value and echo it back as an If-Match header on a draft-price-mutation request to reject the write (412) if the draft changed since this read.
The price slots that make up this version.
When this version was published. Absent for draft versions.
The version this one follows on from — the version that was live when this one was created, and whose prices it was built from. Absent for versions created before this field existed.
^pver_[a-zA-Z0-9]+$