Skip to main content
PATCH
cURL
Update a base price or market price variant. Removing a base market override is rejected while a variant depends on it. Offer terms are managed through Offers.

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

Cuerpo

application/json
price
integer
Rango requerido: 0 <= x <= 9007199254740991
isDefault
boolean
trialDays
integer
Rango requerido: 0 <= x <= 9007199254740991
includedBalance
integer | null
Rango requerido: -9007199254740991 <= x <= 9007199254740991
includedCredits
integer | null
Rango requerido: -9007199254740991 <= x <= 9007199254740991
metadata
object

Metadata keys to merge into the existing price metadata.

marketPrices
object[]

Respuesta

Success

id
string
requerido

Public plan price ID.

planId
string
requerido
billingInterval
enum<string>
requerido
Opciones disponibles:
weekly,
monthly,
quarterly,
yearly,
one_time
price
integer
requerido

Price in the currency's minor unit (for example, cents for USD).

Rango requerido: -9007199254740991 <= x <= 9007199254740991
isDefault
boolean
requerido
trialDays
integer
requerido
Rango requerido: -9007199254740991 <= x <= 9007199254740991
includedBalance
integer | null
requerido
Rango requerido: -9007199254740991 <= x <= 9007199254740991
includedCredits
integer | null
requerido
Rango requerido: -9007199254740991 <= x <= 9007199254740991
offerId
string | null
requerido

Automatic introductory offer for this price.

inheritsFromPriceId
string | null
requerido

Public base price ID for a market price variant, or null for a base price.

metadata
object
requerido

Application metadata. Variant display names may use metadata.name.

marketPrices
object[]
requerido

Country-market overrides. Variants inherit their base price for every market not listed.

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