Skip to main content
POST
Act on Campaigns

Authorizations

Authorization
string
header
required

Bearer API key for server-to-server access. Session auth is also supported in first-party UI flows.

Body

application/json
action
enum<string>
required
Available options:
approve,
run,
approve_and_run,
end,
resume,
retry,
approve_change,
discard_change,
archive,
restore,
delete
campaigns
object[]
required

1–20 campaign targets with the revision read from get_campaigns; duplicate targets are executed once in first-requested order.

Required array length: 1 - 20 elements
organizationId
string

Required for session auth. Optional for an API key, which already identifies the organization.

Required string length: 1 - 120

Response

Canonical operation result. Inspect aggregate and per-target success and marketplace delivery evidence.

success
boolean
required
succeededCount
integer
required
Required range: 0 <= x <= 9007199254740991
failedCount
integer
required
Required range: 0 <= x <= 9007199254740991
action
string
required
campaignIds
string[]
required
results
object[]
required