Delete an Ad
Soft-deletes an ad by its unique identifier, stopping delivery and removing it from active results.
URL
DELETE https://api.ads.apple.com/v1/ads/{id}Path Parameters
| Name | Type | Description |
|---|---|---|
id Required | string |
Header Parameters
| Name | Type | Description |
|---|---|---|
X-Ap-Context Required | string |
Response Codes
| Status | Reason | Type | Description |
|---|---|---|---|
| 200 | OK Content-Type: application/json | Response | |
| 400 | Bad Request Content-Type: application/json | ErrorResponse | |
| 401 | Unauthorized Content-Type: application/json | ErrorResponse | |
| 403 | Forbidden Content-Type: application/json | ErrorResponse | |
| 404 | Not Found Content-Type: application/json | ErrorResponse | |
| 429 | Too Many Requests Content-Type: application/json | ErrorResponse | |
| 500 | Internal Server Error Content-Type: application/json | ErrorResponse |
Discussion
This endpoint soft-deletes an ad by its ID. The system marks the ad deleted: true, and it immediately stops serving. The system preserves the record and excludes it from query results by default, but a GET request still returns the ad with deleted: true. A subsequent PUT request to update a deleted ad returns 404 Not Found.
Deleting an ad doesn’t affect the associated ad creative. The ad creative remains available, and new ads in any ad group can reference it. Deleting an ad doesn’t affect delivery of other ads in the same ad group that reference the same or different ad creatives.
To change which ad creative an ad group serves, delete the existing ad and create a new ad with the desired creativeId in the same ad group.
Deleting an ad has the following effects:
Constraint | Detail |
|---|---|
Soft delete only | The system marks the ad |
Delivery stops immediately | The deleted ad stops serving as soon as the system processes the delete. |
Deleted ads return from GET | GET requests after deletion return the ad with |
PUT returns 404 after deletion | Attempting to update a deleted ad returns 404 Not Found. |
Deleted ads excluded from queries |
|
Associated ad creative is not deleted | The ad creative record is unaffected. Other ads can use it. |
To swap an ad creative | Delete this ad and create a new ad with the desired |