Skip to main content
PUT
Enable or disable per-buyer media-buy auto-approve

Authorizations

Authorization
string
header
required

API key or access token

Path Parameters

buyerCustomerId
integer
required

Customer id of the buyer to opt into (or out of) auto-approve.

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

804

Body

application/json

Enable or disable per-buyer media-buy auto-approve for one buyer. The storefront is resolved from the operator's auth context, never the request body.

enabled
boolean
required

true = this buyer's media buys auto-approve (skip your review queue and acceptance-policy screen). false = remove the carve-out so the buyer follows the storefront default again. The row is kept either way for audit; it is never deleted.

Example:

true

reason
string | null

Freeform operator note for why this buyer is (or is no longer) trusted (e.g. "Goldie/Coke — pre-cleared 2026 always-on"). Omit to preserve the existing note; pass null to clear it.

Maximum string length: 2000

Response

Enable or disable per-buyer media-buy auto-approve

A single per-buyer media-buy auto-approve override.

id
string
required

Surrogate id (BIGINT serialized as string).

Example:

"42"

storefrontId
string
required

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

Example:

"1234"

buyerCustomerId
number
required

Customer id of the trusted buyer (INTEGER).

Example:

804

buyerName
string | null
required

Resolved buyer company/name for operator confirmation. Null if it cannot be resolved.

Example:

"Coca-Cola"

autoApproveEnabled
boolean
required
reason
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

Session user id of the operator who first armed the override (BIGINT serialized as string), when available.

createdByCustomerId
number | null
required

Operator customer id that first armed the override.

updatedByCustomerId
number | null
required

Operator customer id that last changed the override.

policyBypassCount
integer
required

How many of this buyer's media buys were auto-forwarded while enabled even though the acceptance-policy evaluator would have held them. A rising count is a prompt to reconsider the carve-out; it never blocks a buy.

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

0

lastPolicyBypassAt
string<date-time> | null
required

When the most recent policy-flagged buy was auto-forwarded for this buyer, or null if none.

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))$