---
title: "Changes to POST /v1/documents"
method: POST
path: "/v1/documents"
---

# Changes to POST /v1/documents

`POST /v1/documents`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 4 revisions.

- **2026-10-10** `fa5b0cc0317c`: 2 breaking, 4 info
- **2026-10-10** `0cd410015119`: 30 info

## Changes

- **2026-10-10** `fa5b0cc0317c`: 2 breaking, 4 info
  - removed the request body
  - removed the media type `*/*` for the response with the status `200`
  - the security scope `https://www.googleapis.com/auth/documents` was added to the endpoint's security scheme `Oauth2`
  - the security scope `https://www.googleapis.com/auth/documents` was added to the endpoint's security scheme `Oauth2c`
  - the security scope `https://www.googleapis.com/auth/drive.file` was removed from the endpoint's security scheme `Oauth2`
  - the security scope `https://www.googleapis.com/auth/drive.file` was removed from the endpoint's security scheme `Oauth2c`
- **2026-10-10** `0cd410015119`: 30 info
  - the security scope `https://www.googleapis.com/auth/documents` was added to the endpoint's security scheme `Oauth2`
  - the security scope `https://www.googleapis.com/auth/documents` was added to the endpoint's security scheme `Oauth2c`
  - the security scope `https://www.googleapis.com/auth/drive.file` was removed from the endpoint's security scheme `Oauth2`
  - the security scope `https://www.googleapis.com/auth/drive.file` was removed from the endpoint's security scheme `Oauth2c`
  - added the new optional request property `body/content/items/paragraph/elements/items/dropdown`
  - added the new optional request property `comments`
  - added the new optional request property `commentsViewMode`
  - added the new optional request property `footers/additionalProperties/content/items/paragraph/elements/items/dropdown`
  - added the new optional request property `footnotes/additionalProperties/content/items/paragraph/elements/items/dropdown`
  - added the new optional request property `headers/additionalProperties/content/items/paragraph/elements/items/dropdown`
  - added the new optional request property `suggestions`
  - added the new optional request property `tabs/items/documentTab/body/content/items/paragraph/elements/items/dropdown`
  - added the new optional request property `tabs/items/documentTab/commentAnchors`
  - added the new optional request property `tabs/items/documentTab/dropdownDefinitions`
  - added the new optional request property `tabs/items/documentTab/footers/additionalProperties/content/items/paragraph/elements/items/dropdown`
  - added the new optional request property `tabs/items/documentTab/footnotes/additionalProperties/content/items/paragraph/elements/items/dropdown`
  - added the new optional request property `tabs/items/documentTab/headers/additionalProperties/content/items/paragraph/elements/items/dropdown`
  - added the optional property `body/content/items/paragraph/elements/items/dropdown` to the response with the `200` status
  - added the optional property `comments` to the response with the `200` status
  - added the optional property `commentsViewMode` to the response with the `200` status
  - added the optional property `footers/additionalProperties/content/items/paragraph/elements/items/dropdown` to the response with the `200` status
  - added the optional property `footnotes/additionalProperties/content/items/paragraph/elements/items/dropdown` to the response with the `200` status
  - added the optional property `headers/additionalProperties/content/items/paragraph/elements/items/dropdown` to the response with the `200` status
  - added the optional property `suggestions` to the response with the `200` status
  - added the optional property `tabs/items/documentTab/body/content/items/paragraph/elements/items/dropdown` to the response with the `200` status
  - added the optional property `tabs/items/documentTab/commentAnchors` to the response with the `200` status
  - added the optional property `tabs/items/documentTab/dropdownDefinitions` to the response with the `200` status
  - added the optional property `tabs/items/documentTab/footers/additionalProperties/content/items/paragraph/elements/items/dropdown` to the response with the `200` status
  - added the optional property `tabs/items/documentTab/footnotes/additionalProperties/content/items/paragraph/elements/items/dropdown` to the response with the `200` status
  - added the optional property `tabs/items/documentTab/headers/additionalProperties/content/items/paragraph/elements/items/dropdown` to the response with the `200` status

---

[Operation](https://skmtc.dev/google/apis/google-docs-api/docs/v1/documents/post.md) - [API](https://skmtc.dev/google/apis/google-docs-api.md) - [Page](https://skmtc.dev/google/apis/google-docs-api/changes/v1/documents/post)