files.emptyTrash¶
Permanently deletes all files from the selected trash folder thereby emptying it
| Request | Response | Error |
|---|---|---|
BulkRequest<FindByPath> |
BulkResponse<LongRunningTask> |
CommonErrorMessage |
This operation acts as a permanent delete for users. Users will NOT be able to restore the file later, if needed.
Not all providers supports this endpoint. You can query files.collections.browse
or files.collections.retrieve with the includeSupport flag.
This is a long running task. As a result, this operation might respond with a status code which indicate that it will continue in the background. Progress of this job can be followed using the task API.
Errors:
| Status Code | Description |
|---|---|
404 Not Found |
Either the oldPath or newPath exists or you lack permissions |
403 Forbidden |
You lack permissions to perform this operation |
400 Bad Request |
This operation is not supported by the provider |
Examples:
| Example |
|---|
| Moving files to trash |