Bulk Delete Products
DELETE/api/products
Bulk delete multiple products. For large datasets, deletion is processed in the background via a queue.
products:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Authentication: Requires Bearer token.
Body fields (one of ids, filters, or apply_to_all is required):
- ids (array, required without
filters/apply_to_all): specific product IDs to delete - filters (object, required without
ids/apply_to_all): filter criteria to select products for deletion - apply_to_all (boolean, optional): Targets every product matching the active
filtersinstead of an explicitidslist. An emptyfiltersobject is indistinguishable from an absent one, so this flag is what keeps an unfiltered "select all" valid — send{"apply_to_all": true, "filters": {}}to delete every product.
Requires permission: products.delete
Request
Responses
- 200
- 401
- 403
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.