PricePatch

Any subset of writable fields. At least one is required. Unknown or read-only fields are rejected.

billing_scheme
Type: "per_unit" or "tiered" or nullenum

per_unit: quantity × unit_amount. tiered: the tiers decide, in tiers_mode.
currency
Type: string | null

ISO 4217, lowercase.
ensemble_id
Type: string | nullFormat: uuid

The ensemble this price is for, when the product’s price depends on who plays it. Empty: the product’s price for any ensemble. References ensembles.id.
label
Type: string | null

Internal nickname, e.g. "10-piece, 2027".
lookup_key
Type: string | null

A stable handle, unique per band, e.g. "reception.10pc". For seeds, UI and sync.
order
Type: number | null
product_id
Type: string | nullFormat: uuid

References products.id.
status
Type: "active" or "inactive" or nullenum

Active prices are offered for new lines; inactive are retired. Lines already sold keep pointing at a retired price.
tiers
Type: object | null

When tiered: an array of {up_to, unit_amount, flat_amount}, ascending, the last with up_to null. Amounts in minor units. "$220 for the first 8, $27.50 each after" is [{up_to: 8, flat_amount: 22000}, {up_to: null, unit_amount: 2750}].

Properties: 1
tiers_mode
Type: "graduated" or "volume" or nullenum

graduated: each tier charges for the units that fall in it. volume: the tier the total quantity lands in prices every unit.
unit_amount
Type: number | null

Integer minor units (cents) per unit, when billing_scheme is per_unit.