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
| 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 | AdResponse | |
| 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 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.