Saltar al contenido principal
PATCH
Update plan draft
Change a draft’s prices per interval, trials, the interval shown first, countries with their currency and prices, and credit or balance rules, or undo single changes. Each block sent replaces that block; blocks left out stay as they are. Buyers and subscribers see nothing until the draft is published.

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
draftId
string
requerido

Cuerpo

application/json
prices
object[]

Every interval the draft sells. An interval the draft sold and this list leaves out is removed from the draft.

countries
object[]

Every country with its own currency or prices. A country the draft sold and this list leaves out is removed. A country missing a price blocks publishing.

rules
object

Credit or balance rules; fields left out stay as they are.

undo
string[]

Change keys to put back as the version the draft started from had them.

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