Skip to main content
PUT
Set your brand's price for an offering

Authorizations

Authorization
string
header
required

Per-client API key (M2M). Presented as Authorization: Bearer <key>.

Headers

Idempotency-Key
string
required

Required on every mutation. Replaying the same request with the same key returns the original result; reusing the key with a materially different request is rejected 409 with machine code IDEMPOTENCY_CONFLICT.

Minimum string length: 1
X-Client-Id
string
required

Identifies your account. The platform sets this header from your API key when the request is authenticated — you do not send it yourself, and a value you supply is never trusted. Requests without a resolved account identity answer 401 before any processing, and every write is attributed to this identity in the audit trail.

Minimum string length: 1

Path Parameters

brand_id
string
required

The brand to price. Must be one of your account's own brands.

Body

application/json

The price to set. The brand rides the path (one of your account's own brands); the body names the offering and the new amount. The offering must already exist — a price never creates one.

amount_minor
integer
required

the price in integer minor units (USD cents), never a float; zero/negative rejected

Required range: x >= 1
sku
string
required

the offering code, as shown in your offering list

currency
enum<string>

optional; USD is the only supported currency

Available options:
USD

Response

price row updated — or an idempotent replay of the original write

data
object

The price one brand charges for one offering. A price row is configuration, not a charge — the charge happens at checkout, which resolves this row.