Saltar al contenido principal
POST
Create plan experiment version
Publish the experiment’s next version from its latest version with the changes given. Its code sells the new version from now on; subscribers on its earlier versions stay where they are until moved.

Autorizaciones

x-api-key
string
header
requerido

Encabezados

Idempotency-Key
string

Unique key used to safely retry this write for 24 hours without applying it twice.

Required string length: 1 - 200
Commet-Version
string
predeterminado:2026-08-27

API version used by this reference. Send this header to select this contract explicitly.

Parámetros de ruta

id
string
requerido
code
string
requerido

The experiment's own code, without the plan code: price-test.

Cuerpo

application/json
prices
object[]
currencies
object[]

Currencies the current version does not sell, with the exchange rate (local units per USD) used for the amounts not listed, credit purchases, add-ons and overage.

maxPlanCredits
integer | null

Credits plans that roll over unused credits: the most plan credits a subscription can hold. Null removes the cap.

Rango requerido: 1 <= x <= 2147483647
maxPlanBalance
integer | null

Balance plans that roll over unused balance: the most plan balance a subscription can hold, in USD cents. Other currencies convert it with the plan's exchange rate unless the dashboard sets a custom amount for that currency. Null removes the cap.

Rango requerido: 1 <= x <= 2147483647

Respuesta

Success

id
string
requerido

Public plan version ID.

label
string
requerido

The plan's versions are numbered 1, 2, 3; an experiment's own versions read with its code, such as price-test 2.

number
integer | null
requerido

The plan's version number. Null for a version that only belongs to an experiment; an experiment version made current takes the next number.

Rango requerido: -9007199254740991 <= x <= 9007199254740991
experiment
object | null
requerido

The experiment this version belongs to, if any.

isCurrent
boolean
requerido

Whether new buyers get this version.

parentVersionId
string | null
requerido

The version this one was created from.

subscriptionCount
integer
requerido

Active, trialing, past due and paused subscriptions on it.

Rango requerido: -9007199254740991 <= x <= 9007199254740991
maxPlanCredits
integer | null
requerido
Rango requerido: -9007199254740991 <= x <= 9007199254740991
maxPlanBalance
integer | null
requerido
Rango requerido: -9007199254740991 <= x <= 9007199254740991
prices
object[]
requerido
createdAt
string<date-time>
requerido
object
string
requerido
Allowed value: "plan_version"
livemode
boolean
requerido