Skip to main content
Permanently deletes several files or folders in one request. Deleting a folder also deletes everything inside it, recursively. To delete a single item, use Delete Item.
This is destructive and irreversible. If any item is a folder, every file and subfolder under it is removed. Confirm with the user before calling this endpoint.
Deleting a file that is referenced by one or more project documents does not automatically remove those documents. Call Delete Documents first if you want the documents to disappear from a project.
Permission required: drive:item_delete · service

Body Parameters

string[]
required
IDs of the items to delete, 1 to 100 per request. Your workspace root (MY_SPACE) cannot be deleted: if the list includes it, the whole request is rejected with 403 and nothing is deleted.

Response

boolean
Indicates if the request was successful
string
Human-readable status message
If an item can’t be deleted, the request stops and returns an error. Check the remaining items with Get Item before you retry.