Delete a product

DELETE 
/products/:product_id

Delete a product from the catalog. This is a soft delete — the product stops appearing in POST /products/search and can no longer be added to a quote, but quotes and deals that already reference it keep their line-item snapshot, so historical documents are unaffected.

To take a product out of circulation while keeping it in the catalog, prefer archiving it — PATCH /products/{product_id} with {"status": "archived"} — which is reversible.

Scoped to the caller's workspace — a product.* scope is required.

Request

Responses

200

The product was deleted

400

Malformed request

401

Missing or invalid token

404

Resource not found (or not visible to this user's role)