Revisions: update

Updates a revision with patch semantics. Try it now.

Request

HTTP request

PATCH https://www.googleapis.com/drive/v3/files/fileId/revisions/revisionId

Parameters

Parameter name Value Description
Path parameters
fileId string The ID of the file.
revisionId string The ID of the revision.
Optional query parameters
fields string The paths of the fields you want included in the response. If not specified, the response includes a default set of fields specific to this method. For development you can use the special value * to return all fields, but you'll achieve greater performance by only selecting the fields you need. For more information see the partial responses documentation.

Authorization

This request requires authorization with at least one of the following scopes:

Scope
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/drive.appdata

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

Request body

In the request body, supply the relevant portions of a Revisions resource, according to the rules of patch semantics, with the following properties:

Property name Value Description Notes
Optional Properties
keepForever boolean Whether to keep this revision forever, even if it is no longer the head revision. If not set, the revision will be automatically purged 30 days after newer content is uploaded. This can be set on a maximum of 200 revisions for a file.

This field is only applicable to files with binary content in Drive.

writable
publishAuto boolean Whether subsequent revisions will be automatically republished. This is only applicable to Google Docs. writable
published boolean Whether this revision is published. This is only applicable to Google Docs. writable
publishedOutsideDomain boolean Whether this revision is published outside the domain. This is only applicable to Google Docs. writable

Response

If successful, this method returns a Revisions resource in the response body.

Try it!

Use the APIs Explorer below to call this method on live data and see the response.

Send feedback about...

Google Drive API
Google Drive API
Need help? Visit our support page.