Revisions: update

Stay organized with collections Save and categorize content based on your preferences.

Updates a revision with patch semantics. Try it now.


HTTP request



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 Return specific fields for a file.


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


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.

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


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.