---
title: Update an Ad
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-ads-_id_
---

# Update an Ad

Updates the name or status of an existing ad by its unique identifier.

## URL

PUT https://api.ads.apple.com/v1/ads/{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 ad. Only name and status are mutable. The creativeId and adGroupId fields can’t be changed after the ad is created. The system modifies only the fields included in the request body. Omitted fields retain their current values. To change which ad creative an ad group serves, create a new ad with the desired creativeId and delete the old one. This pattern ensures ad delivery history remains traceable per ad. Payload Examples

## See Also

- [Create an Ad](apple-ads-platform-api/post-ads.md)
- [Query Ads](apple-ads-platform-api/post-ads-query.md)
- [Get an Ad](apple-ads-platform-api/get-ads-_id_.md)
- [Delete an Ad](apple-ads-platform-api/delete-ads-_id_.md)