grr

Overview Schema Source Related Servers Discussions Admin

docs.documents.create

Creates a blank Google Docs document from the title supplied in the request and returns the new document as JSON. Use it to start a document; any content fields are ignored.

Instructions

Creates a blank document using the title given in the request. Other fields in the request, including any provided content, are ignored. Returns the created document [HTTP POST] — creates or triggers a change; refused under --readonly safety profiles. Returns the API's response resource as JSON — request body is a JSON Document object accepting body, comments, commentsViewMode, documentId, documentStyle, footers, footnotes, headers and 12 more fields; pass it via params or whole via body_file Siblings over the same resource: batchUpdate, get.

Input Schema

Name	Required	Description
`query`	No	Extra KEY=VALUE query pairs for endpoints whose parameters Discovery does not describe.
`params`	No	Parameter map merged into the request; typed parameters win.
`dry_run`	No	Return the request that would be sent, without sending it.
`body_file`	No	Read the request body from this file ('-' for stdin) instead of building one from the parameters. The body is a JSON Document object.
`request_body`	No	Request body of type Document: pass it via `params` (merged into the built body) or whole via `body_file`.

Output Schema

Name	Required	Description	Default
`body`	No
`tabs`	No
`lists`	No
`title`	No
`footers`	No
`headers`	No
`comments`	No
`footnotes`	No
`documentId`	No
`revisionId`	No
`namedRanges`	No
`namedStyles`	No
`suggestions`	No
`documentStyle`	No
`inlineObjects`	No
`commentsViewMode`	No
`positionedObjects`	No
`suggestionsViewMode`	No
`suggestedNamedStylesChanges`	No
`suggestedDocumentStyleChanges`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed2 schema fields changedOct 26, 2026

changedInput schema / properties / body_file / description

Previous value: -"Read the request body from this file ('-' for stdin) instead of building one from the parameters."New value: +"Read the request body from this file ('-' for stdin) instead of building one from the parameters. The body is a JSON Document object."

addedInput schema / properties / request_body

