- HTTP request
- Path parameters
- Query parameters
- Request body
- Response body
- Authorization scopes
- Try it!
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.
HTTP request
POST https://www.googleapis.com/drive/v2/files/{fileId}/trash
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters | |
|---|---|
| fileId | 
 The ID of the file to trash. | 
Query parameters
| Parameters | |
|---|---|
| supportsAllDrives | 
 Whether the requesting application supports both My Drives and shared drives. | 
| supportsTeamDrives | 
 Deprecated: Use  | 
| includePermissionsForView | 
 Specifies which additional view's permissions to include in the response. Only  | 
| includeLabels | 
 A comma-separated list of IDs of labels to include in the  | 
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.