Update a Negative Keyword
Update a negative keyword’s status to enable or pause its search term exclusion.
URL
PUT 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 | NegativeKeywordResponse | |
| 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 updates an existing negative keyword. The NegativeKeywordUpdate schema accepts only the status field. Negative keywords don’t have a bid field, and text and matchType are immutable after creation. To change a negative keyword’s text or match type, delete it and create a new one.