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.

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

action and the provider call was made, or "pending_approval" when the action now awaits a human decision (202-style: accepted, not performed).