POST

Bulk Delete Folders

Temporarily deletes the specified folders from the Media Manager.

The deleted folders are moved to the Media Manager's trash-root folder (trash bin) unless permanently deleted. To permanently delete folders, specify the permanent parameter with the value true. Permanently deleting folders isn't reversible, so make sure that the files in these folders aren't being used in a site or in any other way as the files will no longer be accessible.

Note the following:

  • When a folder is deleted, the files in that folder are deleted.
  • The specified folders can be from different parent folders.
  • Moving multiple folders at once is an asynchronous action, and may take time for the changes to appear in the Media Manager.
  • Attempting to delete folders that are already in the trash bin doesn't result in an error.
  • If a site contains files from a deleted media folder, the files still appear on the site as the deleted folder is still in the Media Manager (in the trash bin).
  • You can also use the Bulk Restore Folders From Trash Bin (SDK | REST) method to restore folders from the Media Manager's trash bin.
Authentication

You can only call this method when authenticated as a Wix app or Wix user identity.

Permissions
Manage Bookings Services and Settings
Manage Media Manager
Manage Events
Manage Portfolio
Access Verticals by Automations
Manage Restaurants - all permissions
Learn more about app permissions.
Endpoint
POST
https://www.wixapis.com/site-media/v1/bulk/folders/delete
Body Params
folderIdsArray <string>RequiredmaxItems 100maxLength 100

IDs of the folders to move to the Media Manager's trash bin.

permanentboolean

Whether the specified folders are permanently deleted.
Default: false

Response Object
Returns an empty object.
Bulk delete folders
Request
cURL
curl -X POST \
  'https://www.wixapis.com/site-media/v1/bulk/folders/delete' \
  -H 'Authorization: <AUTH>' \
  -H 'Content-Type: application/json' \
  --data-binary '{
    "folderIds": ["25284aa06584441ea94338fdcfbaba12", "9v38fdcfbaba12eeb55bcf5c41eca01c0"]
  }'
Response
JSON
{}
Errors

This method doesn’t return any custom errors, but may return standard errors. Learn more about standard Wix errors.

Event TriggersThis method triggers the following events:
Folder Deleted
Did this help?