Delete Sku

DELETE 
/api/skus/deletesku/:id

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

Soft-deletes a SKU (non-cascading), and raises a SkuDeleted system event. Deletion is not gated by lifecycle state — a Draft, Active, or Discontinued SKU can be deleted as long as it is unused.

Rejected if any item still references the SKU, or if its inner SKU (if any) is still referenced by items. If the SKU has an inner SKU, the inner SKU is soft-deleted along with the outer SKU; additional barcodes are also soft-deleted.

Request

Responses

200

Returns true.

400

The SKU (or its inner SKU) is still in use by one or more items, or {id} does not match an existing SKU (error array).

401

The caller is not authenticated.

403

The caller lacks Sku Delete permission.