ads_delete_ad
Delete (archive) ads (creatives) across ALL ad products via the unified Amazon Ads API v1.
destructiveAmazon Adsads.v1
In the v1 model an "ad" is the creative unit inside an ad group; a sponsored ad's advertised product is inside its creative (productCreative for SP, componentCreative for SB and SD, videoCreative for ST) — ad associations (ads_query_ad_association) are AMAZON_DSP's ad-to-ad-group links, not product links. Amazon Ads API · DeleteAd · POST /adsApi/v1/delete/ads Docs: https://advertising.amazon.com/API/docs/en-us/api-spec-v1-ads#tag/Ads/operation/DeleteAd Gate: commit — interactive: restate exactly what will happen, wait for a typed CONFIRM; autopilot: only within the seller's instruction and stated limits; otherwise ask.
Call it
In an AI client (MCP)
{
"name": "ads_delete_ad",
"arguments": {
"store": "myStore-US",
"countryCode": "<countryCode>",
"body": {}
}
}From code (Tool API)
curl -X POST https://api.sellersheetai.com/api/v1/tools/ads_delete_ad \
-H "Authorization: Bearer $SELLERSHEET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"store":"myStore-US","countryCode":"<countryCode>","body":{}}'Arguments
| Name | Type | Description |
|---|---|---|
storerequired | string | the store ref `<store>-<CC>` (name-country, e.g. 'myStore-US') — one of get_user_context's store_refs, verbatim. |
countryCoderequired | string | the Ads profile's 2-letter country code (e.g. 'US'). |
bodyrequired | object | {adIds: [...]} — an ID array, not a filter. |
Result
Every tool answers {notification, data, human_action}; data carries:
- 207 {success, partialSuccess, error}. HTTP success does not mean every item succeeded; read error[] by index.
data.result.success[].ad— each deleted ad; error[] items were not.
Gotchas
- AMAZON_DSP ads cannot be deleted here (Amazon has no DSP DeleteAd); SB takes at most 10 ids per call, SD and ST 100.