Categories

Delete categories by inodes

Changed on

Deletes one or more categories and all their descendants at every depth. EDIT permission is validated on each selected category and every descendant before anything is deleted; a category that fails validation is skipped whole. Accepts a JSON array of category inodes. Inodes that could not be deleted are reported in the fails list of the result with the failure reason (category does not exist, insufficient permissions, or a permission-protected descendant). successCount counts the requested inodes that were deleted, while deletedCount counts every category actually removed, descendants included.

delete/api/v1/categories

Request

Request body

string[] required

Response

Bulk delete result returned

i18nMessagesMapobject
permissionsstring[]

Changes

    • breaking

      request body became required

    • breaking

      removed the media type */* from the request body

    • info

      api operation id delete_6 removed and replaced with deleteCategories

    • info

      api tag Categories added

    • info

      added the media type application/json to the request body

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the success response with the status