Skip to main content
POST
SetPaidMediaCampaignStatusAPI mirrors erdo_set_paid_media_campaign_status:

Authorizations

Authorization
string
header
required

An Erdo API key (erdo_api_...) or scoped token (erdo_token_...).

Path Parameters

externalID
string
required

Body

application/json
customer_id
string

customer ID, 10 digits, dashes allowed). Required — campaign ids are only unique within an account.

provider
string

supported today; anything else is rejected with Unimplemented.

reason
string

shown on the approval card as the WHY beside the WHAT.

status
string

deliberately not exposed over /v1 — it is destructive, not lifecycle.

Response

Success response

action_display
string

it appears on the approval card.

approval_request_id
string

"pending_approval". Decide it via POST /v1/approvals/{id}/decide or the activity feed; on approval the action executes. Re-proposing the same change dedupes onto this id.

decline
DeclineHold is the gate's answer when a human already declined this subject, · object

said why, and nothing new has been said since. No card was filed; the proposer is told the decline so it can stop, or re-propose with a different reason when the facts have changed.

result
Result is the provider's response when Status is "executed". · object
status
string

action and the provider call was made, "pending_approval" when the action now awaits a human decision (202-style: accepted, not performed), or "declined" when a person's recent reasoned rejection of this same change holds and no card was filed (see Decline).