<!--
{
  "availability" : [
    "Apple Ads Platform API: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Apple-Ads-Platform-API",
  "identifier" : "/documentation/Apple-Ads-Platform-API/AdUpdate",
  "metadataVersion" : "0.1.0",
  "role" : "Object",
  "symbol" : {
    "kind" : "Object",
    "modules" : [
      "Apple Ads Platform API"
    ],
    "preciseIdentifier" : "data:apple-ads-platform-api:AdUpdate"
  },
  "title" : "AdUpdate"
}
-->

# AdUpdate

The request body for updating an existing Ad object.

```
object AdUpdate
```

## Discussion

To modify an existing ad, use `AdUpdate` with `PUT /v1/ads/{id}` ([`Update an Ad`](/documentation/Apple-Ads-Platform-API/PUT-ads-_id_)). You can change only `name` and `status` after creation. The system locks in the ad’s creative, ad group, campaign, and ad account at creation. Omit any field you don’t want to update.

Setting `status` to `PAUSED` immediately stops the ad from entering auctions. Switching it back to `ENABLED` resumes participation.

### Example

```json
{
  "name": "AwayFinder Summer Sale Ad",
  "status": "PAUSED"
}
```

## Topics

### Type Aliases

[`string AdUpdate.Status`](/documentation/Apple-Ads-Platform-API/AdUpdate/Status-data.typealias)

Advertiser-configurable status set when updating an ad.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)