Delete a Negative Keyword
Soft-delete a negative keyword by ID.
URL
DELETE https://api.ads.apple.com/v1/negative-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 specified negative keyword by setting its deleted field to true. The record is no longer returned by the query endpoint or by ID. The operation returns HTTP 200 with an empty response body on success.
Once soft-deleted, the previously blocked search terms are no longer suppressed. If the deleted negative keyword was campaign-level, ads across all ad groups in the campaign may begin appearing for those queries again. If it was ad-group-level, only that ad group is affected. To temporarily stop suppression without deleting the negative keyword, use PUT /negative-keywords/{id} with status: "PAUSED". To have the negative keyword start suppressing search terms again, set status: "ENABLED" instead of deleting.
Deletion is permanent. A deleted negative keyword can’t be retrieved, updated, or re-enabled. To suppress those search terms again, create a new negative keyword.
Constraint | Detail |
|---|---|
Soft deletion | Deletion sets |
Exclusion is lifted immediately | Previously blocked search terms are no longer suppressed after deletion. |
GET returns 404 after deletion | GET requests for a deleted negative keyword return 404 Not Found. |
PUT returns 404 after deletion | PUT requests to update a deleted negative keyword return 404 Not Found. |
Use ENABLED status to resume suppression | To have the negative keyword start suppressing search terms again, set |