Start a bulk product deletion

Delete many products in one request. Products are deleted by the same rules as the Delete button in IO Web; the ones that were not deleted are listed in failures with a reason code. The request is checked and saved, then the products are deleted in the background: follow the result with GET /products/bulk-deletions/{id}. A request takes up to 500 product IDs; only one bulk deletion per company runs at a time. Send an Idempotency-Key to retry safely: the same key with the same request answers 202 with the bulk deletion already created, the same key with a different request answers 409. IDs are integers; a string of digits only, such as "12", is accepted too.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
product_ids
array of integers
required
length between 1 and 500

IDs of the products to delete, in the order they are processed. Each is unique within the request.

product_ids*
Headers
string
length between 1 and 255

Optional key of 1 to 255 printable UTF-8 characters, unique within the company and kept for good. A repeated request with the same key and the same body returns the bulk deletion already created, and starts it again if it is still pending; with a different body the answer is 409.

Responses

400

Request body is not a JSON object

401

Unauthorized: rejected by the API gateway

403

Forbidden: the secret or the vendor API key is not valid

409

Another bulk deletion is in progress, or the Idempotency-Key conflicts.

422

Validation failed: the Idempotency-Key, or product_ids is missing, is not a list, is empty, has more than 500 items, or has an item that is not a positive integer or repeats an earlier one

503

The bulk deletion could not be started. With an Idempotency-Key, send the same request again

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json