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
| 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 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 |
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 |
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 |