# Delete a Keyword Soft-delete a keyword by ID, setting its deleted field to true and stopping bids on that term. ## Discussion This endpoint soft-deletes the keyword by setting its deleted field to true. The record remains queryable by including deleted=true in query filters. The operation returns HTTP 200 with an empty response body on success. Deleting a keyword doesn’t affect the parent ad group or campaign. Only the keyword itself is removed. Other keywords in the same ad group continue to serve normally. If you want to temporarily stop bidding on a term without permanently removing it, pause the keyword using `PUT /keywords/{id}` with `status: "PAUSED"` instead. The soft delete is reflected consistently across subsequent GET and PUT requests. |Constraint |Detail | |----------------------------------------|---------------------------------------------------------------------------------------------------------------------------------| |Soft deletion |Deletion sets the keyword’s `deleted` field to `true`. The record remains queryable by including `deleted=true` in query filters.| |Does not affect parent resources |Deletion doesn’t modify the parent ad group or campaign. | |GET returns the deleted keyword |GET requests after deletion return the keyword with `deleted: true`, not a 404. | |PUT returns 404 after deletion |PUT requests to update a deleted keyword return 404 Not Found. | |Use PAUSED status to suspend temporarily|If you may need to reactivate the term, set `status: "PAUSED"` rather than deleting. | ## Payload Examples **Delete Keyword:** ### Request Deletes a keyword by its unique identifier. A successful delete returns HTTP 200 with an empty response body. ``` DELETE https://api.ads.apple.com/v1/keywords/888999000 ``` ### Response ```json {} ``` --- Copyright © 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)