Delete store category

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

Use this when a partner integration needs to remove a storefront category from the authenticated community's catalog.

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 category identified by categoryID is deleted or soft-deleted by the store service

Publishes delete:category

Downstream store service processes the deletion

Rate limits:

Standard API rate limits apply

Constraints:

categoryID must identify a category in the API key's community

Products assigned to the category are handled according to source store-service behavior

Delete endpoints do not accept a request body

Upstream store-service failures return 502

Example — delete:

{ "categoryID": "507f1f77bcf86cd799439021" }

Related endpoints:

GET /categories — list store categories

POST /categories — create a store category

GET /categories/{categoryID} — read a single store category

PUT /categories/{categoryID} — update a store category

Request