Delete workspace items in bulk
Workspace
Delete workspace items in bulk
POST
Delete workspace items in bulk
Delete up to 100 workspace items — workbooks, reports, and folders, mixed freely — in a single request.
Request body:
items— the items to delete, each{ type, id }withtypeone ofWORKBOOK,REPORT,FOLDER. Repeated references to the same item are collapsed, so the response holds exactly one entry per distinct item requested.
200 whenever the request itself is well formed, and reports each item’s outcome separately:
deleted— the(type, id)of each item that was deleted.failed— the items that were not deleted, each with the(type, id)requested and anerrorcarrying thestatusandmessagethe per-type delete endpoint would have returned for it (403when the caller lacks access,404when the item does not exist or belongs to another deployment,400when a folder still has sub-folders).
failed array means the whole batch applied. Items are deleted one at a time in the order given, each in its own transaction, so deletions are not rolled back when a later item fails — the response is the record of what was applied. Deleting a folder does not delete the workbooks, dashboards, and reports directly inside it: they are detached and returned to the workspace root, matching DELETE /folders/:folderId.
Access is checked per item with the same rules as the per-type delete endpoints: manage access for a workbook or folder, and edit access plus the report-manage permission for a report.Authorizations
Token authentication. Send Authorization: Bearer <YOUR_TOKEN>.
Path Parameters
Body
application/json
BulkDeleteWorkspaceObjectsInput
Required array length:
1 - 100 elements