---
title: Delete an Ad
framework: Apple Ads Platform API
role: symbol
role_heading: Web Service Endpoint
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/delete-ads-_id_
---

# 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

id:

## Header Parameters

X-Ap-Context:

## Response Codes

200 OK: 400 Bad Request: 401 Unauthorized: 403 Forbidden: 404 Not Found: 429 Too Many Requests: 500 Internal Server Error:

## Discussion

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:  |   |   |   |   |   |   |   |  Payload Examples

## See Also

- [Create an Ad](apple-ads-platform-api/post-ads.md)
- [Query Ads](apple-ads-platform-api/post-ads-query.md)
- [Get an Ad](apple-ads-platform-api/get-ads-_id_.md)
- [Update an Ad](apple-ads-platform-api/put-ads-_id_.md)