Error
Catalog endpoints
Update a price
Updates active, nickname, and metadata. The unit_amount and currency are immutable.
POST
Error
Authorizations
A merchant secret key (sk_…) sent as Authorization: Bearer <key>.
Headers
A unique key that makes retries safe: the same key with the same request body returns the original response instead of repeating the operation.
Maximum string length:
255Path Parameters
The price id (price_…).
Body
application/json
Response
The updated price.
Price id (price_…).
Available options:
price Parent product (prod_…).
Billing amount in minor units.
Three-letter ISO currency code.
Price type.
Available options:
one_time, recurring Display label for this price variant.
true for live mode, false for test mode.
Unix epoch seconds.
Unix epoch seconds.
Cadence for recurring prices; null for one-time prices.

