Method: files.trash

Moves a file to the trash. The currently authenticated user must own the file or be at least a fileOrganizer on the parent for shared drive files. Only the owner may trash a file. The trashed item is excluded from all files.list responses returned for any user who doesn't own the file. However, all users with access to the file can see the trashed item metadata in an API response. All users with access can copy, download, export, and share the file.

HTTP request

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

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
fileId

string

The ID of the file to trash.

Query parameters

Parameters
supportsAllDrives

boolean

Whether the requesting application supports both My Drives and shared drives.
supportsTeamDrives
(deprecated)

boolean

Deprecated: Use supportsAllDrives instead.
includePermissionsForView

string

Specifies which additional view's permissions to include in the response. Only published is supported.
includeLabels

string

A comma-separated list of IDs of labels to include in the labelInfo part of the response.

Request body

The request body must be empty.

Response body

If successful, the response body contains an instance of File.

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.apps.readonly
  • 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.