Skip to main content

Bulk Delete Products

DELETE 

/api/products

Bulk delete multiple products. For large datasets, deletion is processed in the background via a queue.

Required scope: products:write

Grant 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 filters instead of an explicit ids list. An empty filters object 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

OK

Response Headers
    Content-Type