<!--
{
  "availability" : [
    "apple-ads-platform-api: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Apple-Ads-Platform-API",
  "identifier" : "/documentation/Apple-Ads-Platform-API/POST-keywords-bulk-delete",
  "metadataVersion" : "0.1.0",
  "role" : "Web Service Endpoint",
  "symbol" : {
    "kind" : "Web Service Endpoint",
    "modules" : [
      "Apple Ads Platform API"
    ],
    "preciseIdentifier" : "rest:apple-ads-platform-api:post:keywords-bulk-delete"
  },
  "title" : "Bulk Delete Keywords"
}
-->

# Bulk Delete Keywords

Soft-deletes multiple keywords in a single request.

## Discussion

Each item in `items` requires a `correlationId`, unique within the batch, and a `data` object with the `id` of the keyword to delete. The API processes each deletion independently.

When `allowPartialSuccess: true` is set in the request, this endpoint uses partial success semantics: if some items fail (for example, an already-deleted ID fails with `ENTITY_NOT_FOUND`), the API still processes the successful deletions. When omitted or `false`, any single item failure rejects the entire batch. The response includes a per-item result with each item’s `correlationId` and success status, with failed items reporting `success: false`. It doesn’t include the deleted keyword.

Deleted keywords are marked `deleted: true` and stop serving. To stop a keyword from serving temporarily, set `status: PAUSED` with the bulk update endpoint instead.

## Payload Examples

**Bulk Delete:**

### Request

Soft-delete two keywords.

```http
POST /v1/keywords/bulk-delete

{
 "items": [
   {
     "correlationId": 0,
     "data": {
       "id": 888999000
     }
   },
   {
     "correlationId": 1,
     "data": {
       "id": 888999001
     }
   }
 ]
}
```

### Response

```json
{
 "result": [
   {
     "correlationId": 0,
     "operation": "DELETE",
     "success": true
   },
   {
     "correlationId": 1,
     "operation": "DELETE",
     "success": true
   }
 ]
}
```

---

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)