Skip to main content
POST
Bulk update creatives

Authorizations

Authorization
string
header
required

API key or access token

Path Parameters

campaignId
string
required

Campaign ID

Minimum string length: 1

Body

application/json

Bulk update saved campaign creatives. Use dry_run first to confirm the matched set.

selection
object
required

Selectors for a campaign-scoped bulk creative update

update
object
required
dry_run
boolean
default:true

When true, return the matched creative set without applying changes. Defaults to true for human confirmation.

exclude_creative_ids
string[]

Creative IDs to remove from the matched set before applying the update

Maximum array length: 200
Minimum string length: 1
limit
integer
default:200

Maximum number of creatives to match/update

Required range: 1 <= x <= 500
confirm_partial_batch
boolean
default:false

When false, applying a bulk update is rejected if more creatives match than the requested limit. Set true only when the buyer explicitly confirms a partial batch.

Response

Bulk update creatives

Bulk creative update preview or execution result suitable for confirmation UI.

dry_run
boolean
required
matched_count
integer
required
Required range: 0 <= x <= 9007199254740991
total_matches
integer
required
Required range: 0 <= x <= 9007199254740991
returned_count
integer
required
Required range: 0 <= x <= 9007199254740991
truncated
boolean
required
updated_count
integer
required
Required range: 0 <= x <= 9007199254740991
selection
object
required

Selectors for a campaign-scoped bulk creative update

limit
integer
required
Required range: 1 <= x <= 9007199254740991
updates
object
required
creatives
object[]
required
exclude_creative_ids
string[]