Category — Delete (GraphQL)

Deletes a category. The only input field is id (the category IRI). The mutation is refused for the root category and for any category referenced as a channel's root category — those return an error and the record is kept. The payload returns a snapshot of the deleted record's scalar fields.

TIP

See the Categories overview for how the menu works.

Errors

Condition	Message
Root category or a channel root category	Root and channel-root categories cannot be deleted.
Unknown id	Category not found.

For bulk deletion, use createAdminCategoryMassDelete.

All admin operations require an admin Bearer token — see Authentication.