WIwistia
Subfolders

Bulk Delete Subfolders

Changed on

Deletes multiple subfolders asynchronously. Their media is also soft-deleted and can be restored from the trash by an account owner or manager until it is purged. To keep the media, use the Delete Subfolder endpoint, which moves it to the folder's root level.

Requires api token with one of the following permissions

Read, update & delete anything

Tokens with the "Act with a team member's permissions" permission (all:delegate_to_contact_permissions scope) can also be used. Requests made with such a token are authorized using the permissions of the contact assigned to the token.

An expiring access token created with the all:delegate_to_contact_permissions scope and an authorization granting the update permission on this folder can also be used.

An expiring access token created with the all:delegate_to_contact_permissions scope and an authorization granting the update permission on the folder can also be used.

delete/folders/{folderId}/subfolders/bulk_delete

Request

  • Base URL
    https://api.wistia.com/modern
  • URL
    https://api.wistia.com/modern/folders/{folderId}/subfolders/bulk_delete
  • Auth
    HTTP bearer

Path parameters

folderIdstring required
Example:abc123def4

The hashed ID of the folder containing the subfolders

Headers

X-Wistia-API-Versionstring required

Request body

hashed_idsstring[] required

An array of the subfolder hashed IDs to be deleted.

Response

Successful queuing of subfolder deletion.

messagestring required

A confirmation message that the background job has been queued.

Changes