POST /api/v2/buyer/campaign-suggestion-sets/:campaignSuggestionSetId/approve
Approves the entire set — every media buy it moves budget between. There is no
per-media-buy approval: the members are two sides of one transfer, so approving
part of it would either create budget the campaign never freed or strand budget it
did. See campaign suggestion sets for why.
Only a set in AWAITING_APPROVAL can be approved. A set that has since been
superseded by a newer run, expired because one of its media buys changed, or
already been decided returns 409 — the decision is refused rather than applied
to a recommendation that no longer describes your campaign.
Request
No request body. Approval takes no reason — only
rejection does. A body
sent here is ignored rather than rejected.
Parameters
Response
The approval is recorded against every member suggestion at once, so the set and
its members can never disagree about whether the transfer was accepted.
APPROVED means the transfer is cleared to run, not that it has run. Apostra
then sends the changes to your sellers and confirms each one, moving the set to
APPLYING and on to APPLIED — or reversing the whole transfer if a change
cannot be made. If the reversal itself cannot complete, the set stops at
NEEDS_RECONCILIATION and a person puts the budgets right. How long that takes is up to your sellers: the decreases are
confirmed before any increase is sent, and a reversal waits on them the same way.
Poll
get campaign suggestion set for
the outcome, and see what happens after you
approve.
Errors