Skip to main content
PUT
cURL
Set a specific price as the default and return the updated plan price.

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

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