---
title: Bulk Delete Keywords
framework: Apple Ads Platform API
role: symbol
role_heading: Web Service Endpoint
platforms: [apple ads platform api 1.0+, apple-ads-platform-api 1.0+]
path: apple-ads-platform-api/post-keywords-bulk-delete
---

# Bulk Delete Keywords

Soft-deletes multiple keywords in a single request.

## URL

POST https://api.ads.apple.com/v1/keywords/bulk-delete

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

## See Also

### Keywords

- [Bulk Create Keywords](apple-ads-platform-api/post-keywords-bulk-create.md)
- [Bulk Update Keywords](apple-ads-platform-api/post-keywords-bulk-update.md)