---
title: Delete a Keyword
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-keywords-_id_
---

# Delete a Keyword

Soft-delete a keyword by ID, setting its deleted field to true and stopping bids on that term.

## URL

DELETE https://api.ads.apple.com/v1/keywords/{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 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.  |   |   |   |   |   |  Payload Examples

## See Also

- [Create a Keyword](apple-ads-platform-api/post-keywords.md)
- [Query Keywords](apple-ads-platform-api/post-keywords-query.md)
- [Get a Keyword](apple-ads-platform-api/get-keywords-_id_.md)
- [Update a Keyword](apple-ads-platform-api/put-keywords-_id_.md)