Skip to main content

Create or Restore Category

POST 
/api/v1/customer-data/taxonomies/:taxonomyLevelCustomId/categories

Creates a new category at the given taxonomy level, or restores a soft-deleted category with the same customId at the same level (201 in both cases).

Create: A new row is inserted. businessId must be unique among live siblings (same parent). parentCustomId, if provided, must resolve to a live category at the level immediately above.

Restore: If a soft-deleted category with the same customId exists at this level it is restored. name and description are updated from the request body; businessId and parentCustomId are immutable and ignored on restore.

Request​

Responses​

Category created or restored.