delete
https://backstage.taboola.com/backstage/api/1.0/creatives/bulk
Delete creatives across one or more accounts in a single request. Each element carries its own account_id and id. The operation is atomic: if any creative cannot be deleted, none are deleted. Every ad created from a deleted creative is stopped.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Overview
Delete creatives across one or more accounts in a single request. There is no account in the path: each element carries its own account_id and id. The deleted creatives are returned with status = TERMINATED.
DELETE /backstage/api/1.0/creatives/bulk{
"elements": [
{
"value": {
"account_id": "demo-advertiser",
"id": 4321000001
},
"error": null
},
{
"value": {
"account_id": "demo-advertiser",
"id": 4321000002
},
"error": null
}
]
}{
"elements": [
{
"value": {
"id": 4321000001,
"name": "Summer sale hero",
"account_id": "demo-advertiser",
"status": "TERMINATED",
"creative_type": "STATIC_IMAGE",
...
},
"error": null
},
{
"value": {
"id": 4321000002,
"name": "Summer sale motion",
"account_id": "demo-advertiser",
"status": "TERMINATED",
"creative_type": "PERFORMANCE_VIDEO",
...
},
"error": null
}
]
}{
"http_status": 404,
"message": "Instruction not found for one or more IDs"
}
Deleting creatives stops all of their adsEvery ad created from a deleted creative is stopped, in every campaign, and stops serving immediately. This cannot be undone. See Deleting a creative.
Guidelines
- Bulk delete is always atomic: if any creative cannot be deleted (for example an unknown ID), no creatives are deleted. Non-atomic delete is not supported; passing
is_atomic=falsereturns 400.- Each
valueneeds onlyidandaccount_id. Missing either returns 400 (Missing required field).- Limit each request to a maximum of 200 creatives.
- Deleting a creative that is already
TERMINATEDreturns 404.
See also
- Bulk creative operations - how the 3 bulk endpoints differ.
- Delete a creative
- Bulk upsert creatives