Deletes multiple folders asynchronously.
You can use ListFolder to preview the operation using the dryRun parameter.
When deleting a folder with external storage: if the folder at folderPath has overridden storage settings (like an AWS S3 bucket), no files will be deleted, regardless of the parameters you pass. Only the mapping will be removed. If the folder at folderPath has inherited storage settings but includes subfolders with overridden storage settings, files in those subfolders won't be deleted, regardless of the parameters you pass. In summary, files in folders with overridden storage are never deleted, unless you directly delete a subfolder of such a folder.
Requires a secret_* API key. Alternatively, you can use a public_* API key and JWT-based auth.
1curl "https://api.bytescale.com/v2/accounts/{accountId}/folders/batch" \2 -X DELETE \3 -H "Authorization: Bearer YOUR_API_KEY" \4 -H "Content-Type: application/json" \5 -d @- << EOF6 {7 "folders": [8 {9 "deleteFiles": true,10 "deleteVirtualFolders": true,11 "folderPath": "/uploads",12 "recursive": true13 }14 ]15 }16EOF
1{2 "jobDocs": "https://www.bytescale.com/docs/job-api/GetJob",3 "jobId": "01ARZ3NDEKTSV4RRFFQ69G5FAV",4 "jobType": "ExampleJob",5 "jobUrl": "https://api.bytescale.com/v2/accounts/FW25aki/jobs/ExampleJob/01ARZ3NDEKTSV4RRFFQ69G5FAV"6}
Your account ID.
This is visible on the settings page:
https://www.bytescale.com/dashboard/settings
Example: "A623uY2"
Type: String
Length: 7
Add one of these Authorization header values to your request:
•Option 1: prefix "Bearer " to your API key. The result is your Authorization header value.
•Option 2: use HTTP basic authorization with apikey as your username and your API key as your password.
For advanced options, please see:
https://www.bytescale.com/docs/auth
Note: this endpoint requires a secret_* API key.
Type: String
This endpoints requires a JSON request body.
Type: String
Value: "application/json"
This website uses cookies. By continuing you are consenting to the use of cookies per our Cookie Policy. Our legal policies were last updated March 06 2024.
This website requires a modern web browser -- the latest versions of these browsers are supported: