Method: files.delete

Permanently deletes a file by ID. Skips the trash. The currently authenticated user must own the file or be an organizer on the parent for shared drive files.

HTTP request

DELETE https://www.googleapis.com/drive/v2/files/{fileId}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
fileId

string

The ID of the file to delete.

Query parameters

Parameters
supportsAllDrives

boolean

Whether the requesting application supports both My Drives and shared drives.

supportsTeamDrives
(deprecated)

boolean

Deprecated: Use supportsAllDrives instead.

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 is placed under its owner's root.

Request body

The request body must be empty.

Response body

If successful, the response body is empty.

Authorization scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/docs
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.file

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