Delete an Inventory Item

Permanently deletes an inventory item. This cannot be undone.

Orders that already reference the SKU retain their line items, but will no longer match an inventory record, so stock will not be adjusted for them.

delete

Authorizations

ORDERDESK-API-KEYstringRequired

Your API key, found under Store Settings on the API tab. This should be kept server-side.

ORDERDESK-STORE-IDstringRequired

Your store ID, found under Store Settings on the API tab.

Path parameters

inventory_item_idintegerRequired

Order Desk's internal ID for the inventory item.

Example: 100009

Responses

200

The item was deleted.

application/json

statusstring · enumRequired

Either success or error.

Possible values:

messagestringOptional

Describes the result. Always present when an error occurs.

execution_timestringOptional

Time taken to process the request.

Example: 0.1524 seconds

401

Authentication failed. See the Authentication guide, and note that an invalid store ID blocks your store rather than simply failing the request.

application/json

404

No record matches that ID in your store.

application/json

429

You are sending too fast. Wait X-Retry-After seconds. See the Rate Limits guide.

application/json

default

The request could not be completed.

application/json

delete/inventory-items/{inventory_item_id}

curl "https://app.orderdesk.me/api/v2/inventory-items/100009" \
  -X DELETE \
  -H "ORDERDESK-STORE-ID: your-store-id" \
  -H "ORDERDESK-API-KEY: your-api-key"

{
  "status": "success",
  "message": "Inventory Item 2509 Deleted",
  "execution_time": "0.0836 seconds"
}