Delete store product

Deletes one store product for the API-key's community and returns the deleted product ID.

Use this when a partner integration needs to remove a product, reward, voucher, or catalog item from the authenticated community's storefront.

Authentication:

Bearer API key in Authorization header

API key must have the store permission

Community is resolved from the API key token — do not pass communityID

Returns 401 if the key is missing, invalid, or expired

Returns 403 if the key does not include the store permission

Side effects:

The product identified by productID is deleted or soft-deleted by the store service

Publishes delete:product

Downstream store service processes the deletion

Rate limits:

Standard API rate limits apply

Constraints:

productID must identify a product in the API key's community

Delete endpoints do not accept a request body

Upstream store-service failures return 502

Example — delete:

{ "productID": "507f1f77bcf86cd799439031" }

Related endpoints:

GET /products — list active store products

POST /products — create a store product

GET /products/{productID} — read a single store product

PUT /products/{productID} — update a store product

Request