---
title: Update a Keyword
framework: Apple Ads Platform API
role: symbol
role_heading: Web Service Endpoint
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/put-keywords-_id_
---

# Update a Keyword

Update a keyword’s bid amount or status to optimize spend and control delivery for that term.

## URL

PUT https://api.ads.apple.com/v1/keywords/{id}

## Path Parameters

id:

## Header Parameters

X-Ap-Context:

## Response Codes

200 OK: 400 Bad Request: 401 Unauthorized: 403 Forbidden: 404 Not Found: 429 Too Many Requests: 500 Internal Server Error:

## Discussion

Discussion This endpoint updates an existing keyword. Only fields included in the request body are modified. Omitted fields retain their current values. The KeywordUpdate schema is intentionally narrow. Only bid and status are accepted. Attempting to update a deleted keyword returns 404 Not Found. This differs from Get a Keyword, which doesn’t return 404 for a deleted keyword. It returns the keyword with deleted: true instead. On update, bid must be a valid Money object. Passing null returns an error, unlike Create a Keyword, where omitting bid or passing null defaults the keyword to the ad group’s bid strategy. See Managing Keywords and Negative Keywords for the full explanation. Payload Examples

## See Also

- [Create a Keyword](apple-ads-platform-api/post-keywords.md)
- [Query Keywords](apple-ads-platform-api/post-keywords-query.md)
- [Get a Keyword](apple-ads-platform-api/get-keywords-_id_.md)
- [Delete a Keyword](apple-ads-platform-api/delete-keywords-_id_.md)