Skip to main content
PATCH
Update a rate-card discount row

Authorizations

Authorization
string
header
required

API key or access token

Path Parameters

id
integer
required

Surrogate id of the house-discount row.

Required range: 1 <= x <= 9007199254740991
Example:

17

Body

application/json

Partial update for a rate-card discount. Only discountPercent and notes are mutable; house_domain and scope are immutable — delete and recreate to change either.

discountPercent
number

Discount percent off the storefront quote for buys whose brand or operator resolves to this domain. 0–100. The larger of this and any buyer-specific instruction wins; the quote is floored at the wholesale cost.

Required range: 0 <= x <= 100
Example:

20

notes
string | null
Maximum string length: 2000

Response

Update a rate-card discount row

A single house-scoped buyer-discount row.

id
string
required

Surrogate id (BIGINT serialized as string).

Example:

"17"

storefrontId
string
required

Storefront the row belongs to (BIGINT serialized as string).

Example:

"1234"

houseDomain
string
required
scope
enum<string>
required

Which buyer axis this discount applies to: brand matches the buy's advertiser brand (and its corporate parents/house), operator matches the buying operator (agency/DSP, and its parents/house). When both a brand and an operator discount match a buy, the larger applies (a tie resolves to the brand axis).

Available options:
brand,
operator
Example:

"brand"

discountPercent
number
required
notes
string | null
required
createdAt
string<date-time>
required
Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
updatedAt
string<date-time>
required
Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
createdBy
string | null
required