Bulk Update Negative Keywords
Update multiple negative keywords in a single request.
URL
POST https://api.ads.apple.com/v1/negative-keywords/bulk-updateHeader Parameters
| Name | Type | Description |
|---|---|---|
X-Ap-Context Required | string |
Response Codes
| Status | Reason | Type | Description |
|---|---|---|---|
| 200 | OK Content-Type: application/json | NegativeKeywordUpdateBulkResponse | |
| 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 multiple negative keywords in a single API call. The request body contains an items array where each item wraps a BulkNegativeKeywordUpdate object with a correlationId. Each item must include the id of the negative keyword to update along with only the fields being changed. Unset fields retain their current values.
When allowPartialSuccess: true is set in the request, this endpoint uses partial success semantics: if some items fail validation (for example, an ID that doesn’t exist), the API still applies the successful updates. When omitted or false, any single item failure rejects the entire batch. The response includes a per-item result array with each item’s correlationId, success status, the updated object, and any error details for failures.