v55

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-012046146.0 KB

Delete categories

Delete categories and all their associated children

<h3>Cascading Deletion</h3>

When you delete a category:

Child categories: All child categories in the hierarchy are deleted automatically
Hierarchy Impact: The entire branch below the deleted category is removed

<h3>Recovery Options</h3>

If a category is deleted by mistake:

Time Window: You have up to one week to restore deleted categories
Restoration Method: Recreate the top-level deleted category using the Create category operation
State Recovery: Categories are restored to their exact state from the time of deletion, including all metadata, family associations, and hierarchy relationships
Hierarchy Reconstruction: The entire hierarchy is rebuilt from the restoration payload

post/v1/catalog/categories/delete

Headers

Authorizationstring required

Authorization Bearer token

Content-Type'application/json' required

Content-Encoding'gzip'

Use this header if the payload is compressed with gzip.

Request body

slugstring required

Category slug using hierarchical format with forward slashes to represent parent-child relationships. Must use only lowercase letters, numbers, and hyphens. Examples: 'men', 'men/clothing', 'men/clothing/pants'

Example request

[
  {
    "slug": "men/clothing/pants",
    "source": {
      "locale": "English"
    }
  }
]

Response

All items accepted and will be processed asynchronously