🚧
Unified endpoint
This endpoint supports both regular items and motion ads. You can also mix both ad types in the same request.

Example

POST /backstage/api/1.0/demo-advertiser/items/bulk

{
    "items_to_update": [
        309,
        801,
        573
    ]
}

{
    "results": [{
            "id": "309",
            "campaign_id": "33",
            "type": "ITEM",
            "url": "https://www.example.com/news/demo_article_9.html",
            "thumbnail_url": "http://cdn.example.com/demo_image_9.jpg",
            "title": "Demo Article 9",
            "description": null,
            "approval_state": "APPROVED",
            "is_active": false,
            "status": "STOPPED",
            "policy_review": {
                "reject_reason": null,
                "status_reason": null
            },
            "cta": null,
            "creative_focus": {
                "type": "AUTOMATIC",
                "coordinates": null
            }
        },
        {
            "id": "801",
            "campaign_id": "270",
            "type": "ITEM",
            "url": "https://www.example.com/news/demo_article_1.html",
            "thumbnail_url": "http://cdn.example.com/demo_image_1.jpg",
            "title": "Demo Article 1",
            "description": null,
            "approval_state": "APPROVED",
            "is_active": false,
            "status": "STOPPED",
            "policy_review": {
                "reject_reason": null,
                "status_reason": null
            },
            "cta": null,
            "creative_focus": {
                "type": "AUTOMATIC",
                "coordinates": null
            }
        },
        {
            "id": "573",
            "campaign_id": "163",
            "type": "ITEM",
            "url": "https://www.example.com/news/demo_article_3.html",
            "thumbnail_url": "http://cdn.example.com/demo_image_3.jpg",
            "title": "Demo Article 3",
            "description": null,
            "approval_state": "APPROVED",
            "is_active": false,
            "status": "STOPPED",
            "policy_review": {
                "reject_reason": null,
                "status_reason": null
            },
            "cta": null,
            "creative_focus": {
                "type": "AUTOMATIC",
                "coordinates": null
            }
        },
    ],
    "metadata": {
        ...
    }
}

📘
The request object must include a single property: items_to_update (a list of Item IDs to delete, passed as numbers).
These items can belong to different campaigns under your account.

🚧
Guidelines

To bulk delete items use the DELETE verb.

Limit each request to a maximum of 200 items.

By default, if the delete operation fails for 1 item, then no items will be deleted. To override this behavior, pass is_atomic=false.

The endpoint supports both regular items and motion ads. You can also mix both ad types in the same request.

Deleted items have a status of STOPPED. Any attempt to reference that Item ID will return 404 Not Found.

🚧
The network account
You can use a network account to delete items across the network: DELETE backstage/api/1.0/{network-account}/items/bulk
For more information about the network account see: Network Accounts.

📘
See also

Bulk update items across campaigns (above).

Delete a Campaign Item.

200200

400400