Skip to main content
POST
Record decision

Authorizations

Authorization
string
header
required

API key passed as Bearer token

Headers

X-External-User-ID
string
required

Identifier of the acting user in the calling system (e.g. a Workfront user id). Recorded against every audited action this request performs.

X-External-User-Email
string<email>

Acting user email. Only meaningful on keys with act-on-behalf enabled, where it is resolved to the matching Adclear user and is mandatory on writes. Ignored on ordinary keys.

Path Parameters

promotionId
string<uuid>
required

Promotion ID

versionId
string<uuid>
required

Version ID

Body

application/json
decision
enum<string>
required

The human review decision to record on the version. Uses the same vocabulary as GET .../decision and the review.* webhooks.

Available options:
approved,
rejected,
changes_requested
Example:

"approved"

Response

Decision recorded

success
boolean
required
correlationId
string<uuid>
required

Correlation ID for request tracing. Include in support requests.