Delete categories in bulk
DELETE/v2/categories/bulk/:lookupKey
Removes every category named in the body, each read with the :lookupKey from the URL.
Each key is deleted exactly as the single delete would delete it — the same channel-root, children and assignment checks apply, and every deleted category emits its own event.
A key that cannot be deleted does not fail the request: it lands in failedIds with an entry in failures saying why, and the rest of the batch is deleted regardless. Repeated keys are collapsed, so a key sent twice gets one verdict.
Keys are processed in the order given and nothing is reordered: a parent sent before its own children is refused as CATEGORY_NOT_EMPTY even when the same request goes on to delete those children. Send children first.
Request
Responses
- 200
- 400
- 401
- 403
- 500
Bulk delete completed. Read failures for the keys that were not deleted.
The request payload, path, or query parameters failed validation.
Authentication credentials are missing or invalid.
The authenticated caller is not permitted to perform the operation.
An unexpected error prevented the request from completing.