Added value: +{
+  "description": "Request body of type Document: pass it via `params` (merged into the built body) or whole via `body_file`.",
+  "properties": {
+    "body": {
+      "properties": {
+        "content": {
+          "items": {
+            "properties": {
+              "endIndex": {
+                "type": "integer"
+              },
+              "paragraph": {
+                "properties": {
+                  "bullet": {
+                    "type": "object"
+                  },
+                  "elements": {
+                    "items": {
+                      "type": "object"
+                    },
+                    "type": "array"
+                  },
+                  "paragraphStyle": {
+                    "type": "object"
+                  },
+                  "positionedObjectIds": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  "suggestedBulletChanges": {
+                    "type": "object"
+                  },
+                  "suggestedParagraphStyleChanges": {
+                    "type": "object"
+                  },
+                  "suggestedPositionedObjectIds": {
+                    "type": "object"
+                  }
+                },
+                "type": "object"
+              },
+              "sectionBreak": {
+                "properties": {
+                  "sectionStyle": {
+                    "type": "object"
+                  },
+                  "suggestedDeletionIds": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  "suggestedInsertionIds": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  }
+                },
+                "type": "object"
+              },
+              "startIndex": {
+                "type": "integer"
+              },
+              "table": {
+                "properties": {
+                  "columns": {
+                    "type": "integer"
+                  },
+                  "rows": {
+                    "type": "integer"
+                  },
+                  "suggestedDeletionIds": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  "suggestedInsertionIds": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  "tableRows": {
+                    "items": {
+                      "type": "object"
+                    },
+                    "type": "array"
+                  },
+                  "tableStyle": {
+                    "type": "object"
+                  }
+                },
+                "type": "object"
+              },
+              "tableOfContents": {
+                "properties": {
+                  "content": {
+                    "items": {
+                      "type": "object"
+                    },
+                    "type": "array"
+                  },
+                  "suggestedDeletionIds": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  "suggestedInsertionIds": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  }
+                },
+                "type": "object"
+              }
+            },
+            "type": "object"
+          },
+          "type": "array"
+        }
+      },
+      "type": "object"
+    },
+    "comments": {
+      "items": {
+        "properties": {
+          "anchorId": {
+            "type": "string"
+          },
+          "commentId": {
+            "type": "string"
+          },
+          "headPost": {
+            "properties": {
+              "assigneeEmail": {
+                "type": "string"
+              },
+              "author": {
+                "properties": {
+                  "anonymous": {
+                    "type": "boolean"
+                  },
+                  "displayName": {
+                    "type": "string"
+                  },
+                  "me": {
+                    "type": "boolean"
+                  },
+                  "user": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "commentAction": {
+                "enum": [
+                  "COMMENT_ACTION_TYPE_UNSPECIFIED",
+                  "NO_COMMENT_ACTION_CHANGE",
+                  "RESOLVE",
+                  "REOPEN"
+                ],
+                "type": "string"
+              },
+              "content": {
+                "type": "string"
+              },
+              "contentHtml": {
+                "type": "string"
+              },
+              "createTime": {
+                "type": "string"
+              },
+              "deleted": {
+                "type": "boolean"
+              },
+              "fromCopiedDocument": {
+                "type": "boolean"
+              },
+              "fromDocumentComparison": {
+                "type": "boolean"
+              },
+              "fromImportedDocument": {
+                "type": "boolean"
+              },
+              "postId": {
+                "type": "string"
+              },
+              "suggestionAction": {
+                "enum": [
+                  "SUGGESTION_ACTION_TYPE_UNSPECIFIED",
+                  "NO_SUGGESTION_ACTION_CHANGE",
+                  "ACCEPT",
+                  "REJECT"
+                ],
+                "type": "string"
+              },
+              "updateTime": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "plainTextQuote": {
+            "type": "string"
+          },
+          "replies": {
+            "items": {
+              "properties": {
+                "assigneeEmail": {
+                  "type": "string"
+                },
+                "author": {
+                  "properties": {
+                    "anonymous": {
+                      "type": "boolean"
+                    },
+                    "displayName": {
+                      "type": "string"
+                    },
+                    "me": {
+                      "type": "boolean"
+                    },
+                    "user": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "commentAction": {
+                  "enum": [
+                    "COMMENT_ACTION_TYPE_UNSPECIFIED",
+                    "NO_COMMENT_ACTION_CHANGE",
+                    "RESOLVE",
+                    "REOPEN"
+                  ],
+                  "type": "string"
+                },
+                "content": {
+                  "type": "string"
+                },
+                "contentHtml": {
+                  "type": "string"
+                },
+                "createTime": {
+                  "type": "string"
+                },
+                "deleted": {
+                  "type": "boolean"
+                },
+                "fromCopiedDocument": {
+                  "type": "boolean"
+                },
+                "fromDocumentComparison": {
+                  "type": "boolean"
+                },
+                "fromImportedDocument": {
+                  "type": "boolean"
+                },
+                "postId": {
+                  "type": "string"
+                },
+                "suggestionAction": {
+                  "enum": [
+                    "SUGGESTION_ACTION_TYPE_UNSPECIFIED",
+                    "NO_SUGGESTION_ACTION_CHANGE",
+                    "ACCEPT",
+                    "REJECT"
+                  ],
+                  "type": "string"
+                },
+                "updateTime": {
+                  "type": "string"
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "status": {
+            "enum": [
+              "STATUS_UNSPECIFIED",
+              "OPEN",
+              "RESOLVED"
+            ],
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "commentsViewMode": {
+      "enum": [
+        "COMMENTS_VIEW_MODE_UNSPECIFIED",
+        "COMMENTS_VIEW_MODE_DEFAULT_FOR_CURRENT_ACCESS",
+        "COMMENTS_VIEW_MODE_OMITTED",
+        "COMMENTS_VIEW_MODE_INCLUDED"
+      ],
+      "type": "string"
+    },
+    "documentId": {
+      "type": "string"
+    },
+    "documentStyle": {
+      "properties": {
+        "background": {
+          "properties": {
+            "color": {
+              "properties": {
+                "color": {
+                  "type": "object"
+                }
+              },
+              "type": "object"
+            }
+          },
+          "type": "object"
+        },
+        "defaultFooterId": {
+          "type": "string"
+        },
+        "defaultHeaderId": {
+          "type": "string"
+        },
+        "documentFormat": {
+          "properties": {
+            "documentMode": {
+              "enum": [
+                "DOCUMENT_MODE_UNSPECIFIED",
+                "PAGES",
+                "PAGELESS"
+              ],
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "evenPageFooterId": {
+          "type": "string"
+        },
+        "evenPageHeaderId": {
+          "type": "string"
+        },
+        "firstPageFooterId": {
+          "type": "string"
+        },
+        "firstPageHeaderId": {
+          "type": "string"
+        },
+        "flipPageOrientation": {
+          "type": "boolean"
+        },
+        "marginBottom": {
+          "properties": {
+            "magnitude": {
+              "type": "number"
+            },
+            "unit": {
+              "enum": [
+                "UNIT_UNSPECIFIED",
+                "PT"
+              ],
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "marginFooter": {
+          "properties": {
+            "magnitude": {
+              "type": "number"
+            },
+            "unit": {
+              "enum": [
+                "UNIT_UNSPECIFIED",
+                "PT"
+              ],
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "marginHeader": {
+          "properties": {
+            "magnitude": {
+              "type": "number"
+            },
+            "unit": {
+              "enum": [
+                "UNIT_UNSPECIFIED",
+                "PT"
+              ],
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "marginLeft": {
+          "properties": {
+            "magnitude": {
+              "type": "number"
+            },
+            "unit": {
+              "enum": [
+                "UNIT_UNSPECIFIED",
+                "PT"
+              ],
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "marginRight": {
+          "properties": {
+            "magnitude": {
+              "type": "number"
+            },
+            "unit": {
+              "enum": [
+                "UNIT_UNSPECIFIED",
+                "PT"
+              ],
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "marginTop": {
+          "properties": {
+            "magnitude": {
+              "type": "number"
+            },
+            "unit": {
+              "enum": [
+                "UNIT_UNSPECIFIED",
+                "PT"
+              ],
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "pageNumberStart": {
+          "type": "integer"
+        },
+        "pageSize": {
+          "properties": {
+            "height": {
+              "properties": {
+                "magnitude": {
+                  "type": "number"
+                },
+                "unit": {
+                  "enum": [
+                    "UNIT_UNSPECIFIED",
+                    "PT"
+                  ],
+                  "type": "string"
+                }
+              },
+              "type": "object"
+            },
+            "width": {
+              "properties": {
+                "magnitude": {
+                  "type": "number"
+                },
+                "unit": {
+                  "enum": [
+                    "UNIT_UNSPECIFIED",
+                    "PT"
+                  ],
+                  "type": "string"
+                }
+              },
+              "type": "object"
+            }
+          },
+          "type": "object"
+        },
+        "useCustomHeaderFooterMargins": {
+          "type": "boolean"
+        },
+        "useEvenPageHeaderFooter": {
+          "type": "boolean"
+        },
+        "useFirstPageHeaderFooter": {
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "footers": {
+      "type": "object"
+    },
+    "footnotes": {
+      "type": "object"
+    },
+    "headers": {
+      "type": "object"
+    },
+    "inlineObjects": {
+      "type": "object"
+    },
+    "lists": {
+      "type": "object"
+    },
+    "namedRanges": {
+      "type": "object"
+    },
+    "namedStyles": {
+      "properties": {
+        "styles": {
+          "items": {
+            "properties": {
+              "namedStyleType": {
+                "enum": [
+                  "NAMED_STYLE_TYPE_UNSPECIFIED",
+                  "NORMAL_TEXT",
+                  "TITLE",
+                  "SUBTITLE",
+                  "HEADING_1",
+                  "HEADING_2",
+                  "HEADING_3",
+                  "HEADING_4",
+                  "HEADING_5",
+                  "HEADING_6"
+                ],
+                "type": "string"
+              },
+              "paragraphStyle": {
+                "properties": {
+                  "alignment": {
+                    "enum": [
+                      "ALIGNMENT_UNSPECIFIED",
+                      "START",
+                      "CENTER",
+                      "END",
+                      "JUSTIFIED"
+                    ],
+                    "type": "string"
+                  },
+                  "avoidWidowAndOrphan": {
+                    "type": "boolean"
+                  },
+                  "borderBetween": {
+                    "type": "object"
+                  },
+                  "borderBottom": {
+                    "type": "object"
+                  },
+                  "borderLeft": {
+                    "type": "object"
+                  },
+                  "borderRight": {
+                    "type": "object"
+                  },
+                  "borderTop": {
+                    "type": "object"
+                  },
+                  "direction": {
+                    "enum": [
+                      "CONTENT_DIRECTION_UNSPECIFIED",
+                      "LEFT_TO_RIGHT",
+                      "RIGHT_TO_LEFT"
+                    ],
+                    "type": "string"
+                  },
+                  "headingId": {
+                    "type": "string"
+                  },
+                  "indentEnd": {
+                    "type": "object"
+                  },
+                  "indentFirstLine": {
+                    "type": "object"
+                  },
+                  "indentStart": {
+                    "type": "object"
+                  },
+                  "keepLinesTogether": {
+                    "type": "boolean"
+                  },
+                  "keepWithNext": {
+                    "type": "boolean"
+                  },
+                  "lineSpacing": {
+                    "type": "number"
+                  },
+                  "namedStyleType": {
+                    "enum": [
+                      "NAMED_STYLE_TYPE_UNSPECIFIED",
+                      "NORMAL_TEXT",
+                      "TITLE",
+                      "SUBTITLE",
+                      "HEADING_1",
+                      "HEADING_2",
+                      "HEADING_3",
+                      "HEADING_4",
+                      "HEADING_5",
+                      "HEADING_6"
+                    ],
+                    "type": "string"
+                  },
+                  "pageBreakBefore": {
+                    "type": "boolean"
+                  },
+                  "shading": {
+                    "type": "object"
+                  },
+                  "spaceAbove": {
+                    "type": "object"
+                  },
+                  "spaceBelow": {
+                    "type": "object"
+                  },
+                  "spacingMode": {
+                    "enum": [
+                      "SPACING_MODE_UNSPECIFIED",
+                      "NEVER_COLLAPSE",
+                      "COLLAPSE_LISTS"
+                    ],
+                    "type": "string"
+                  },
+                  "tabStops": {
+                    "items": {
+                      "type": "object"
+                    },
+                    "type": "array"
+                  }
+                },
+                "type": "object"
+              },
+              "textStyle": {
+                "properties": {
+                  "backgroundColor": {
+                    "type": "object"
+                  },
+                  "baselineOffset": {
+                    "enum": [
+                      "BASELINE_OFFSET_UNSPECIFIED",
+                      "NONE",
+                      "SUPERSCRIPT",
+                      "SUBSCRIPT"
+                    ],
+                    "type": "string"
+                  },
+                  "bold": {
+                    "type": "boolean"
+                  },
+                  "fontSize": {
+                    "type": "object"
+                  },
+                  "foregroundColor": {
+                    "type": "object"
+                  },
+                  "italic": {
+                    "type": "boolean"
+                  },
+                  "link": {
+                    "type": "object"
+                  },
+                  "smallCaps": {
+                    "type": "boolean"
+                  },
+                  "strikethrough": {
+                    "type": "boolean"
+                  },
+                  "underline": {
+                    "type": "boolean"
+                  },
+                  "weightedFontFamily": {
+                    "type": "object"
+                  }
+                },
+                "type": "object"
+              }
+            },
+            "type": "object"
+          },
+          "type": "array"
+        }
+      },
+      "type": "object"
+    },
+    "positionedObjects": {
+      "type": "object"
+    },
+    "revisionId": {
+      "type": "string"
+    },
+    "suggestedDocumentStyleChanges": {
+      "type": "object"
+    },
+    "suggestedNamedStylesChanges": {
+      "type": "object"
+    },
+    "suggestions": {
+      "items": {
+        "properties": {
+          "headPost": {
+            "properties": {
+              "assigneeEmail": {
+                "type": "string"
+              },
+              "author": {
+                "properties": {
+                  "anonymous": {
+                    "type": "boolean"
+                  },
+                  "displayName": {
+                    "type": "string"
+                  },
+                  "me": {
+                    "type": "boolean"
+                  },
+                  "user": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "commentAction": {
+                "enum": [
+                  "COMMENT_ACTION_TYPE_UNSPECIFIED",
+                  "NO_COMMENT_ACTION_CHANGE",
+                  "RESOLVE",
+                  "REOPEN"
+                ],
+                "type": "string"
+              },
+              "content": {
+                "type": "string"
+              },
+              "contentHtml": {
+                "type": "string"
+              },
+              "createTime": {
+                "type": "string"
+              },
+              "deleted": {
+                "type": "boolean"
+              },
+              "fromCopiedDocument": {
+                "type": "boolean"
+              },
+              "fromDocumentComparison": {
+                "type": "boolean"
+              },
+              "fromImportedDocument": {
+                "type": "boolean"
+              },
+              "postId": {
+                "type": "string"
+              },
+              "suggestionAction": {
+                "enum": [
+                  "SUGGESTION_ACTION_TYPE_UNSPECIFIED",
+                  "NO_SUGGESTION_ACTION_CHANGE",
+                  "ACCEPT",
+                  "REJECT"
+                ],
+                "type": "string"
+              },
+              "updateTime": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "replies": {
+            "items": {
+              "properties": {
+                "assigneeEmail": {
+                  "type": "string"
+                },
+                "author": {
+                  "properties": {
+                    "anonymous": {
+                      "type": "boolean"
+                    },
+                    "displayName": {
+                      "type": "string"
+                    },
+                    "me": {
+                      "type": "boolean"
+                    },
+                    "user": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "commentAction": {
+                  "enum": [
+                    "COMMENT_ACTION_TYPE_UNSPECIFIED",
+                    "NO_COMMENT_ACTION_CHANGE",
+                    "RESOLVE",
+                    "REOPEN"
+                  ],
+                  "type": "string"
+                },
+                "content": {
+                  "type": "string"
+                },
+                "contentHtml": {
+                  "type": "string"
+                },
+                "createTime": {
+                  "type": "string"
+                },
+                "deleted": {
+                  "type": "boolean"
+                },
+                "fromCopiedDocument": {
+                  "type": "boolean"
+                },
+                "fromDocumentComparison": {
+                  "type": "boolean"
+                },
+                "fromImportedDocument": {
+                  "type": "boolean"
+                },
+                "postId": {
+                  "type": "string"
+                },
+                "suggestionAction": {
+                  "enum": [
+                    "SUGGESTION_ACTION_TYPE_UNSPECIFIED",
+                    "NO_SUGGESTION_ACTION_CHANGE",
+                    "ACCEPT",
+                    "REJECT"
+                  ],
+                  "type": "string"
+                },
+                "updateTime": {
+                  "type": "string"
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "status": {
+            "enum": [
+              "STATUS_UNSPECIFIED",
+              "OPEN",
+              "ACCEPTED",
+              "REJECTED"
+            ],
+            "type": "string"
+          },
+          "suggestionId": {
+            "type": "string"
+          },
+          "summaryHtml": {
+            "type": "string"
+          },
+          "summaryText": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "suggestionsViewMode": {
+      "enum": [
+        "DEFAULT_FOR_CURRENT_ACCESS",
+        "SUGGESTIONS_INLINE",
+        "PREVIEW_SUGGESTIONS_ACCEPTED",
+        "PREVIEW_WITHOUT_SUGGESTIONS"
+      ],
+      "type": "string"
+    },
+    "tabs": {
+      "items": {
+        "properties": {
+          "childTabs": {
+            "items": {
+              "properties": {
+                "childTabs": {
+                  "items": {
+                    "properties": {
+                      "childTabs": {
+                        "items": {
+                          "type": "object"
+                        },
+                        "type": "array"
+                      },
+                      "documentTab": {
+                        "type": "object"
+                      },
+                      "tabProperties": {
+                        "type": "object"
+                      }
+                    },
+                    "type": "object"
+                  },
+                  "type": "array"
+                },
+                "documentTab": {
+                  "properties": {
+                    "body": {
+                      "type": "object"
+                    },
+                    "commentAnchors": {
+                      "type": "object"
+                    },
+                    "documentStyle": {
+                      "type": "object"
+                    },
+                    "dropdownDefinitions": {
+                      "type": "object"
+                    },
+                    "footers": {
+                      "type": "object"
+                    },
+                    "footnotes": {
+                      "type": "object"
+                    },
+                    "headers": {
+                      "type": "object"
+                    },
+                    "inlineObjects": {
+                      "type": "object"
+                    },
+                    "lists": {
+                      "type": "object"
+                    },
+                    "namedRanges": {
+                      "type": "object"
+                    },
+                    "namedStyles": {
+                      "type": "object"
+                    },
+                    "positionedObjects": {
+                      "type": "object"
+                    },
+                    "suggestedDocumentStyleChanges": {
+                      "type": "object"
+                    },
+                    "suggestedNamedStylesChanges": {
+                      "type": "object"
+                    }
+                  },
+                  "type": "object"
+                },
+                "tabProperties": {
+                  "properties": {
+                    "iconEmoji": {
+                      "type": "string"
+                    },
+                    "index": {
+                      "type": "integer"
+                    },
+                    "nestingLevel": {
+                      "type": "integer"
+                    },
+                    "parentTabId": {
+                      "type": "string"
+                    },
+                    "tabId": {
+                      "type": "string"
+                    },
+                    "title": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "documentTab": {
+            "properties": {
+              "body": {
+                "properties": {
+                  "content": {
+                    "items": {
+                      "type": "object"
+                    },
+                    "type": "array"
+                  }
+                },
+                "type": "object"
+              },
+              "commentAnchors": {
+                "type": "object"
+              },
+              "documentStyle": {
+                "properties": {
+                  "background": {
+                    "type": "object"
+                  },
+                  "defaultFooterId": {
+                    "type": "string"
+                  },
+                  "defaultHeaderId": {
+                    "type": "string"
+                  },
+                  "documentFormat": {
+                    "type": "object"
+                  },
+                  "evenPageFooterId": {
+                    "type": "string"
+                  },
+                  "evenPageHeaderId": {
+                    "type": "string"
+                  },
+                  "firstPageFooterId": {
+                    "type": "string"
+                  },
+                  "firstPageHeaderId": {
+                    "type": "string"
+                  },
+                  "flipPageOrientation": {
+                    "type": "boolean"
+                  },
+                  "marginBottom": {
+                    "type": "object"
+                  },
+                  "marginFooter": {
+                    "type": "object"
+                  },
+                  "marginHeader": {
+                    "type": "object"
+                  },
+                  "marginLeft": {
+                    "type": "object"
+                  },
+                  "marginRight": {
+                    "type": "object"
+                  },
+                  "marginTop": {
+                    "type": "object"
+                  },
+                  "pageNumberStart": {
+                    "type": "integer"
+                  },
+                  "pageSize": {
+                    "type": "object"
+                  },
+                  "useCustomHeaderFooterMargins": {
+                    "type": "boolean"
+                  },
+                  "useEvenPageHeaderFooter": {
+                    "type": "boolean"
+                  },
+                  "useFirstPageHeaderFooter": {
+                    "type": "boolean"
+                  }
+                },
+                "type": "object"
+              },
+              "dropdownDefinitions": {
+                "type": "object"
+              },
+              "footers": {
+                "type": "object"
+              },
+              "footnotes": {
+                "type": "object"
+              },
+              "headers": {
+                "type": "object"
+              },
+              "inlineObjects": {
+                "type": "object"
+              },
+              "lists": {
+                "type": "object"
+              },
+              "namedRanges": {
+                "type": "object"
+              },
+              "namedStyles": {
+                "properties": {
+                  "styles": {
+                    "items": {
+                      "type": "object"
+                    },
+                    "type": "array"
+                  }
+                },
+                "type": "object"
+              },
+              "positionedObjects": {
+                "type": "object"
+              },
+              "suggestedDocumentStyleChanges": {
+                "type": "object"
+              },
+              "suggestedNamedStylesChanges": {
+                "type": "object"
+              }
+            },
+            "type": "object"
+          },
+          "tabProperties": {
+            "properties": {
+              "iconEmoji": {
+                "type": "string"
+              },
+              "index": {
+                "type": "integer"
+              },
+              "nestingLevel": {
+                "type": "integer"
+              },
+              "parentTabId": {
+                "type": "string"
+              },
+              "tabId": {
+                "type": "string"
+              },
+              "title": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "title": {
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

Changed1 schema field changedOct 26, 2026

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "properties": {
+    "body": {
+      "properties": {
+        "content": {
+          "items": {
+            "properties": {
+              "endIndex": {
+                "type": "integer"
+              },
+              "paragraph": {
+                "properties": {
+                  "bullet": {
+                    "type": "object"
+                  },
+                  "elements": {
+                    "items": {
+                      "type": "object"
+                    },
+                    "type": "array"
+                  },
+                  "paragraphStyle": {
+                    "type": "object"
+                  },
+                  "positionedObjectIds": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  "suggestedBulletChanges": {
+                    "type": "object"
+                  },
+                  "suggestedParagraphStyleChanges": {
+                    "type": "object"
+                  },
+                  "suggestedPositionedObjectIds": {
+                    "type": "object"
+                  }
+                },
+                "type": "object"
+              },
+              "sectionBreak": {
+                "properties": {
+                  "sectionStyle": {
+                    "type": "object"
+                  },
+                  "suggestedDeletionIds": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  "suggestedInsertionIds": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  }
+                },
+                "type": "object"
+              },
+              "startIndex": {
+                "type": "integer"
+              },
+              "table": {
+                "properties": {
+                  "columns": {
+                    "type": "integer"
+                  },
+                  "rows": {
+                    "type": "integer"
+                  },
+                  "suggestedDeletionIds": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  "suggestedInsertionIds": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  "tableRows": {
+                    "items": {
+                      "type": "object"
+                    },
+                    "type": "array"
+                  },
+                  "tableStyle": {
+                    "type": "object"
+                  }
+                },
+                "type": "object"
+              },
+              "tableOfContents": {
+                "properties": {
+                  "content": {
+                    "items": {
+                      "type": "object"
+                    },
+                    "type": "array"
+                  },
+                  "suggestedDeletionIds": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  "suggestedInsertionIds": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  }
+                },
+                "type": "object"
+              }
+            },
+            "type": "object"
+          },
+          "type": "array"
+        }
+      },
+      "type": "object"
+    },
+    "comments": {
+      "items": {
+        "properties": {
+          "anchorId": {
+            "type": "string"
+          },
+          "commentId": {
+            "type": "string"
+          },
+          "headPost": {
+            "properties": {
+              "assigneeEmail": {
+                "type": "string"
+              },
+              "author": {
+                "properties": {
+                  "anonymous": {
+                    "type": "boolean"
+                  },
+                  "displayName": {
+                    "type": "string"
+                  },
+                  "me": {
+                    "type": "boolean"
+                  },
+                  "user": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "commentAction": {
+                "enum": [
+                  "COMMENT_ACTION_TYPE_UNSPECIFIED",
+                  "NO_COMMENT_ACTION_CHANGE",
+                  "RESOLVE",
+                  "REOPEN"
+                ],
+                "type": "string"
+              },
+              "content": {
+                "type": "string"
+              },
+              "contentHtml": {
+                "type": "string"
+              },
+              "createTime": {
+                "type": "string"
+              },
+              "deleted": {
+                "type": "boolean"
+              },
+              "fromCopiedDocument": {
+                "type": "boolean"
+              },
+              "fromDocumentComparison": {
+                "type": "boolean"
+              },
+              "fromImportedDocument": {
+                "type": "boolean"
+              },
+              "postId": {
+                "type": "string"
+              },
+              "suggestionAction": {
+                "enum": [
+                  "SUGGESTION_ACTION_TYPE_UNSPECIFIED",
+                  "NO_SUGGESTION_ACTION_CHANGE",
+                  "ACCEPT",
+                  "REJECT"
+                ],
+                "type": "string"
+              },
+              "updateTime": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "plainTextQuote": {
+            "type": "string"
+          },
+          "replies": {
+            "items": {
+              "properties": {
+                "assigneeEmail": {
+                  "type": "string"
+                },
+                "author": {
+                  "properties": {
+                    "anonymous": {
+                      "type": "boolean"
+                    },
+                    "displayName": {
+                      "type": "string"
+                    },
+                    "me": {
+                      "type": "boolean"
+                    },
+                    "user": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "commentAction": {
+                  "enum": [
+                    "COMMENT_ACTION_TYPE_UNSPECIFIED",
+                    "NO_COMMENT_ACTION_CHANGE",
+                    "RESOLVE",
+                    "REOPEN"
+                  ],
+                  "type": "string"
+                },
+                "content": {
+                  "type": "string"
+                },
+                "contentHtml": {
+                  "type": "string"
+                },
+                "createTime": {
+                  "type": "string"
+                },
+                "deleted": {
+                  "type": "boolean"
+                },
+                "fromCopiedDocument": {
+                  "type": "boolean"
+                },
+                "fromDocumentComparison": {
+                  "type": "boolean"
+                },
+                "fromImportedDocument": {
+                  "type": "boolean"
+                },
+                "postId": {
+                  "type": "string"
+                },
+                "suggestionAction": {
+                  "enum": [
+                    "SUGGESTION_ACTION_TYPE_UNSPECIFIED",
+                    "NO_SUGGESTION_ACTION_CHANGE",
+                    "ACCEPT",
+                    "REJECT"
+                  ],
+                  "type": "string"
+                },
+                "updateTime": {
+                  "type": "string"
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "status": {
+            "enum": [
+              "STATUS_UNSPECIFIED",
+              "OPEN",
+              "RESOLVED"
+            ],
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "commentsViewMode": {
+      "enum": [
+        "COMMENTS_VIEW_MODE_UNSPECIFIED",
+        "COMMENTS_VIEW_MODE_DEFAULT_FOR_CURRENT_ACCESS",
+        "COMMENTS_VIEW_MODE_OMITTED",
+        "COMMENTS_VIEW_MODE_INCLUDED"
+      ],
+      "type": "string"
+    },
+    "documentId": {
+      "type": "string"
+    },
+    "documentStyle": {
+      "properties": {
+        "background": {
+          "properties": {
+            "color": {
+              "properties": {
+                "color": {
+                  "type": "object"
+                }
+              },
+              "type": "object"
+            }
+          },
+          "type": "object"
+        },
+        "defaultFooterId": {
+          "type": "string"
+        },
+        "defaultHeaderId": {
+          "type": "string"
+        },
+        "documentFormat": {
+          "properties": {
+            "documentMode": {
+              "enum": [
+                "DOCUMENT_MODE_UNSPECIFIED",
+                "PAGES",
+                "PAGELESS"
+              ],
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "evenPageFooterId": {
+          "type": "string"
+        },
+        "evenPageHeaderId": {
+          "type": "string"
+        },
+        "firstPageFooterId": {
+          "type": "string"
+        },
+        "firstPageHeaderId": {
+          "type": "string"
+        },
+        "flipPageOrientation": {
+          "type": "boolean"
+        },
+        "marginBottom": {
+          "properties": {
+            "magnitude": {
+              "type": "number"
+            },
+            "unit": {
+              "enum": [
+                "UNIT_UNSPECIFIED",
+                "PT"
+              ],
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "marginFooter": {
+          "properties": {
+            "magnitude": {
+              "type": "number"
+            },
+            "unit": {
+              "enum": [
+                "UNIT_UNSPECIFIED",
+                "PT"
+              ],
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "marginHeader": {
+          "properties": {
+            "magnitude": {
+              "type": "number"
+            },
+            "unit": {
+              "enum": [
+                "UNIT_UNSPECIFIED",
+                "PT"
+              ],
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "marginLeft": {
+          "properties": {
+            "magnitude": {
+              "type": "number"
+            },
+            "unit": {
+              "enum": [
+                "UNIT_UNSPECIFIED",
+                "PT"
+              ],
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "marginRight": {
+          "properties": {
+            "magnitude": {
+              "type": "number"
+            },
+            "unit": {
+              "enum": [
+                "UNIT_UNSPECIFIED",
+                "PT"
+              ],
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "marginTop": {
+          "properties": {
+            "magnitude": {
+              "type": "number"
+            },
+            "unit": {
+              "enum": [
+                "UNIT_UNSPECIFIED",
+                "PT"
+              ],
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "pageNumberStart": {
+          "type": "integer"
+        },
+        "pageSize": {
+          "properties": {
+            "height": {
+              "properties": {
+                "magnitude": {
+                  "type": "number"
+                },
+                "unit": {
+                  "enum": [
+                    "UNIT_UNSPECIFIED",
+                    "PT"
+                  ],
+                  "type": "string"
+                }
+              },
+              "type": "object"
+            },
+            "width": {
+              "properties": {
+                "magnitude": {
+                  "type": "number"
+                },
+                "unit": {
+                  "enum": [
+                    "UNIT_UNSPECIFIED",
+                    "PT"
+                  ],
+                  "type": "string"
+                }
+              },
+              "type": "object"
+            }
+          },
+          "type": "object"
+        },
+        "useCustomHeaderFooterMargins": {
+          "type": "boolean"
+        },
+        "useEvenPageHeaderFooter": {
+          "type": "boolean"
+        },
+        "useFirstPageHeaderFooter": {
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "footers": {
+      "type": "object"
+    },
+    "footnotes": {
+      "type": "object"
+    },
+    "headers": {
+      "type": "object"
+    },
+    "inlineObjects": {
+      "type": "object"
+    },
+    "lists": {
+      "type": "object"
+    },
+    "namedRanges": {
+      "type": "object"
+    },
+    "namedStyles": {
+      "properties": {
+        "styles": {
+          "items": {
+            "properties": {
+              "namedStyleType": {
+                "enum": [
+                  "NAMED_STYLE_TYPE_UNSPECIFIED",
+                  "NORMAL_TEXT",
+                  "TITLE",
+                  "SUBTITLE",
+                  "HEADING_1",
+                  "HEADING_2",
+                  "HEADING_3",
+                  "HEADING_4",
+                  "HEADING_5",
+                  "HEADING_6"
+                ],
+                "type": "string"
+              },
+              "paragraphStyle": {
+                "properties": {
+                  "alignment": {
+                    "enum": [
+                      "ALIGNMENT_UNSPECIFIED",
+                      "START",
+                      "CENTER",
+                      "END",
+                      "JUSTIFIED"
+                    ],
+                    "type": "string"
+                  },
+                  "avoidWidowAndOrphan": {
+                    "type": "boolean"
+                  },
+                  "borderBetween": {
+                    "type": "object"
+                  },
+                  "borderBottom": {
+                    "type": "object"
+                  },
+                  "borderLeft": {
+                    "type": "object"
+                  },
+                  "borderRight": {
+                    "type": "object"
+                  },
+                  "borderTop": {
+                    "type": "object"
+                  },
+                  "direction": {
+                    "enum": [
+                      "CONTENT_DIRECTION_UNSPECIFIED",
+                      "LEFT_TO_RIGHT",
+                      "RIGHT_TO_LEFT"
+                    ],
+                    "type": "string"
+                  },
+                  "headingId": {
+                    "type": "string"
+                  },
+                  "indentEnd": {
+                    "type": "object"
+                  },
+                  "indentFirstLine": {
+                    "type": "object"
+                  },
+                  "indentStart": {
+                    "type": "object"
+                  },
+                  "keepLinesTogether": {
+                    "type": "boolean"
+                  },
+                  "keepWithNext": {
+                    "type": "boolean"
+                  },
+                  "lineSpacing": {
+                    "type": "number"
+                  },
+                  "namedStyleType": {
+                    "enum": [
+                      "NAMED_STYLE_TYPE_UNSPECIFIED",
+                      "NORMAL_TEXT",
+                      "TITLE",
+                      "SUBTITLE",
+                      "HEADING_1",
+                      "HEADING_2",
+                      "HEADING_3",
+                      "HEADING_4",
+                      "HEADING_5",
+                      "HEADING_6"
+                    ],
+                    "type": "string"
+                  },
+                  "pageBreakBefore": {
+                    "type": "boolean"
+                  },
+                  "shading": {
+                    "type": "object"
+                  },
+                  "spaceAbove": {
+                    "type": "object"
+                  },
+                  "spaceBelow": {
+                    "type": "object"
+                  },
+                  "spacingMode": {
+                    "enum": [
+                      "SPACING_MODE_UNSPECIFIED",
+                      "NEVER_COLLAPSE",
+                      "COLLAPSE_LISTS"
+                    ],
+                    "type": "string"
+                  },
+                  "tabStops": {
+                    "items": {
+                      "type": "object"
+                    },
+                    "type": "array"
+                  }
+                },
+                "type": "object"
+              },
+              "textStyle": {
+                "properties": {
+                  "backgroundColor": {
+                    "type": "object"
+                  },
+                  "baselineOffset": {
+                    "enum": [
+                      "BASELINE_OFFSET_UNSPECIFIED",
+                      "NONE",
+                      "SUPERSCRIPT",
+                      "SUBSCRIPT"
+                    ],
+                    "type": "string"
+                  },
+                  "bold": {
+                    "type": "boolean"
+                  },
+                  "fontSize": {
+                    "type": "object"
+                  },
+                  "foregroundColor": {
+                    "type": "object"
+                  },
+                  "italic": {
+                    "type": "boolean"
+                  },
+                  "link": {
+                    "type": "object"
+                  },
+                  "smallCaps": {
+                    "type": "boolean"
+                  },
+                  "strikethrough": {
+                    "type": "boolean"
+                  },
+                  "underline": {
+                    "type": "boolean"
+                  },
+                  "weightedFontFamily": {
+                    "type": "object"
+                  }
+                },
+                "type": "object"
+              }
+            },
+            "type": "object"
+          },
+          "type": "array"
+        }
+      },
+      "type": "object"
+    },
+    "positionedObjects": {
+      "type": "object"
+    },
+    "revisionId": {
+      "type": "string"
+    },
+    "suggestedDocumentStyleChanges": {
+      "type": "object"
+    },
+    "suggestedNamedStylesChanges": {
+      "type": "object"
+    },
+    "suggestions": {
+      "items": {
+        "properties": {
+          "headPost": {
+            "properties": {
+              "assigneeEmail": {
+                "type": "string"
+              },
+              "author": {
+                "properties": {
+                  "anonymous": {
+                    "type": "boolean"
+                  },
+                  "displayName": {
+                    "type": "string"
+                  },
+                  "me": {
+                    "type": "boolean"
+                  },
+                  "user": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "commentAction": {
+                "enum": [
+                  "COMMENT_ACTION_TYPE_UNSPECIFIED",
+                  "NO_COMMENT_ACTION_CHANGE",
+                  "RESOLVE",
+                  "REOPEN"
+                ],
+                "type": "string"
+              },
+              "content": {
+                "type": "string"
+              },
+              "contentHtml": {
+                "type": "string"
+              },
+              "createTime": {
+                "type": "string"
+              },
+              "deleted": {
+                "type": "boolean"
+              },
+              "fromCopiedDocument": {
+                "type": "boolean"
+              },
+              "fromDocumentComparison": {
+                "type": "boolean"
+              },
+              "fromImportedDocument": {
+                "type": "boolean"
+              },
+              "postId": {
+                "type": "string"
+              },
+              "suggestionAction": {
+                "enum": [
+                  "SUGGESTION_ACTION_TYPE_UNSPECIFIED",
+                  "NO_SUGGESTION_ACTION_CHANGE",
+                  "ACCEPT",
+                  "REJECT"
+                ],
+                "type": "string"
+              },
+              "updateTime": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "replies": {
+            "items": {
+              "properties": {
+                "assigneeEmail": {
+                  "type": "string"
+                },
+                "author": {
+                  "properties": {
+                    "anonymous": {
+                      "type": "boolean"
+                    },
+                    "displayName": {
+                      "type": "string"
+                    },
+                    "me": {
+                      "type": "boolean"
+                    },
+                    "user": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "commentAction": {
+                  "enum": [
+                    "COMMENT_ACTION_TYPE_UNSPECIFIED",
+                    "NO_COMMENT_ACTION_CHANGE",
+                    "RESOLVE",
+                    "REOPEN"
+                  ],
+                  "type": "string"
+                },
+                "content": {
+                  "type": "string"
+                },
+                "contentHtml": {
+                  "type": "string"
+                },
+                "createTime": {
+                  "type": "string"
+                },
+                "deleted": {
+                  "type": "boolean"
+                },
+                "fromCopiedDocument": {
+                  "type": "boolean"
+                },
+                "fromDocumentComparison": {
+                  "type": "boolean"
+                },
+                "fromImportedDocument": {
+                  "type": "boolean"
+                },
+                "postId": {
+                  "type": "string"
+                },
+                "suggestionAction": {
+                  "enum": [
+                    "SUGGESTION_ACTION_TYPE_UNSPECIFIED",
+                    "NO_SUGGESTION_ACTION_CHANGE",
+                    "ACCEPT",
+                    "REJECT"
+                  ],
+                  "type": "string"
+                },
+                "updateTime": {
+                  "type": "string"
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "status": {
+            "enum": [
+              "STATUS_UNSPECIFIED",
+              "OPEN",
+              "ACCEPTED",
+              "REJECTED"
+            ],
+            "type": "string"
+          },
+          "suggestionId": {
+            "type": "string"
+          },
+          "summaryHtml": {
+            "type": "string"
+          },
+          "summaryText": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "suggestionsViewMode": {
+      "enum": [
+        "DEFAULT_FOR_CURRENT_ACCESS",
+        "SUGGESTIONS_INLINE",
+        "PREVIEW_SUGGESTIONS_ACCEPTED",
+        "PREVIEW_WITHOUT_SUGGESTIONS"
+      ],
+      "type": "string"
+    },
+    "tabs": {
+      "items": {
+        "properties": {
+          "childTabs": {
+            "items": {
+              "properties": {
+                "childTabs": {
+                  "items": {
+                    "properties": {
+                      "childTabs": {
+                        "items": {
+                          "type": "object"
+                        },
+                        "type": "array"
+                      },
+                      "documentTab": {
+                        "type": "object"
+                      },
+                      "tabProperties": {
+                        "type": "object"
+                      }
+                    },
+                    "type": "object"
+                  },
+                  "type": "array"
+                },
+                "documentTab": {
+                  "properties": {
+                    "body": {
+                      "type": "object"
+                    },
+                    "commentAnchors": {
+                      "type": "object"
+                    },
+                    "documentStyle": {
+                      "type": "object"
+                    },
+                    "dropdownDefinitions": {
+                      "type": "object"
+                    },
+                    "footers": {
+                      "type": "object"
+                    },
+                    "footnotes": {
+                      "type": "object"
+                    },
+                    "headers": {
+                      "type": "object"
+                    },
+                    "inlineObjects": {
+                      "type": "object"
+                    },
+                    "lists": {
+                      "type": "object"
+                    },
+                    "namedRanges": {
+                      "type": "object"
+                    },
+                    "namedStyles": {
+                      "type": "object"
+                    },
+                    "positionedObjects": {
+                      "type": "object"
+                    },
+                    "suggestedDocumentStyleChanges": {
+                      "type": "object"
+                    },
+                    "suggestedNamedStylesChanges": {
+                      "type": "object"
+                    }
+                  },
+                  "type": "object"
+                },
+                "tabProperties": {
+                  "properties": {
+                    "iconEmoji": {
+                      "type": "string"
+                    },
+                    "index": {
+                      "type": "integer"
+                    },
+                    "nestingLevel": {
+                      "type": "integer"
+                    },
+                    "parentTabId": {
+                      "type": "string"
+                    },
+                    "tabId": {
+                      "type": "string"
+                    },
+                    "title": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "documentTab": {
+            "properties": {
+              "body": {
+                "properties": {
+                  "content": {
+                    "items": {
+                      "type": "object"
+                    },
+                    "type": "array"
+                  }
+                },
+                "type": "object"
+              },
+              "commentAnchors": {
+                "type": "object"
+              },
+              "documentStyle": {
+                "properties": {
+                  "background": {
+                    "type": "object"
+                  },
+                  "defaultFooterId": {
+                    "type": "string"
+                  },
+                  "defaultHeaderId": {
+                    "type": "string"
+                  },
+                  "documentFormat": {
+                    "type": "object"
+                  },
+                  "evenPageFooterId": {
+                    "type": "string"
+                  },
+                  "evenPageHeaderId": {
+                    "type": "string"
+                  },
+                  "firstPageFooterId": {
+                    "type": "string"
+                  },
+                  "firstPageHeaderId": {
+                    "type": "string"
+                  },
+                  "flipPageOrientation": {
+                    "type": "boolean"
+                  },
+                  "marginBottom": {
+                    "type": "object"
+                  },
+                  "marginFooter": {
+                    "type": "object"
+                  },
+                  "marginHeader": {
+                    "type": "object"
+                  },
+                  "marginLeft": {
+                    "type": "object"
+                  },
+                  "marginRight": {
+                    "type": "object"
+                  },
+                  "marginTop": {
+                    "type": "object"
+                  },
+                  "pageNumberStart": {
+                    "type": "integer"
+                  },
+                  "pageSize": {
+                    "type": "object"
+                  },
+                  "useCustomHeaderFooterMargins": {
+                    "type": "boolean"
+                  },
+                  "useEvenPageHeaderFooter": {
+                    "type": "boolean"
+                  },
+                  "useFirstPageHeaderFooter": {
+                    "type": "boolean"
+                  }
+                },
+                "type": "object"
+              },
+              "dropdownDefinitions": {
+                "type": "object"
+              },
+              "footers": {
+                "type": "object"
+              },
+              "footnotes": {
+                "type": "object"
+              },
+              "headers": {
+                "type": "object"
+              },
+              "inlineObjects": {
+                "type": "object"
+              },
+              "lists": {
+                "type": "object"
+              },
+              "namedRanges": {
+                "type": "object"
+              },
+              "namedStyles": {
+                "properties": {
+                  "styles": {
+                    "items": {
+                      "type": "object"
+                    },
+                    "type": "array"
+                  }
+                },
+                "type": "object"
+              },
+              "positionedObjects": {
+                "type": "object"
+              },
+              "suggestedDocumentStyleChanges": {
+                "type": "object"
+              },
+              "suggestedNamedStylesChanges": {
+                "type": "object"
+              }
+            },
+            "type": "object"
+          },
+          "tabProperties": {
+            "properties": {
+              "iconEmoji": {
+                "type": "string"
+              },
+              "index": {
+                "type": "integer"
+              },
+              "nestingLevel": {
+                "type": "integer"
+              },
+              "parentTabId": {
+                "type": "string"
+              },
+              "tabId": {
+                "type": "string"
+              },
+              "title": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "title": {
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

First observedOct 26, 2026

TDQS

A4/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the burden and does well: it flags the operation as HTTP POST / mutating, and explicitly warns it is 'refused under --readonly safety profiles' and that content fields are silently ignored. It stops short of stating auth scopes or where the new document lands in Drive.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The first two sentences are perfectly front-loaded and earn their place, but the second half is a dense run-on that mixes HTTP verb metadata, a redundant field enumeration already present in the schema, and transport mechanics. Tightening the field list would improve it.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists so return values needn't be described, and the schema fully documents all five parameters; the description supplies the non-obvious parts (mutation, read-only refusal, ignored fields, body delivery routes). Missing only incidental context such as required OAuth scope or destination folder.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3, but the description adds real meaning beyond it: only `title` in the Document body takes effect, and the body can be supplied either merged through `params` or wholesale via `body_file`. The trailing enumeration of Document fields ('body, comments, commentsViewMode ... and 12 more') mostly duplicates the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ('Creates a blank document') plus the crucial scope constraint that only the title is honored and 'other fields ... including any provided content, are ignored.' That caveat alone disambiguates it from batchUpdate/get, which are named as same-resource siblings.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It names the sibling operations (batchUpdate, get) over the same resource, which implies the read/append/modify split, but never says when to choose this over them or over alternatives like copying a template with drive.files.copy. Usage is implied rather than stated as a when/when-not rule.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server