Delete Item

DELETE 
/api/items/deleteitem/:id

Tier: Public — stable, supported for third-party integration.

Soft-deletes a single item.

Sets IsDeleted and detaches the item's tag (making it available for reuse), writing an Items.ItemTagReplacementHistoryDto row. Raises SystemEventType.ItemDeleted and adjusts SkuPlaceStock.

Request

Responses

200

true on success.

400

The item does not exist (NotFound), or its current state does not allow deletion — deletable from Present, Missing, Moved, Cleared, Consumed, Received, and Returned; not deletable from Allocated, Reserved, Dispatched, OnLoan (active-order involvement), or Restored.

401

Caller is not authenticated.

403

Caller does not have Delete permission on the Item module.