grr

Overview Schema Source Related Servers Discussions Admin

drive.files.update

Update a Google Drive file’s metadata, content, or both by sending only the fields you want to modify.

Instructions

Updates a file's metadata, content, or both. When calling this method, only populate fields in the request that you want to modify. When updating fields, some fields might be changed automatically, such as modifiedDate. This method supports patch semantics. This method supports an /upload URI and accepts uploaded media with the following characteristics: - Maximum file size: 5,120 GB - Accepted Media MIME types: */* (Specify a valid MIME type, rather than the literal */* value. The literal */* is only used to indicate that any valid MIME type can be uploaded. For more information [HTTP PATCH] — updates the resource; refused under --readonly safety profiles. Returns the API's response resource as JSON — request body is a JSON File object accepting appProperties, capabilities, clientEncryptionDetails, contentHints, contentRestrictions, copyRequiresWriterPermission, createdTime, description and 57 more fields; pass it via params or whole via body_file Siblings over the same resource: copy, create, delete, download, emptyTrash, export, generateCseToken, generateIds, get, list, listLabels, modifyLabels, watch.

Input Schema

Name	Required	Description	Default
`query`	No	Extra KEY=VALUE query pairs for endpoints whose parameters Discovery does not describe.
`fileId`	Yes	[URL path segment] The ID of the file.
`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 File object.
`addParents`	No	[query parameter] A comma-separated list of parent IDs to add.
`ocrLanguage`	No	[query parameter] A language hint for OCR processing during image import (ISO 639-1 code).
`request_body`	No	Request body of type File: pass it via `params` (merged into the built body) or whole via `body_file`.
`includeLabels`	No	[query parameter] A comma-separated list of IDs of labels to include in the `labelInfo` part of the response.
`removeParents`	No	[query parameter] A comma-separated list of parent IDs to remove.
`supportsAllDrives`	No	[query parameter] Whether the requesting application supports both My Drives and shared drives.	false
`supportsTeamDrives`	No	[query parameter] Deprecated: Use `supportsAllDrives` instead.	false
`enforceSingleParent`	No	[query parameter] Deprecated: Adding files to multiple folders is no longer supported. Use shortcuts instead.	false
`keepRevisionForever`	No	[query parameter] Whether to set the `keepForever` field in the new head revision. This is only applicable to files with binary content in Google Drive. Only 200 revisions for th	false
`includePermissionsForView`	No	[query parameter] Specifies which additional view's permissions to include in the response. Only `published` is supported.
`useContentAsIndexableText`	No	[query parameter] Whether to use the uploaded content as indexable text.	false

Output Schema

Name	Required	Description	Default
`id`	No
`kind`	No
`name`	No
`size`	No
`owners`	No
`shared`	No
`spaces`	No
`driveId`	No
`parents`	No
`starred`	No
`trashed`	No
`version`	No
`iconLink`	No
`mimeType`	No
`labelInfo`	No
`ownedByMe`	No
`properties`	No
`viewedByMe`	No
`createdTime`	No
`description`	No
`exportLinks`	No
`md5Checksum`	No
`permissions`	No
`resourceKey`	No
`sharingUser`	No
`teamDriveId`	No
`trashedTime`	No
`webViewLink`	No
`capabilities`	No
`contentHints`	No
`hasThumbnail`	No
`modifiedByMe`	No
`modifiedTime`	No
`sha1Checksum`	No
`trashingUser`	No
`appProperties`	No
`fileExtension`	No
`permissionIds`	No
`thumbnailLink`	No
`folderColorRgb`	No
`headRevisionId`	No
`quotaBytesUsed`	No
`sha256Checksum`	No
`viewedByMeTime`	No
`webContentLink`	No
`isAppAuthorized`	No
`shortcutDetails`	No
`writersCanShare`	No
`modifiedByMeTime`	No
`originalFilename`	No
`sharedWithMeTime`	No
`thumbnailVersion`	No
`explicitlyTrashed`	No
`fullFileExtension`	No
`lastModifyingUser`	No
`linkShareMetadata`	No
`imageMediaMetadata`	No
`videoMediaMetadata`	No
`contentRestrictions`	No
`downloadRestrictions`	No
`viewersCanCopyContent`	No
`clientEncryptionDetails`	No
`hasAugmentedPermissions`	No
`copyRequiresWriterPermission`	No
`inheritedPermissionsDisabled`	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 File object."

addedInput schema / properties / request_body

Added value: +{
+  "description": "Request body of type File: pass it via `params` (merged into the built body) or whole via `body_file`.",
+  "properties": {
+    "appProperties": {
+      "type": "object"
+    },
+    "capabilities": {
+      "properties": {
+        "canAcceptOwnership": {
+          "type": "boolean"
+        },
+        "canAccessViaGenAi": {
+          "type": "boolean"
+        },
+        "canAddChildren": {
+          "type": "boolean"
+        },
+        "canAddFolderFromAnotherDrive": {
+          "type": "boolean"
+        },
+        "canAddMyDriveParent": {
+          "type": "boolean"
+        },
+        "canChangeCopyRequiresWriterPermission": {
+          "type": "boolean"
+        },
+        "canChangeItemDownloadRestriction": {
+          "type": "boolean"
+        },
+        "canChangeSecurityUpdateEnabled": {
+          "type": "boolean"
+        },
+        "canChangeViewersCanCopyContent": {
+          "type": "boolean"
+        },
+        "canComment": {
+          "type": "boolean"
+        },
+        "canCopy": {
+          "type": "boolean"
+        },
+        "canDelete": {
+          "type": "boolean"
+        },
+        "canDeleteChildren": {
+          "type": "boolean"
+        },
+        "canDisableInheritedPermissions": {
+          "type": "boolean"
+        },
+        "canDownload": {
+          "type": "boolean"
+        },
+        "canEdit": {
+          "type": "boolean"
+        },
+        "canEnableInheritedPermissions": {
+          "type": "boolean"
+        },
+        "canListChildren": {
+          "type": "boolean"
+        },
+        "canModifyContent": {
+          "type": "boolean"
+        },
+        "canModifyContentRestriction": {
+          "type": "boolean"
+        },
+        "canModifyEditorContentRestriction": {
+          "type": "boolean"
+        },
+        "canModifyLabels": {
+          "type": "boolean"
+        },
+        "canModifyOwnerContentRestriction": {
+          "type": "boolean"
+        },
+        "canMoveChildrenOutOfDrive": {
+          "type": "boolean"
+        },
+        "canMoveChildrenOutOfTeamDrive": {
+          "type": "boolean"
+        },
+        "canMoveChildrenWithinDrive": {
+          "type": "boolean"
+        },
+        "canMoveChildrenWithinTeamDrive": {
+          "type": "boolean"
+        },
+        "canMoveItemIntoTeamDrive": {
+          "type": "boolean"
+        },
+        "canMoveItemOutOfDrive": {
+          "type": "boolean"
+        },
+        "canMoveItemOutOfTeamDrive": {
+          "type": "boolean"
+        },
+        "canMoveItemWithinDrive": {
+          "type": "boolean"
+        },
+        "canMoveItemWithinTeamDrive": {
+          "type": "boolean"
+        },
+        "canMoveTeamDriveItem": {
+          "type": "boolean"
+        },
+        "canReadDrive": {
+          "type": "boolean"
+        },
+        "canReadLabels": {
+          "type": "boolean"
+        },
+        "canReadRevisions": {
+          "type": "boolean"
+        },
+        "canReadTeamDrive": {
+          "type": "boolean"
+        },
+        "canRemoveChildren": {
+          "type": "boolean"
+        },
+        "canRemoveContentRestriction": {
+          "type": "boolean"
+        },
+        "canRemoveMyDriveParent": {
+          "type": "boolean"
+        },
+        "canRename": {
+          "type": "boolean"
+        },
+        "canShare": {
+          "type": "boolean"
+        },
+        "canStartApproval": {
+          "type": "boolean"
+        },
+        "canTrash": {
+          "type": "boolean"
+        },
+        "canTrashChildren": {
+          "type": "boolean"
+        },
+        "canUntrash": {
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "clientEncryptionDetails": {
+      "properties": {
+        "decryptionMetadata": {
+          "properties": {
+            "aes256GcmChunkSize": {
+              "type": "string"
+            },
+            "encryptionResourceKeyHash": {
+              "type": "string"
+            },
+            "jwt": {
+              "type": "string"
+            },
+            "kaclsId": {
+              "type": "string"
+            },
+            "kaclsName": {
+              "type": "string"
+            },
+            "keyFormat": {
+              "type": "string"
+            },
+            "wrappedKey": {
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "encryptionState": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "contentHints": {
+      "properties": {
+        "indexableText": {
+          "type": "string"
+        },
+        "thumbnail": {
+          "properties": {
+            "image": {
+              "type": "string"
+            },
+            "mimeType": {
+              "type": "string"
+            }
+          },
+          "type": "object"
+        }
+      },
+      "type": "object"
+    },
+    "contentRestrictions": {
+      "items": {
+        "properties": {
+          "ownerRestricted": {
+            "type": "boolean"
+          },
+          "readOnly": {
+            "type": "boolean"
+          },
+          "reason": {
+            "type": "string"
+          },
+          "restrictingUser": {
+            "properties": {
+              "displayName": {
+                "type": "string"
+              },
+              "emailAddress": {
+                "type": "string"
+              },
+              "kind": {
+                "type": "string"
+              },
+              "me": {
+                "type": "boolean"
+              },
+              "permissionId": {
+                "type": "string"
+              },
+              "photoLink": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "restrictionTime": {
+            "type": "string"
+          },
+          "systemRestricted": {
+            "type": "boolean"
+          },
+          "type": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "copyRequiresWriterPermission": {
+      "type": "boolean"
+    },
+    "createdTime": {
+      "type": "string"
+    },
+    "description": {
+      "type": "string"
+    },
+    "downloadRestrictions": {
+      "properties": {
+        "effectiveDownloadRestrictionWithContext": {
+          "properties": {
+            "restrictedForReaders": {
+              "type": "boolean"
+            },
+            "restrictedForWriters": {
+              "type": "boolean"
+            }
+          },
+          "type": "object"
+        },
+        "itemDownloadRestriction": {
+          "properties": {
+            "restrictedForReaders": {
+              "type": "boolean"
+            },
+            "restrictedForWriters": {
+              "type": "boolean"
+            }
+          },
+          "type": "object"
+        }
+      },
+      "type": "object"
+    },
+    "driveId": {
+      "type": "string"
+    },
+    "explicitlyTrashed": {
+      "type": "boolean"
+    },
+    "exportLinks": {
+      "type": "object"
+    },
+    "fileExtension": {
+      "type": "string"
+    },
+    "folderColorRgb": {
+      "type": "string"
+    },
+    "fullFileExtension": {
+      "type": "string"
+    },
+    "hasAugmentedPermissions": {
+      "type": "boolean"
+    },
+    "hasThumbnail": {
+      "type": "boolean"
+    },
+    "headRevisionId": {
+      "type": "string"
+    },
+    "iconLink": {
+      "type": "string"
+    },
+    "id": {
+      "type": "string"
+    },
+    "imageMediaMetadata": {
+      "properties": {
+        "aperture": {
+          "type": "number"
+        },
+        "cameraMake": {
+          "type": "string"
+        },
+        "cameraModel": {
+          "type": "string"
+        },
+        "colorSpace": {
+          "type": "string"
+        },
+        "exposureBias": {
+          "type": "number"
+        },
+        "exposureMode": {
+          "type": "string"
+        },
+        "exposureTime": {
+          "type": "number"
+        },
+        "flashUsed": {
+          "type": "boolean"
+        },
+        "focalLength": {
+          "type": "number"
+        },
+        "height": {
+          "type": "integer"
+        },
+        "isoSpeed": {
+          "type": "integer"
+        },
+        "lens": {
+          "type": "string"
+        },
+        "location": {
+          "properties": {
+            "altitude": {
+              "type": "number"
+            },
+            "latitude": {
+              "type": "number"
+            },
+            "longitude": {
+              "type": "number"
+            }
+          },
+          "type": "object"
+        },
+        "maxApertureValue": {
+          "type": "number"
+        },
+        "meteringMode": {
+          "type": "string"
+        },
+        "rotation": {
+          "type": "integer"
+        },
+        "sensor": {
+          "type": "string"
+        },
+        "subjectDistance": {
+          "type": "integer"
+        },
+        "time": {
+          "type": "string"
+        },
+        "whiteBalance": {
+          "type": "string"
+        },
+        "width": {
+          "type": "integer"
+        }
+      },
+      "type": "object"
+    },
+    "inheritedPermissionsDisabled": {
+      "type": "boolean"
+    },
+    "isAppAuthorized": {
+      "type": "boolean"
+    },
+    "kind": {
+      "type": "string"
+    },
+    "labelInfo": {
+      "properties": {
+        "labels": {
+          "items": {
+            "properties": {
+              "fields": {
+                "type": "object"
+              },
+              "id": {
+                "type": "string"
+              },
+              "kind": {
+                "type": "string"
+              },
+              "revisionId": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "type": "array"
+        }
+      },
+      "type": "object"
+    },
+    "lastModifyingUser": {
+      "properties": {
+        "displayName": {
+          "type": "string"
+        },
+        "emailAddress": {
+          "type": "string"
+        },
+        "kind": {
+          "type": "string"
+        },
+        "me": {
+          "type": "boolean"
+        },
+        "permissionId": {
+          "type": "string"
+        },
+        "photoLink": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "linkShareMetadata": {
+      "properties": {
+        "securityUpdateEligible": {
+          "type": "boolean"
+        },
+        "securityUpdateEnabled": {
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "md5Checksum": {
+      "type": "string"
+    },
+    "mimeType": {
+      "type": "string"
+    },
+    "modifiedByMe": {
+      "type": "boolean"
+    },
+    "modifiedByMeTime": {
+      "type": "string"
+    },
+    "modifiedTime": {
+      "type": "string"
+    },
+    "name": {
+      "type": "string"
+    },
+    "originalFilename": {
+      "type": "string"
+    },
+    "ownedByMe": {
+      "type": "boolean"
+    },
+    "owners": {
+      "items": {
+        "properties": {
+          "displayName": {
+            "type": "string"
+          },
+          "emailAddress": {
+            "type": "string"
+          },
+          "kind": {
+            "type": "string"
+          },
+          "me": {
+            "type": "boolean"
+          },
+          "permissionId": {
+            "type": "string"
+          },
+          "photoLink": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "parents": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "permissionIds": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "permissions": {
+      "items": {
+        "properties": {
+          "allowFileDiscovery": {
+            "type": "boolean"
+          },
+          "deleted": {
+            "type": "boolean"
+          },
+          "displayName": {
+            "type": "string"
+          },
+          "domain": {
+            "type": "string"
+          },
+          "emailAddress": {
+            "type": "string"
+          },
+          "expirationTime": {
+            "type": "string"
+          },
+          "id": {
+            "type": "string"
+          },
+          "inheritedPermissionsDisabled": {
+            "type": "boolean"
+          },
+          "kind": {
+            "type": "string"
+          },
+          "pendingOwner": {
+            "type": "boolean"
+          },
+          "permissionDetails": {
+            "items": {
+              "properties": {
+                "inherited": {
+                  "type": "boolean"
+                },
+                "inheritedFrom": {
+                  "type": "string"
+                },
+                "permissionType": {
+                  "type": "string"
+                },
+                "role": {
+                  "type": "string"
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "photoLink": {
+            "type": "string"
+          },
+          "role": {
+            "type": "string"
+          },
+          "teamDrivePermissionDetails": {
+            "items": {
+              "properties": {
+                "inherited": {
+                  "type": "boolean"
+                },
+                "inheritedFrom": {
+                  "type": "string"
+                },
+                "role": {
+                  "type": "string"
+                },
+                "teamDrivePermissionType": {
+                  "type": "string"
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "type": {
+            "type": "string"
+          },
+          "view": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "properties": {
+      "type": "object"
+    },
+    "quotaBytesUsed": {
+      "type": "string"
+    },
+    "resourceKey": {
+      "type": "string"
+    },
+    "sha1Checksum": {
+      "type": "string"
+    },
+    "sha256Checksum": {
+      "type": "string"
+    },
+    "shared": {
+      "type": "boolean"
+    },
+    "sharedWithMeTime": {
+      "type": "string"
+    },
+    "sharingUser": {
+      "properties": {
+        "displayName": {
+          "type": "string"
+        },
+        "emailAddress": {
+          "type": "string"
+        },
+        "kind": {
+          "type": "string"
+        },
+        "me": {
+          "type": "boolean"
+        },
+        "permissionId": {
+          "type": "string"
+        },
+        "photoLink": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "shortcutDetails": {
+      "properties": {
+        "targetId": {
+          "type": "string"
+        },
+        "targetMimeType": {
+          "type": "string"
+        },
+        "targetResourceKey": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "size": {
+      "type": "string"
+    },
+    "spaces": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "starred": {
+      "type": "boolean"
+    },
+    "teamDriveId": {
+      "type": "string"
+    },
+    "thumbnailLink": {
+      "type": "string"
+    },
+    "thumbnailVersion": {
+      "type": "string"
+    },
+    "trashed": {
+      "type": "boolean"
+    },
+    "trashedTime": {
+      "type": "string"
+    },
+    "trashingUser": {
+      "properties": {
+        "displayName": {
+          "type": "string"
+        },
+        "emailAddress": {
+          "type": "string"
+        },
+        "kind": {
+          "type": "string"
+        },
+        "me": {
+          "type": "boolean"
+        },
+        "permissionId": {
+          "type": "string"
+        },
+        "photoLink": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "version": {
+      "type": "string"
+    },
+    "videoMediaMetadata": {
+      "properties": {
+        "durationMillis": {
+          "type": "string"
+        },
+        "height": {
+          "type": "integer"
+        },
+        "width": {
+          "type": "integer"
+        }
+      },
+      "type": "object"
+    },
+    "viewedByMe": {
+      "type": "boolean"
+    },
+    "viewedByMeTime": {
+      "type": "string"
+    },
+    "viewersCanCopyContent": {
+      "type": "boolean"
+    },
+    "webContentLink": {
+      "type": "string"
+    },
+    "webViewLink": {
+      "type": "string"
+    },
+    "writersCanShare": {
+      "type": "boolean"
+    }
+  },
+  "type": "object"
+}

Changed17 schema fields changedOct 26, 2026

changedInput schema / properties / addParents / description

Previous value: -"A comma-separated list of parent IDs to add."New value: +"[query parameter] A comma-separated list of parent IDs to add."

addedInput schema / properties / enforceSingleParent / default
```
Added value: +"false"
```

changedInput schema / properties / enforceSingleParent / description

Previous value: -"Deprecated: Adding files to multiple folders is no longer supported. Use shortcuts instead."New value: +"[query parameter] Deprecated: Adding files to multiple folders is no longer supported. Use shortcuts instead."

changedInput schema / properties / fileId / description

Previous value: -"The ID of the file."New value: +"[URL path segment] The ID of the file."

changedInput schema / properties / includeLabels / description

Previous value: -"A comma-separated list of IDs of labels to include in the `labelInfo` part of the response."New value: +"[query parameter] A comma-separated list of IDs of labels to include in the `labelInfo` part of the response."

changedInput schema / properties / includePermissionsForView / description

Previous value: -"Specifies which additional view's permissions to include in the response. Only `published` is supported."New value: +"[query parameter] Specifies which additional view's permissions to include in the response. Only `published` is supported."

addedInput schema / properties / keepRevisionForever / default
```
Added value: +"false"
```

changedInput schema / properties / keepRevisionForever / description

Previous value: -"Whether to set the `keepForever` field in the new head revision. This is only applicable to files with binary content in Google Drive. Only 200 revisions for th"New value: +"[query parameter] Whether to set the `keepForever` field in the new head revision. This is only applicable to files with binary content in Google Drive. Only 200 revisions for th"

changedInput schema / properties / ocrLanguage / description

Previous value: -"A language hint for OCR processing during image import (ISO 639-1 code)."New value: +"[query parameter] A language hint for OCR processing during image import (ISO 639-1 code)."

changedInput schema / properties / removeParents / description

Previous value: -"A comma-separated list of parent IDs to remove."New value: +"[query parameter] A comma-separated list of parent IDs to remove."

addedInput schema / properties / supportsAllDrives / default
```
Added value: +"false"
```

changedInput schema / properties / supportsAllDrives / description

Previous value: -"Whether the requesting application supports both My Drives and shared drives."New value: +"[query parameter] Whether the requesting application supports both My Drives and shared drives."

addedInput schema / properties / supportsTeamDrives / default
```
Added value: +"false"
```

changedInput schema / properties / supportsTeamDrives / description

Previous value: -"Deprecated: Use `supportsAllDrives` instead."New value: +"[query parameter] Deprecated: Use `supportsAllDrives` instead."

addedInput schema / properties / useContentAsIndexableText / default
```
Added value: +"false"
```

changedInput schema / properties / useContentAsIndexableText / description

Previous value: -"Whether to use the uploaded content as indexable text."New value: +"[query parameter] Whether to use the uploaded content as indexable text."

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "properties": {
+    "appProperties": {
+      "type": "object"
+    },
+    "capabilities": {
+      "properties": {
+        "canAcceptOwnership": {
+          "type": "boolean"
+        },
+        "canAccessViaGenAi": {
+          "type": "boolean"
+        },
+        "canAddChildren": {
+          "type": "boolean"
+        },
+        "canAddFolderFromAnotherDrive": {
+          "type": "boolean"
+        },
+        "canAddMyDriveParent": {
+          "type": "boolean"
+        },
+        "canChangeCopyRequiresWriterPermission": {
+          "type": "boolean"
+        },
+        "canChangeItemDownloadRestriction": {
+          "type": "boolean"
+        },
+        "canChangeSecurityUpdateEnabled": {
+          "type": "boolean"
+        },
+        "canChangeViewersCanCopyContent": {
+          "type": "boolean"
+        },
+        "canComment": {
+          "type": "boolean"
+        },
+        "canCopy": {
+          "type": "boolean"
+        },
+        "canDelete": {
+          "type": "boolean"
+        },
+        "canDeleteChildren": {
+          "type": "boolean"
+        },
+        "canDisableInheritedPermissions": {
+          "type": "boolean"
+        },
+        "canDownload": {
+          "type": "boolean"
+        },
+        "canEdit": {
+          "type": "boolean"
+        },
+        "canEnableInheritedPermissions": {
+          "type": "boolean"
+        },
+        "canListChildren": {
+          "type": "boolean"
+        },
+        "canModifyContent": {
+          "type": "boolean"
+        },
+        "canModifyContentRestriction": {
+          "type": "boolean"
+        },
+        "canModifyEditorContentRestriction": {
+          "type": "boolean"
+        },
+        "canModifyLabels": {
+          "type": "boolean"
+        },
+        "canModifyOwnerContentRestriction": {
+          "type": "boolean"
+        },
+        "canMoveChildrenOutOfDrive": {
+          "type": "boolean"
+        },
+        "canMoveChildrenOutOfTeamDrive": {
+          "type": "boolean"
+        },
+        "canMoveChildrenWithinDrive": {
+          "type": "boolean"
+        },
+        "canMoveChildrenWithinTeamDrive": {
+          "type": "boolean"
+        },
+        "canMoveItemIntoTeamDrive": {
+          "type": "boolean"
+        },
+        "canMoveItemOutOfDrive": {
+          "type": "boolean"
+        },
+        "canMoveItemOutOfTeamDrive": {
+          "type": "boolean"
+        },
+        "canMoveItemWithinDrive": {
+          "type": "boolean"
+        },
+        "canMoveItemWithinTeamDrive": {
+          "type": "boolean"
+        },
+        "canMoveTeamDriveItem": {
+          "type": "boolean"
+        },
+        "canReadDrive": {
+          "type": "boolean"
+        },
+        "canReadLabels": {
+          "type": "boolean"
+        },
+        "canReadRevisions": {
+          "type": "boolean"
+        },
+        "canReadTeamDrive": {
+          "type": "boolean"
+        },
+        "canRemoveChildren": {
+          "type": "boolean"
+        },
+        "canRemoveContentRestriction": {
+          "type": "boolean"
+        },
+        "canRemoveMyDriveParent": {
+          "type": "boolean"
+        },
+        "canRename": {
+          "type": "boolean"
+        },
+        "canShare": {
+          "type": "boolean"
+        },
+        "canStartApproval": {
+          "type": "boolean"
+        },
+        "canTrash": {
+          "type": "boolean"
+        },
+        "canTrashChildren": {
+          "type": "boolean"
+        },
+        "canUntrash": {
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "clientEncryptionDetails": {
+      "properties": {
+        "decryptionMetadata": {
+          "properties": {
+            "aes256GcmChunkSize": {
+              "type": "string"
+            },
+            "encryptionResourceKeyHash": {
+              "type": "string"
+            },
+            "jwt": {
+              "type": "string"
+            },
+            "kaclsId": {
+              "type": "string"
+            },
+            "kaclsName": {
+              "type": "string"
+            },
+            "keyFormat": {
+              "type": "string"
+            },
+            "wrappedKey": {
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "encryptionState": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "contentHints": {
+      "properties": {
+        "indexableText": {
+          "type": "string"
+        },
+        "thumbnail": {
+          "properties": {
+            "image": {
+              "type": "string"
+            },
+            "mimeType": {
+              "type": "string"
+            }
+          },
+          "type": "object"
+        }
+      },
+      "type": "object"
+    },
+    "contentRestrictions": {
+      "items": {
+        "properties": {
+          "ownerRestricted": {
+            "type": "boolean"
+          },
+          "readOnly": {
+            "type": "boolean"
+          },
+          "reason": {
+            "type": "string"
+          },
+          "restrictingUser": {
+            "properties": {
+              "displayName": {
+                "type": "string"
+              },
+              "emailAddress": {
+                "type": "string"
+              },
+              "kind": {
+                "type": "string"
+              },
+              "me": {
+                "type": "boolean"
+              },
+              "permissionId": {
+                "type": "string"
+              },
+              "photoLink": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "restrictionTime": {
+            "type": "string"
+          },
+          "systemRestricted": {
+            "type": "boolean"
+          },
+          "type": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "copyRequiresWriterPermission": {
+      "type": "boolean"
+    },
+    "createdTime": {
+      "type": "string"
+    },
+    "description": {
+      "type": "string"
+    },
+    "downloadRestrictions": {
+      "properties": {
+        "effectiveDownloadRestrictionWithContext": {
+          "properties": {
+            "restrictedForReaders": {
+              "type": "boolean"
+            },
+            "restrictedForWriters": {
+              "type": "boolean"
+            }
+          },
+          "type": "object"
+        },
+        "itemDownloadRestriction": {
+          "properties": {
+            "restrictedForReaders": {
+              "type": "boolean"
+            },
+            "restrictedForWriters": {
+              "type": "boolean"
+            }
+          },
+          "type": "object"
+        }
+      },
+      "type": "object"
+    },
+    "driveId": {
+      "type": "string"
+    },
+    "explicitlyTrashed": {
+      "type": "boolean"
+    },
+    "exportLinks": {
+      "type": "object"
+    },
+    "fileExtension": {
+      "type": "string"
+    },
+    "folderColorRgb": {
+      "type": "string"
+    },
+    "fullFileExtension": {
+      "type": "string"
+    },
+    "hasAugmentedPermissions": {
+      "type": "boolean"
+    },
+    "hasThumbnail": {
+      "type": "boolean"
+    },
+    "headRevisionId": {
+      "type": "string"
+    },
+    "iconLink": {
+      "type": "string"
+    },
+    "id": {
+      "type": "string"
+    },
+    "imageMediaMetadata": {
+      "properties": {
+        "aperture": {
+          "type": "number"
+        },
+        "cameraMake": {
+          "type": "string"
+        },
+        "cameraModel": {
+          "type": "string"
+        },
+        "colorSpace": {
+          "type": "string"
+        },
+        "exposureBias": {
+          "type": "number"
+        },
+        "exposureMode": {
+          "type": "string"
+        },
+        "exposureTime": {
+          "type": "number"
+        },
+        "flashUsed": {
+          "type": "boolean"
+        },
+        "focalLength": {
+          "type": "number"
+        },
+        "height": {
+          "type": "integer"
+        },
+        "isoSpeed": {
+          "type": "integer"
+        },
+        "lens": {
+          "type": "string"
+        },
+        "location": {
+          "properties": {
+            "altitude": {
+              "type": "number"
+            },
+            "latitude": {
+              "type": "number"
+            },
+            "longitude": {
+              "type": "number"
+            }
+          },
+          "type": "object"
+        },
+        "maxApertureValue": {
+          "type": "number"
+        },
+        "meteringMode": {
+          "type": "string"
+        },
+        "rotation": {
+          "type": "integer"
+        },
+        "sensor": {
+          "type": "string"
+        },
+        "subjectDistance": {
+          "type": "integer"
+        },
+        "time": {
+          "type": "string"
+        },
+        "whiteBalance": {
+          "type": "string"
+        },
+        "width": {
+          "type": "integer"
+        }
+      },
+      "type": "object"
+    },
+    "inheritedPermissionsDisabled": {
+      "type": "boolean"
+    },
+    "isAppAuthorized": {
+      "type": "boolean"
+    },
+    "kind": {
+      "type": "string"
+    },
+    "labelInfo": {
+      "properties": {
+        "labels": {
+          "items": {
+            "properties": {
+              "fields": {
+                "type": "object"
+              },
+              "id": {
+                "type": "string"
+              },
+              "kind": {
+                "type": "string"
+              },
+              "revisionId": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "type": "array"
+        }
+      },
+      "type": "object"
+    },
+    "lastModifyingUser": {
+      "properties": {
+        "displayName": {
+          "type": "string"
+        },
+        "emailAddress": {
+          "type": "string"
+        },
+        "kind": {
+          "type": "string"
+        },
+        "me": {
+          "type": "boolean"
+        },
+        "permissionId": {
+          "type": "string"
+        },
+        "photoLink": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "linkShareMetadata": {
+      "properties": {
+        "securityUpdateEligible": {
+          "type": "boolean"
+        },
+        "securityUpdateEnabled": {
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "md5Checksum": {
+      "type": "string"
+    },
+    "mimeType": {
+      "type": "string"
+    },
+    "modifiedByMe": {
+      "type": "boolean"
+    },
+    "modifiedByMeTime": {
+      "type": "string"
+    },
+    "modifiedTime": {
+      "type": "string"
+    },
+    "name": {
+      "type": "string"
+    },
+    "originalFilename": {
+      "type": "string"
+    },
+    "ownedByMe": {
+      "type": "boolean"
+    },
+    "owners": {
+      "items": {
+        "properties": {
+          "displayName": {
+            "type": "string"
+          },
+          "emailAddress": {
+            "type": "string"
+          },
+          "kind": {
+            "type": "string"
+          },
+          "me": {
+            "type": "boolean"
+          },
+          "permissionId": {
+            "type": "string"
+          },
+          "photoLink": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "parents": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "permissionIds": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "permissions": {
+      "items": {
+        "properties": {
+          "allowFileDiscovery": {
+            "type": "boolean"
+          },
+          "deleted": {
+            "type": "boolean"
+          },
+          "displayName": {
+            "type": "string"
+          },
+          "domain": {
+            "type": "string"
+          },
+          "emailAddress": {
+            "type": "string"
+          },
+          "expirationTime": {
+            "type": "string"
+          },
+          "id": {
+            "type": "string"
+          },
+          "inheritedPermissionsDisabled": {
+            "type": "boolean"
+          },
+          "kind": {
+            "type": "string"
+          },
+          "pendingOwner": {
+            "type": "boolean"
+          },
+          "permissionDetails": {
+            "items": {
+              "properties": {
+                "inherited": {
+                  "type": "boolean"
+                },
+                "inheritedFrom": {
+                  "type": "string"
+                },
+                "permissionType": {
+                  "type": "string"
+                },
+                "role": {
+                  "type": "string"
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "photoLink": {
+            "type": "string"
+          },
+          "role": {
+            "type": "string"
+          },
+          "teamDrivePermissionDetails": {
+            "items": {
+              "properties": {
+                "inherited": {
+                  "type": "boolean"
+                },
+                "inheritedFrom": {
+                  "type": "string"
+                },
+                "role": {
+                  "type": "string"
+                },
+                "teamDrivePermissionType": {
+                  "type": "string"
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "type": {
+            "type": "string"
+          },
+          "view": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "properties": {
+      "type": "object"
+    },
+    "quotaBytesUsed": {
+      "type": "string"
+    },
+    "resourceKey": {
+      "type": "string"
+    },
+    "sha1Checksum": {
+      "type": "string"
+    },
+    "sha256Checksum": {
+      "type": "string"
+    },
+    "shared": {
+      "type": "boolean"
+    },
+    "sharedWithMeTime": {
+      "type": "string"
+    },
+    "sharingUser": {
+      "properties": {
+        "displayName": {
+          "type": "string"
+        },
+        "emailAddress": {
+          "type": "string"
+        },
+        "kind": {
+          "type": "string"
+        },
+        "me": {
+          "type": "boolean"
+        },
+        "permissionId": {
+          "type": "string"
+        },
+        "photoLink": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "shortcutDetails": {
+      "properties": {
+        "targetId": {
+          "type": "string"
+        },
+        "targetMimeType": {
+          "type": "string"
+        },
+        "targetResourceKey": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "size": {
+      "type": "string"
+    },
+    "spaces": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "starred": {
+      "type": "boolean"
+    },
+    "teamDriveId": {
+      "type": "string"
+    },
+    "thumbnailLink": {
+      "type": "string"
+    },
+    "thumbnailVersion": {
+      "type": "string"
+    },
+    "trashed": {
+      "type": "boolean"
+    },
+    "trashedTime": {
+      "type": "string"
+    },
+    "trashingUser": {
+      "properties": {
+        "displayName": {
+          "type": "string"
+        },
+        "emailAddress": {
+          "type": "string"
+        },
+        "kind": {
+          "type": "string"
+        },
+        "me": {
+          "type": "boolean"
+        },
+        "permissionId": {
+          "type": "string"
+        },
+        "photoLink": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "version": {
+      "type": "string"
+    },
+    "videoMediaMetadata": {
+      "properties": {
+        "durationMillis": {
+          "type": "string"
+        },
+        "height": {
+          "type": "integer"
+        },
+        "width": {
+          "type": "integer"
+        }
+      },
+      "type": "object"
+    },
+    "viewedByMe": {
+      "type": "boolean"
+    },
+    "viewedByMeTime": {
+      "type": "string"
+    },
+    "viewersCanCopyContent": {
+      "type": "boolean"
+    },
+    "webContentLink": {
+      "type": "string"
+    },
+    "webViewLink": {
+      "type": "string"
+    },
+    "writersCanShare": {
+      "type": "boolean"
+    }
+  },
+  "type": "object"
+}

First observedOct 26, 2026

TDQS

B3.4/5.0

Behavior3/5

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

With no annotations, the description carries the full burden and does disclose useful behavior: patch semantics, automatic field changes like modifiedDate, upload size and MIME limits, and that it is 'refused under --readonly safety profiles.' It still omits permission/auth requirements, revision side effects, and conflict behavior for a mutation tool.

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 key sentence is front-loaded, but the text is a run-on that blends API docs boilerplate with a broken fragment ('For more information [HTTP PATCH] — updates the resource') and a mangled bullet list. Roughly a third of the sentences add little for an agent.

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

Completeness3/5

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

For a 16-parameter mutation tool with no annotations, the description covers the body-passing mechanism, patch semantics, and the return value ('Returns the API's response resource as JSON'), and an output schema exists. It is still missing auth/permission requirements and side-effect details that an agent would need before writing.

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 value by explaining the body contract ('pass it via params or whole via body_file') and the upload constraints that are not in the schema. It does not clarify the many File body fields, but the schema handles those.

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

Purpose4/5

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

The opening sentence gives a specific verb plus resource and scope: 'Updates a file's metadata, content, or both,' which separates it from copy/create/delete/get. However, the sibling list at the end merely names the alternatives without saying which one handles which task, so the differentiation is incomplete.

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 advises 'only populate fields in the request that you want to modify,' which is genuine patch-usage guidance, but there is no explicit statement of when to choose this over drive.files.modifyLabels or drive.permissions.update, and no prerequisites or exclusions are given.

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

Deploy Server