Skip to content

Google: Lists a file's revisions For more information, see Manage file revisions (https: developers google com workspace drive api guides manage-revisions) **Important:** The list of revisions returned by this method might be incomplete for files with a large revision history, including frequently edited Google Docs, Sheets, and Slides Older revisions might be omitted from the response, meaning the first revision returned may not be the oldest existing revision The revision history visible in the Workspace editor user interface might be more complete than the list returned by the API — response body

Lists a file's revisions. For more information, see [Manage file revisions](https://developers.google.com/workspace/drive/api/guides/manage-revisions). **Important:** The list of revisions returned by this method might be incomplete for files with a large revision history, including frequently edited Google Docs, Sheets, and Slides. Older revisions might be omitted from the response, meaning the first revision returned may not be the oldest existing revision. The revision history visible in the Workspace editor user interface might be more complete than the list returned by the API.: response body. Complete fields and constraints for contract 2026-10-27.

API reference · Contract 2026-10-27

SDK schema: Lists a file's revisions For more information, see Manage file revisions (https: developers google com workspace drive api guides manage-revisions) **Important:** The list of revisions returned by this method might be incomplete for files with a large revision history, including frequently edited Google Docs, Sheets, and Slides Older revisions might be omitted from the response, meaning the first revision returned may not be the oldest existing revision The revision history visible in the Workspace editor user interface might be more complete than the list returned by the API — response body

FieldTypePresenceDescription and constraints
$objectRootA list of revisions of a file.
kindstringOptionalIdentifies what kind of resource this is. Value: the fixed string `“drive#revisionList”`.
Default: drive#revisionList
nextPageTokenstringOptionalThe page token for the next page of revisions. This will be absent if the end of the revisions list has been reached. If the token is rejected for any reason, it should be discarded, and pagination should be restarted from the first page of results. The page token is typically valid for several hours. However, if new items are added or removed, your expected results might differ.
revisionsarrayOptionalThe list of revisions. If nextPageToken is populated, then this list may be incomplete and an additional page of results should be fetched.
revisions[]ModelEach itemExpand Updates a revision with patch semantics For more information, see Manage file revisions (https: developers google com workspace drive api guides manage-revisions) — response body

Referenced models: Updates a revision with patch semantics For more information, see Manage file revisions (https: developers google com workspace drive api guides manage-revisions) — response body

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.