- HTTP request
- Path parameters
- Query parameters
- Request body
- Response body
- Authorization scopes
- Try it!
Permanently deletes a file owned by the user without moving it to the trash. For more information, see Trash or delete files and folders.
If the file belongs to a shared drive, the user must be an organizer on the parent folder. If the target is a folder, all descendants owned by the user are also deleted.
HTTP request
DELETE https://www.googleapis.com/drive/v3/files/{fileId}
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters | |
|---|---|
fileId |
The ID of the file. |
Query parameters
| Parameters | |
|---|---|
supportsAllDrives |
Whether the requesting application supports both My Drives and shared drives. |
supportsTeamDrives |
Deprecated: Use |
enforceSingleParent |
Deprecated: If an item isn't in a shared drive and its last parent is deleted but the item itself isn't, the item will be placed under its owner's root. |
Request body
The request body must be empty.
Response body
If successful, the response body is an empty JSON object.
Authorization scopes
Requires one of the following OAuth scopes:
https://www.googleapis.com/auth/drivehttps://www.googleapis.com/auth/drive.appdatahttps://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.