Delete Items

Deletes inventory for multiple products in a single request. Accepts an array of up to 1,000 product identifiers per request (each specified by partNumber, upc, or sku); the recommended batch size is 500 items. The operation is asynchronous — the endpoint returns immediately with one job ID per affected location for progress tracking. Use dryRun: true to preview deletion scope before executing. For batch sizing, self-throttling patterns, step-by-step execution workflow, and job monitoring guidance, see the Bulk Inventory Deletion guide.

POST /commerce/inventory/v5/inventory/deleteItems

Error

A valid request URL is required to generate request examples

200

{
  "dryRun": true,
  "itemsDeleted": [
    {
      "auditIDs": [
        123
      ],
      "inventoryIDs": [
        123
      ],
      "itemIdentifier": {
        "partNumber": "<string>",
        "sku": "<string>",
        "upc": "<string>"
      },
      "locationCodes": [
        "<string>"
      ],
      "locationIDs": [
        123
      ],
      "productID": 123
    }
  ],
  "jobIDs": true,
  "totalAuditsDeleted": true,
  "totalInventoryEntriesDeleted": true,
  "totalLocationsAffected": true,
  "totalPickWavesDeleted": true,
  "totalProductsDeleted": true
}

Authorizations

Authorization · string · header · required

JWT Authorization header using the Bearer scheme.

Query Parameters

x-vol-site · integer

Site ID

Body

application/json

Request to batch delete items

Request needed for deleting inventory

allLocations · boolean

Flag used to request deletion of inventory across all locations (overrides locationCodes).

dryRun · boolean

Flag used to differentiate between a test and a non-test run.

explicit · boolean

Flag used to request explicit inventory, location, pick wave, and audit information for each request item.

items · Item · object[]

List of items to delete. Supports basic regex operators: .*+?^$[]

Show child attributes

locationCodes · string[]

An array of locationCodes to be considered for item-deletion purposes. Optional. All locationCodes associated with the requesting tenant will be considered if no locationCodes are provided.

tags · object

Associative Map of <String, String> for tagCategoryName => tagName

Show child attributes

Response

200

application/json

Success

Delete Item Response

dryRun · boolean

Flag used to differentiate between a test and a non-test run.

itemsDeleted · M_DeleteItem · object[]

Items deleted due to the request

Show child attributes

jobIDs · boolean

Flag used to differentiate between a test and a non-test run.

totalAuditsDeleted · boolean

Flag used to differentiate between a test and a non-test run.

totalInventoryEntriesDeleted · boolean

Flag used to differentiate between a test and a non-test run.

totalLocationsAffected · boolean

Flag used to differentiate between a test and a non-test run.

totalPickWavesDeleted · boolean

Flag used to differentiate between a test and a non-test run.

totalProductsDeleted · boolean

Flag used to differentiate between a test and a non-test run.