---
title: Update Ad Group Negative Keywords
framework: Apple Ads
role: symbol
role_heading: Web Service Endpoint
platforms: [search ads 5.0+]
path: apple_ads/update-ad-group-negative-keywords
---

# Update Ad Group Negative Keywords

Updates negative keywords in an ad group.

## URL

PUT https://api.searchads.apple.com/api/v5/campaigns/{campaignId}/adgroups/{adgroupId}/negativekeywords/bulk

## Path Parameters

adgroupId: The unique identifier for the ad group. campaignId: The unique identifier for the campaign.

## Response Codes

200 OK: If the call succeeds, the API returns a list of NegativeKeyword objects in the response payload with an HTTP status code of 200(OK). If unsuccessful, the HTTP status code indicates the error with details in the error message. 400 Bad Request: An invalid query or missing required parameters. 401 Unauthorized: An unauthenticated call fails to get the requested response. 403 Forbidden: Insufficient rights to the resource. 404 Not Found: The API can’t locate the resource. 429 : The API calls exceed rate-limit thresholds. See the Rate Limits subsection of Calling the Apple Ads API. 500 Internal Server Error: The Apple Ads server is temporarily down or unreachable. The request may be valid, but you need to retry it later.

## Discussion

Discussion To update negative keywords, use the associated campaignId and adgroupId in the URI. The id in the payload must belong to a negative keyword that exists inside the ad group in the URI. Use PAUSED or ACTIVE values to update the status field. Use partial updates to edit a subset of object properties without having to include all object properties in the payload. For more information, see the Use Partial Updates section of Using Apple Ads API Functionality. Payload example: Update ad group negative keywords

## HTTP Body

The request body that includes negative keyword details.

## See Also

### Ad Group Negative Keywords Endpoints

- [Create Ad Group Negative Keywords](apple_ads/create-ad-group-negative-keywords.md)
- [Find Ad Group Negative Keywords](apple_ads/find-ad-group-negative-keywords.md)
- [Get an Ad Group Negative Keyword](apple_ads/get-an-ad-group-negative-keyword.md)
- [Get All Ad Group Negative Keywords](apple_ads/get-all-ad-group-negative-keywords.md)
- [Delete Ad Group Negative Keywords](apple_ads/delete-ad-group-negative-keywords.md)