Skip to main content
POST /api/v2/storefront/creative-reviews/{creativeId}/decide Records a terminal decision on a pending creative review. Only pending → approved and pending → rejected transitions are allowed — revoking a previously-approved creative is a separate gesture and revoked is not a valid value here. Approved creatives are forwarded to the underlying sales agent verbatim; your reviewer note travels back to the buyer in their sync_creatives follow-up.

​
Request

curl -X POST \
  "https://api.interchange.io/api/v2/storefront/creative-reviews/cr_abc123/decide" \
  -H "Authorization: Bearer $SCOPE3_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "approved"
  }'

​
Parameters

FieldTypeRequiredNotes
creativeIdstringYesPath param — AdCP creative id as supplied by the buyer
statusenumYesDecision to record. approved or rejected only — revoked is not allowed here
reviewer_notesstringNoFree-text note visible to the buyer in their sync_creatives follow-up. Max 2000 chars

​
Response

{
  "id": "42",
  "storefrontId": "1234",
  "creativeId": "cr_abc123",
  "mediaBuyId": "mb_2026_q2_ctv",
  "buyerCustomerId": 8801,
  "submittedPayload": {
    "creative_id": "cr_abc123",
    "format": "video",
    "media_url": "https://cdn.acme-brand.example/spots/launch-30s.mp4"
  },
  "status": "rejected",
  "reviewedBy": "5567",
  "reviewedAt": "2026-06-02T13:45:00Z",
  "reviewerNotes": "Logo lockup violates publisher brand-safety guidelines",
  "createdAt": "2026-06-02T11:00:00Z",
  "updatedAt": "2026-06-02T13:45:00Z"
}
Returns the decided CreativeReviewResponse. reviewedBy, reviewedAt, and updatedAt are stamped at decision time. Deciding a row that is already decided is rejected — re-deciding is not a no-op.

​
Errors

  • 400 VALIDATION_ERROR — missing status, or status is not approved or rejected.
  • 404 NOT_FOUND — no creative review row with that id exists for your storefront.
See Errors for the full error contract.

Get a review

Inspect the creative before deciding

List reviews

See the pending queue

Creative review tasks

All creative-review operations

Creative reviews overview

Queue lifecycle and concepts