Method: revisions.delete
Permanently deletes a file version. You can only delete revisions for files with binary content, like images or videos. Revisions for other files, like Google Docs or Sheets, and the last remaining file version can't be deleted.
HTTP request
DELETE https://www.googleapis.com/drive/v2/files/{fileId}/revisions/{revisionId}
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters |
fileId |
string
The ID of the file.
|
revisionId |
string
The ID of the revision.
|
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.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-09-17 UTC.
[null,null,["Last updated 2024-09-17 UTC."],[[["Permanently deletes a specified version of a file, applicable only to files with binary content like images or videos."],["Utilizes an HTTP DELETE request to `https://www.googleapis.com/drive/v2/files/{fileId}/revisions/{revisionId}`, requiring file and revision IDs."],["Requires an empty request body and returns an empty response body upon successful deletion."],["Needs authorization with one of the specified OAuth scopes, some of which may require a security assessment."]]],["This document outlines the process for permanently deleting a file revision using a `DELETE` HTTP request to a specific URL. The URL requires `fileId` and `revisionId` path parameters. The request body must be empty. A successful request results in an empty response body. Only revisions for files with binary content can be deleted. The operation requires one of four specified OAuth authorization scopes for authentication.\n"]]
