Saltar al contenido principal
POST
Create plan draft
Start a draft from a version of the plan: the current one, an experiment’s version or an older one. A plan can have any number of drafts. Edit it, then publish it as the current version, as an experiment or as an experiment’s next version; nothing changes for buyers or subscribers until then.

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

Cuerpo

application/json
fromVersionId
string

The version to start from: the current version, an experiment's version or an older version. Defaults to the current version.

Respuesta

Success

id
string
requerido

Public plan draft ID.

fromVersionId
string
requerido

The version the draft started from.

changes
object[]
requerido

What the draft changes against the version it started from.

createdAt
string<date-time>
requerido
updatedAt
string<date-time>
requerido
object
string
requerido
Allowed value: "plan_draft"
livemode
boolean
requerido