Method: files.emptyTrash

Permanently deletes all of the user's trashed files.

HTTP request

DELETE https://www.googleapis.com/drive/v3/files/trash

The URL uses gRPC Transcoding syntax.

Query parameters

Parameters
enforceSingleParent
(deprecated)

boolean

Deprecated: If an item is not in a shared drive and its last parent is deleted but the item itself is not, the item will be placed under its owner's root.

driveId

string

If set, empties the trash of the provided shared drive.

Request body

The request body must be empty.

Response body

If successful, the response body is empty.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/drive

Some scopes are restricted and require a security assessment for your app to use them. For more information, see the Authorization guide.