Skip to main content
POST
Evaluate a media buy against acceptance policy

Authorizations

Authorization
string
header
required

API key or access token

Path Parameters

mediaBuyId
string
required

Buyer-supplied media buy identifier (AdCP media_buy_id).

Minimum string length: 1

Query Parameters

buyerCustomerId
integer

Buyer customer id that disambiguates a buyer-scoped media-buy id. Omit only when the id is unique for this storefront.

Required range: 0 < x <= 9007199254740991

Response

Evaluate a media buy against acceptance policy

Brief Acceptance evaluation for a storefront media buy on the manual approval path. Definitely-on-policy buys auto-forward; ambiguous, failed, and hard findings enter the current human-review queue unless an existing per-buyer override bypasses the gate.

mediaBuyId
string
required

Buyer-supplied media buy identifier that was evaluated.

evaluatorId
string
required

Stable evaluator implementation id.

evaluatorVersion
string
required

Evaluator implementation version.

policyDecision
enum<string>
required

definitely_on_policy means this buy is eligible under Brief Acceptance. needs_human_approval is the safe escalation default. definitely_not_on_policy means the payload clearly conflicts with Brief Acceptance and supplies a strong operator-facing rejection signal.

Available options:
definitely_on_policy,
definitely_not_on_policy,
needs_human_approval
recommendation
enum<string>
required

Evaluator recommendation for the manual approval path. auto_approve = definitely on policy. escalate_to_human = eligibility needs operator review. auto_reject = hard deterministic Brief Acceptance violation and strong operator-facing rejection signal. In the current rollout, create_media_buy queues auto_reject findings for human review; LLM conflicts only escalate.

Available options:
auto_approve,
escalate_to_human,
auto_reject
rejectionReason
string | null
required

When recommendation is auto_reject, an evaluator-generated explanation naming the acceptance-policy terms the buy matched (drawn from the operator's policy). Null otherwise.

summary
string
required

Short evaluator summary.

checks
object[]
required

Individual policy, advertiser, and quoted-product checks supporting the recommendation.