Update a price list
Send only what changes. rules replaces the whole set. New prices apply to purchases and renewals from now on; sales already recorded keep the price they were made at. A change sends a price_list.updated event naming the settings that moved and the customers on the list.
apiKeyAuthorizationBearer <token>An API key from the Developers page. rhq_test_ keys reach the sandbox, rhq_live_ keys the live side.
id*stringapplication/json- body
name?string1 <= length <= 80markupBps?integerMarkup over wholesale for anything no rule covers, in basis points
0 <= value <= 1000000rounding?string99 and 00 round worked-out prices up to the next amount ending that way
"99""none""00"allowBelowCost?booleanrenewals?stringfollow prices each renewal from the list as it is then; hold charges what the customer last paid for that item
"follow""hold"currency?stringThe currency customers on this list are charged in
"USD""EUR""GBP""CAD""AUD""NZD""CHF""SEK""NOK""DKK""PLN""INR""SGD""HKD""AED""ZAR""BRL""MXN"rate?integerHow much of the currency one US dollar buys, in millionths: 920000 is 0.92. Always 1000000 for USD
10000 <= value <= 100000000000rules?array<>items <= 200isDefault?trueMakes this the default list
trueSuccess
application/json- response
Success
id*stringname*string1 <= length <= 80markupBps*integerMarkup over wholesale for anything no rule covers, in basis points
0 <= value <= 1000000rounding*string99 and 00 round worked-out prices up to the next amount ending that way
"99""none""00"allowBelowCost*booleanFalse raises any price that would sit under wholesale up to wholesale
renewals*stringfollow prices each renewal from the list as it is then; hold charges what the customer last paid for that item
"follow""hold"currency*stringThe currency customers on this list are charged in
"USD""EUR""GBP""CAD""AUD""NZD""CHF""SEK""NOK""DKK""PLN""INR""SGD""HKD""AED""ZAR""BRL""MXN"rate*integerHow much of the currency one US dollar buys, in millionths: 920000 is 0.92. Always 1000000 for USD
isDefault*booleanThe list for customers with none of their own
rules*array<>customers*integerHow many customers are on this list
actor*|Who created or last updated this list
createdAt*stringdate-timeupdatedAt*stringdate-timecurl -X PATCH "https://example.com/v1/price-lists/prl_01K6XJ4Q8ZT3M9R5V2B7WDHNCA" \ -H "Content-Type: application/json" \ -d '{}'{ "id": "prl_01K6XJ4Q8ZT3M9R5V2B7WDHNCA", "name": "Agency", "markupBps": 2000, "rounding": "99", "allowBelowCost": true, "renewals": "follow", "currency": "USD", "rate": 1000000, "isDefault": true, "rules": [ { "id": "prr_01K6XJ4Q8ZT3M9R5V2B7WDHNCA", "product": "number", "match": "com", "term": "30d", "action": "new", "minQuantity": 10, "kind": "markup", "value": 2500 } ], "customers": 3, "actor": { "kind": "user", "label": "string" }, "createdAt": "2026-10-07T11:04:31.000Z", "updatedAt": "2026-10-07T11:04:31.000Z"}