Set the default price
Sets the default price for the product. The price must be active and must belong to this product. Setting the same price twice is idempotent. Returns the base product shape; use GET to retrieve enrichment data.
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.
255Path Parameters
The product id (prod_…).
Body
The price to set as default (price_…).
Response
The product with its new default price id set.
Product id (prod_…).
product true for live mode, false for test mode.
The product's default price (price_…), or null if none is set.
Unit displayed at checkout.
digital, physical, service, donation, other Unix epoch seconds.
Unix epoch seconds.
Inline-expanded default price. Present on GET and list responses; omitted on mutation endpoints (create, update, set_default_price).
Display-only fallback populated when no default is set but exactly one price exists. Present on GET and list responses; omitted on mutation endpoints. Must not be treated as the assigned default.
Total number of prices on this product. Present on GET and list responses; omitted on mutation endpoints.

