<!--
{
  "availability" : [
    "Apple Ads Platform API: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Apple-Ads-Platform-API",
  "identifier" : "/documentation/Apple-Ads-Platform-API/PUT-ads-_id_",
  "metadataVersion" : "0.1.0",
  "role" : "Web Service Endpoint",
  "symbol" : {
    "kind" : "Web Service Endpoint",
    "modules" : [
      "Apple Ads Platform API"
    ],
    "preciseIdentifier" : "rest:apple-ads-platform-api:put:ads-{}"
  },
  "title" : "Update an Ad"
}
-->

# Update an Ad

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

## 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

**Pause Ad:**

Pause an ad by setting `status` to `PAUSED`. Send only the field you want to change.

### Request

```json
PUT /v1/ads/777888999

{
 "status": "PAUSED"
}
```

### Response

```json
{
 "result": {
   "id": 777888999,
   "adAccountId": 123456789,
   "campaignId": 444555666,
   "adGroupId": 555666777,
   "creativeId": 666777888,
   "name": "AwayFinder - Default Product Page",
   "status": "PAUSED",
   "systemStatus": "NOT_RUNNING",
   "systemStatusReasons": [
     "PAUSED_BY_USER"
   ],
   "systemStatusLimitingReasons": [],
   "displayStatus": "PAUSED",
   "deleted": false,
   "creationTime": "2025-09-01T08:00:00.000",
   "modificationTime": "2025-10-01T10:00:00.000"
 }
}
```

**Rename Ad:**

Rename an ad by sending only the `name` field. Status and all other fields remain unchanged.

### Request

```json
PUT /v1/ads/777888999

{
 "name": "AwayFinder - Holiday Product Page"
}
```

### Response

```json
{
 "result": {
   "id": 777888999,
   "adAccountId": 123456789,
   "campaignId": 444555666,
   "adGroupId": 555666777,
   "creativeId": 666777888,
   "name": "AwayFinder - Holiday Product Page",
   "status": "ENABLED",
   "systemStatus": "RUNNING",
   "systemStatusReasons": [],
   "systemStatusLimitingReasons": [],
   "displayStatus": "RUNNING",
   "deleted": false,
   "creationTime": "2025-09-01T08:00:00.000",
   "modificationTime": "2025-10-15T14:00:00.000"
 }
}
```

---

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)