> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Drive

> Google Drive is a cloud storage solution for uploading, sharing, and collaborating on files across devices, with robust search and offline access

![Google Drive logo](https://mintcdn.com/composio-preview/o1IUBrrsmtgkhmyf/images/toolkits/googledrive.svg?fit=max\&auto=format\&n=o1IUBrrsmtgkhmyf\&q=85\&s=e46db6ab7584813f9a582c87f1fdf24b)

* **Category:** file management & storage
* **Auth:** OAUTH2
* **Composio-managed OAuth available?** Yes
* **Tools:** 105
* **Triggers:** 7
* **Slug:** `GOOGLEDRIVE`
* **Version:** 20261101\_00

## Frequently Asked Questions

> [accordion] How do I set up custom Google OAuth credentials for Google Drive?
>
> For a step-by-step guide on creating and configuring your own Google OAuth credentials with Composio, see [How to create OAuth2 credentials for Google Apps](https://composio.dev/auth/googleapps).

> [accordion] Why am I seeing "App is blocked" when connecting Google Drive?
>
> The OAuth client is requesting scopes that Google hasn't verified for that client. This usually happens when you add extra scopes beyond the defaults.
>
> Remove the additional scopes from your auth config, or create your own OAuth app and submit the scopes for verification. See [How to create OAuth2 credentials for Google Apps](https://composio.dev/auth/googleapps).

> [accordion] Why am I getting "Google Drive API has not been used in project" error?
>
> When using custom OAuth credentials, the Google Drive API must be enabled in the Google Cloud project that owns those credentials. Enable it in Google Cloud Console under APIs & Services, wait a few minutes, and retry.

> [accordion] Why am I getting "Error 400: invalid\_scope"?
>
> The requested scopes are invalid or incorrectly formatted in the authorization URL. Verify your scope values against the [Google OAuth scopes docs](https://developers.google.com/identity/protocols/oauth2). If you're creating auth configs programmatically, see the [programmatic auth config guide](https://composio-preview.mintlify.site/docs/authentication/programmatic-auth-configs.md).

> [accordion] Why does the OAuth consent screen show "Composio" instead of my app?
>
> By default, the consent screen uses Composio's OAuth app. To show your own app name and logo, create your own OAuth app and set a custom redirect URL. See [White-labeling authentication](https://composio-preview.mintlify.site/docs/authentication/white-labeling-authentication.md#using-your-own-oauth-apps).

> [accordion] Why am I getting 401 errors on tool calls?
>
> The user's access token is no longer valid. Common causes: the user revoked access, changed their password or 2FA, a Workspace admin policy changed, or Google's refresh token limit (\~50 per account) was exceeded. Re-authenticating the user typically resolves this.

## Tools

> [accordion] Add file sharing preference (Deprecated)
>
> **Slug:** `GOOGLEDRIVE_ADD_FILE_SHARING_PREFERENCE`
>
> DEPRECATED: Use GOOGLEDRIVE\_CREATE\_PERMISSION instead; use GOOGLEDRIVE\_UPDATE\_PERMISSION to modify existing permissions (avoids duplicate entries). Modifies sharing permissions for an existing Google Drive file, granting a specified role to a user, group, domain, or 'anyone'. Bulk calls may trigger 403 rateLimitExceeded (\~100 req/100s/user); use jittered exponential backoff.
>
> #### Input Parameters
>
> **role** `string ("owner" | "organizer" | "fileOrganizer" | "writer" | "commenter" | "reader")` *required*
>
> Permission role to grant. Accepted values: 'reader', 'commenter', 'writer', 'fileOrganizer', 'organizer', 'owner'. Invalid strings cause validation failures.
>
> **type** `string ("user" | "group" | "domain" | "anyone")` *required*
>
> Type of grantee for the permission. Using 'anyone' with 'writer' or 'owner' broadly exposes the document — confirm before applying. Admin policies may block 'anyone' or domain-wide sharing. For type='anyone' with role='reader', the link must be explicitly shared; files are not publicly searchable.
>
> **domain** `string`
>
> Domain to grant permission to (e.g., 'example.com'). Required if 'type' is 'domain'.
>
> **file\_id** `string` *required*
>
> Unique identifier of the file to update sharing settings for. Must be an alphanumeric string containing only letters, numbers, hyphens, and underscores (no slashes, spaces, or other special characters). Use GOOGLEDRIVE\_FIND\_FILE or GOOGLEDRIVE\_LIST\_FILES to get valid file IDs from your Google Drive. For shared drive membership, supply the shared drive ID, not an individual document ID.
>
> **email\_address** `string`
>
> Email address of the user or group. Required if 'type' is 'user' or 'group'.
>
> **transfer\_ownership** `boolean`
>
> Whether to transfer ownership to the specified user. Required when role is 'owner'. Only a single user can be specified in the request when transferring ownership. Ownership transfer is difficult to reverse — obtain explicit confirmation before setting true.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Insert File Parent (v2)
>
> **Slug:** `GOOGLEDRIVE_ADD_PARENT`
>
> Tool to add a parent folder for a file using Google Drive API v2. Use when you need to add a file to an additional folder.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The ID of the parent folder to add. This is the folder that will become a parent of the file.
>
> **fileId** `string` *required*
>
> The ID of the file to add a parent folder to.
>
> **supportsAllDrives** `boolean`
>
> Whether the requesting application supports both My Drives and shared drives. Default is false.
>
> **supportsTeamDrives** `boolean`
>
> Deprecated: Use supportsAllDrives instead.
>
> **enforceSingleParent** `boolean`
>
> Deprecated: Adding files to multiple folders is no longer supported. Use shortcuts instead.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Insert Property (v2 API)
>
> **Slug:** `GOOGLEDRIVE_ADD_PROPERTY`
>
> Tool to add a property to a file, or update it if it already exists (v2 API). Use when you need to attach custom key-value metadata to a Google Drive file.
>
> #### Input Parameters
>
> **alt** `string ("json" | "media" | "proto")`
>
> Data format for response.
>
> **key** `string`
>
> API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
>
> **xgafv** `string ("1" | "2")`
>
> V1 error format values.
>
> **fields** `string`
>
> Selector specifying which fields to include in a partial response.
>
> **fileId** `string` *required*
>
> The ID of the file.
>
> **callback** `string`
>
> JSONP callback function name.
>
> **quotaUser** `string`
>
> Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
>
> **uploadType** `string`
>
> Legacy upload protocol for media (e.g. 'media', 'multipart').
>
> **visibility** `string ("PRIVATE" | "PUBLIC")`
>
> Property visibility values.
>
> **oauth\_token** `string`
>
> OAuth 2.0 token for the current user.
>
> **prettyPrint** `boolean`
>
> Returns response with indentations and line breaks.
>
> **access\_token** `string`
>
> OAuth access token.
>
> **property\_key** `string` *required*
>
> The key of this property.
>
> **property\_value** `string` *required*
>
> The value of this property.
>
> **upload\_protocol** `string`
>
> Upload protocol for media (e.g. 'raw', 'multipart').
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Batch Get Spreadsheet Values
>
> **Slug:** `GOOGLEDRIVE_BATCH_GET_SPREADSHEET_VALUES`
>
> Read multiple explicit ranges from one Google Spreadsheet in one request.
>
> #### Input Parameters
>
> **ranges** `array` *required*
>
> One or more explicit A1 or R1C1 ranges to read, in request order. Every range must be nonblank. Use bounded ranges such as 'Sheet1!A1:D1000' for predictable response sizes.
>
> **spreadsheet\_id** `string` *required*
>
> The Google Spreadsheet ID from its URL.
>
> **major\_dimension** `string ("ROWS" | "COLUMNS")`
>
> Whether returned values are organized by rows or columns.
>
> **value\_render\_option** `string ("FORMATTED_VALUE" | "UNFORMATTED_VALUE" | "FORMULA")`
>
> How cell values are rendered in the response.
>
> **date\_time\_render\_option** `string ("SERIAL_NUMBER" | "FORMATTED_STRING")`
>
> How dates, times, and durations are rendered when values are not formatted.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Batch Update Spreadsheet Values
>
> **Slug:** `GOOGLEDRIVE_BATCH_UPDATE_SPREADSHEET_VALUES`
>
> Write values to multiple Google Sheets ranges in one batch request.
>
> #### Input Parameters
>
> **data** `array` *required*
>
> The native Google Sheets value ranges to update in request order.
>
> **spreadsheet\_id** `string` *required*
>
> The spreadsheet ID from its Google Sheets URL, not its title.
>
> **value\_input\_option** `string ("RAW" | "USER_ENTERED")` *required*
>
> How Google Sheets interprets input values: RAW stores them unchanged; USER\_ENTERED parses them as if entered in the Sheets UI.
>
> **include\_values\_in\_response** `boolean`
>
> Whether each update result should include the values written by Google Sheets.
>
> **response\_value\_render\_option** `string ("FORMATTED_VALUE" | "UNFORMATTED_VALUE" | "FORMULA")`
>
> How returned values are rendered when include\_values\_in\_response is true.
>
> **response\_date\_time\_render\_option** `string ("SERIAL_NUMBER" | "FORMATTED_STRING")`
>
> How returned dates and times are rendered when values are unformatted.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Clear Spreadsheet Values
>
> **Slug:** `GOOGLEDRIVE_CLEAR_SPREADSHEET_VALUES`
>
> Permanently clear values from one range while preserving formatting, notes, and validation.
>
> #### Input Parameters
>
> **range** `string` *required*
>
> The A1 or R1C1 notation of the single range whose values should be permanently cleared, such as 'Sheet1!A1:B10'.
>
> **spreadsheet\_id** `string` *required*
>
> The ID of the Google Sheets spreadsheet containing the values to clear.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Copy file (Deprecated)
>
> **Slug:** `GOOGLEDRIVE_COPY_FILE`
>
> DEPRECATED: Use GOOGLEDRIVE\_COPY\_FILE\_ADVANCED instead. Duplicates an existing file (not folders) in Google Drive by `file_id`; copy lands in same folder as original — use GOOGLEDRIVE\_MOVE\_FILE afterward for precise placement. Copy receives a new `file_id`; update stored references accordingly. For shared drives, requires organizer/manager rights.
>
> #### Input Parameters
>
> **file\_id** `string` *required*
>
> The unique identifier for the file on Google Drive that you want to copy. This ID can be retrieved from the file's shareable link or via other Google Drive API calls. Pass only the raw ID, not a full URL. Name-based searches may return multiple files — confirm the correct `file_id` before calling.
>
> **new\_title** `string`
>
> The title to assign to the new copy of the file. If not provided, the copied file will have the same title as the original, prefixed with 'Copy of '.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Copy file with advanced options
>
> **Slug:** `GOOGLEDRIVE_COPY_FILE_ADVANCED`
>
> Creates a copy of a file and applies any requested updates with patch semantics. Use when you need to duplicate a file with advanced options like label inclusion, visibility settings, or custom metadata.
>
> #### Input Parameters
>
> **alt** `string ("json" | "media" | "proto")`
>
> Data format for response.
>
> **key** `string`
>
> API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
>
> **name** `string`
>
> The name of the copied file. If not provided, the copied file will have the same name as the original, prefixed with 'Copy of '.
>
> **xgafv** `string ("1" | "2")`
>
> V1 error format options.
>
> **fields** `string`
>
> Selector specifying which fields to include in a partial response. Use comma-separated field paths.
>
> **fileId** `string` *required*
>
> The ID of the file to copy. This is the unique identifier for the file on Google Drive.
>
> **parents** `array`
>
> The IDs of the parent folders which contain the file. If not specified as part of a copy request, the file inherits any discoverable parents of the source file.
>
> **starred** `boolean`
>
> Whether the user has starred the file.
>
> **trashed** `boolean`
>
> Whether the file has been trashed.
>
> **callback** `string`
>
> JSONP callback parameter.
>
> **mimeType** `string`
>
> The MIME type of the file. Google Drive attempts to automatically detect an appropriate value from uploaded content, if no value is provided.
>
> **quotaUser** `string`
>
> Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
>
> **properties** `object`
>
> A collection of arbitrary key-value pairs which are visible to all apps. Entries with null values are cleared in update and copy requests.
>
> **uploadType** `string`
>
> Legacy upload protocol for media (e.g. 'media', 'multipart').
>
> **createdTime** `string`
>
> The time at which the file was created (RFC 3339 date-time).
>
> **description** `string`
>
> A short description of the copied file.
>
> **oauth\_token** `string`
>
> OAuth 2.0 token for the current user.
>
> **ocrLanguage** `string`
>
> A language hint for OCR processing during image import (ISO 639-1 code).
>
> **prettyPrint** `boolean`
>
> Returns response with indentations and line breaks for improved readability.
>
> **access\_token** `string`
>
> OAuth access token.
>
> **modifiedTime** `string`
>
> The last time the file was modified by anyone (RFC 3339 date-time). Note that setting modifiedTime will also update modifiedByMeTime for the user.
>
> **appProperties** `object`
>
> A collection of arbitrary key-value pairs which are private to the requesting app. Entries with null values are cleared in update and copy requests. These properties can only be retrieved using an authenticated request with an OAuth 2 client ID.
>
> **includeLabels** `string`
>
> A comma-separated list of IDs of labels to include in the labelInfo part of the response.
>
> **folderColorRgb** `string`
>
> The color for a folder or a shortcut to a folder as an RGB hex string. The supported colors are published in the folderColorPalette field of the About resource.
>
> **upload\_protocol** `string`
>
> Upload protocol for media (e.g. 'raw', 'multipart').
>
> **writersCanShare** `boolean`
>
> Whether users with only writer permission can modify the file's permissions. Not populated for items in shared drives.
>
> **supportsAllDrives** `boolean`
>
> Whether the requesting application supports both My Drives and shared drives.
>
> **supportsTeamDrives** `boolean`
>
> Deprecated: Use supportsAllDrives instead.
>
> **enforceSingleParent** `boolean`
>
> Deprecated. Copying files into multiple folders is no longer supported. Use shortcuts instead.
>
> **keepRevisionForever** `boolean`
>
> 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 the file can be kept forever. If the limit is reached, try deleting pinned revisions.
>
> **ignoreDefaultVisibility** `boolean`
>
> Whether to ignore the domain's default visibility settings for the created file. Domain administrators can choose to make all uploaded files visible to the domain by default; this parameter bypasses that behavior for the request. Permissions are still inherited from parent folders.
>
> **includePermissionsForView** `string`
>
> Specifies which additional view's permissions to include in the response. Only 'published' is supported.
>
> **copyRequiresWriterPermission** `boolean`
>
> Whether the options to copy, print, or download this file should be disabled for readers and commenters.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Comment
>
> **Slug:** `GOOGLEDRIVE_CREATE_COMMENT`
>
> Tool to create a comment on a file in Google Drive. Returns a nested `data` object; extract `data.id` for the resulting comment identifier. Omit `anchor` and `quoted_file_content_*` for general file-level comments.
>
> #### Input Parameters
>
> **anchor** `string`
>
> A JSON string defining the region of the document to which the comment is anchored. Format: \{"region": \{"kind": "drive#commentRegion", "\<classifier>": \<value>, "rev": "head"}}. Supported classifiers: (1) "line" for text lines (e.g., "line": 12), (2) "page" for page numbers (e.g., "page": \{"p": 0}), (3) "txt" for text ranges (e.g., "txt": \{"o": 100, "l": 50}), (4) "rect" for rectangles in images (e.g., "rect": \{"x": 10, "y": 20, "w": 100, "h": 50}), (5) "time" for video timestamps (e.g., "time": \{"t": "00:01:30"}), (6) "matrix" for spreadsheet cells (e.g., "matrix": \{"c": 2, "r": 5}). Note: On blob files, only unanchored comments are supported. Google Workspace editors may treat API-set anchors as unanchored.
>
> **content** `string` *required*
>
> The plain text content of the comment.
>
> **file\_id** `string` *required*
>
> The ID of the file. The `id` field from GOOGLEDOCS\_SEARCH\_DOCUMENTS results can be used directly without conversion.
>
> **quoted\_file\_content\_value** `string`
>
> The quoted content itself.
>
> **quoted\_file\_content\_mime\_type** `string`
>
> The MIME type of the quoted content.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Shared Drive
>
> **Slug:** `GOOGLEDRIVE_CREATE_DRIVE`
>
> Creates a Google shared drive for collaboration or storage. When reusing a request ID, an existing drive returned is not guaranteed to be the drive originally created with that ID.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> The name of this shared drive.
>
> **hidden** `boolean`
>
> Whether the shared drive is hidden from default view.
>
> **themeId** `string`
>
> The ID of the theme from which the background image and color will be set. The set of possible driveThemes can be retrieved from a drive.about.get response. When not specified on a drive.drives.create request, a random theme is chosen from which the background image and color are set. This is a write-only field; it can only be set on requests that don't set colorRgb or backgroundImageFile.
>
> **colorRgb** `string`
>
> The color of this shared drive as an RGB hex string. It can only be set on a drive.drives.update request that does not set themeId.
>
> **requestId** `string`
>
> Optional. An ID for idempotent creation of a shared drive. If not provided, a UUID will be auto-generated. Each requestId can only be used ONCE to successfully create a drive. If retrying a request that succeeded previously with the same requestId, the existing drive will be returned.
>
> **backgroundImageFile** `object`
>
> An image file and cropping parameters from which a background image for this shared drive is set. This is a write only field; it can only be set on drive.drives.update requests that don't set themeId. When specified, all fields of the backgroundImageFile must be set.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create File or Folder
>
> **Slug:** `GOOGLEDRIVE_CREATE_FILE`
>
> Creates a new file or folder in Google Drive. Supports both metadata-only creation (for folders and empty documents) and file upload with content. When file\_to\_upload is provided, uploads the actual file bytes; otherwise creates an empty file. Native Google file types (Docs, Sheets, Forms, etc.) and folders are created as empty shells when no content is provided; content must be added manually afterward. Newly created files are private by default — set sharing permissions afterward for collaboration. For shared-drive folders, use this tool with the target folder ID in `parents` rather than GOOGLEDRIVE\_CREATE\_FOLDER.
>
> #### Input Parameters
>
> **name** `string`
>
> The name of the file. While optional, providing a meaningful name is strongly recommended. If not specified, Google Drive will create the file with name 'Untitled'.
>
> **fields** `string`
>
> A comma-separated list of fields to include in the response.
>
> **parents** `array`
>
> Google Drive folder ID (not folder name) where the file will be created. Must be a list with exactly one folder ID (e.g., \['1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs07X8ygaR']). Folder IDs are long alphanumeric strings, not human-readable names. Use GOOGLEDRIVE\_FIND\_FOLDER or GOOGLEDRIVE\_LIST\_FILES to look up folder IDs by name. If omitted, the file is created in My Drive root.
>
> **starred** `boolean`
>
> Whether the user has starred the file.
>
> **mimeType** `string ("application/vnd.google-apps.folder" | "application/vnd.google-apps.document" | "application/vnd.google-apps.spreadsheet" | "application/vnd.google-apps.presentation" | "application/vnd.google-apps.drawing" | "application/vnd.google-apps.form" | "application/vnd.google-apps.script" | "application/vnd.google-apps.shortcut" | "application/vnd.google-apps.site" | "application/vnd.google-apps.map" | "application/vnd.google-apps.jam" | "application/pdf" | "application/vnd.openxmlformats-officedocument.wordprocessingml.document" | "application/vnd.oasis.opendocument.text" | "application/rtf" | "text/plain" | "text/html" | "text/markdown" | "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" | "application/vnd.oasis.opendocument.spreadsheet" | "text/csv" | "text/tab-separated-values" | "application/vnd.openxmlformats-officedocument.presentationml.presentation" | "application/vnd.oasis.opendocument.presentation" | "image/jpeg" | "image/png" | "image/gif" | "image/bmp" | "image/webp" | "image/svg+xml" | "image/tiff" | "video/mp4" | "video/x-msvideo" | "video/quicktime" | "video/x-ms-wmv" | "video/webm" | "audio/mpeg" | "audio/wav" | "audio/ogg" | "application/zip" | "application/vnd.rar" | "application/x-tar" | "application/gzip" | "application/x-7z-compressed" | "application/json" | "application/xml" | "application/x-yaml" | "application/epub+zip" | "application/octet-stream")`
>
> Common MIME types for Google Drive file creation.
>
> **description** `string`
>
> A short description of the file.
>
> **file\_to\_upload** `object`
>
> Optional file content to upload. If provided, the file will be created with the actual content from this upload. If omitted, creates an empty file (for folders) or empty Google Workspace document. Use this when you need to upload actual file bytes (images, PDFs, documents, etc.).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create a File from Text
>
> **Slug:** `GOOGLEDRIVE_CREATE_FILE_FROM_TEXT`
>
> Creates a Google Drive file from text, with support for Google Workspace formats and an optional parent folder. Returns file metadata at the top level; files can inherit parent permissions, and shared-drive targets are not supported in all cases.
>
> #### Input Parameters
>
> **file\_name** `string` *required*
>
> Required. Desired name for the new file on Google Drive. Also accepts 'title' or 'name' as aliases.
>
> **mime\_type** `string`
>
> MIME type for the new file, determining how Google Drive interprets its content. Must exactly match the content type — a mismatched value (e.g., `text/plain` for HTML) breaks Drive previews and downstream conversion.
>
> **parent\_id** `string`
>
> IMPORTANT: Must be a valid Google Drive folder ID that exists and you have access to. Do NOT pass folder names - only folder IDs work. If omitted, the file is created in the root of 'My Drive'. To get a folder ID from a folder name, use GOOGLEDRIVE\_FIND\_FOLDER first. Also accepts 'folder\_id' or 'parent\_folder\_id' as aliases.
>
> **text\_content** `string` *required*
>
> Required. Plain text content to be written into the new file. Also accepts 'content', 'body', or 'text' as aliases. Only the documented aliases (`content`, `body`, `text`) are accepted; undocumented keys like `file_content` cause an 'Invalid request data' error. Must be UTF-8 encoded.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create a folder
>
> **Slug:** `GOOGLEDRIVE_CREATE_FOLDER`
>
> Creates a Google Drive folder, optionally inside an existing parent specified by ID or exact name. If multiple folders match a parent name, it uses the first match; use a parent ID to avoid ambiguity.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Name for the new folder. This is a required field.
>
> **parent\_id** `string`
>
> ID or exact name of an EXISTING parent folder. IMPORTANT: The parent folder MUST already exist - this action will NOT create parent folders automatically. If you need to create nested folders, first use GOOGLEDRIVE\_FIND\_FOLDER to verify the parent exists, or create it with a separate call. If a name is provided, the action searches for a folder with that exact name. If omitted, the folder is created in the Drive root. Must be non-trashed, accessible, and an actual folder (not a file) — shared drive root IDs are not valid. Use GOOGLEDRIVE\_FIND\_FOLDER to verify before calling.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Permission
>
> **Slug:** `GOOGLEDRIVE_CREATE_PERMISSION`
>
> Tool to create a permission for a file or shared drive. Use when you need to share a file or folder with users, groups, domains, or make it publicly accessible. **Warning:** Concurrent permissions operations on the same file are not supported; only the last update is applied.
>
> #### Input Parameters
>
> **role** `string ("owner" | "organizer" | "fileOrganizer" | "writer" | "commenter" | "reader")` *required*
>
> The role granted by this permission. Valid values are: owner, organizer, fileOrganizer, writer, commenter, reader.
>
> **type** `string ("user" | "group" | "domain" | "anyone")` *required*
>
> The type of the grantee. When creating a permission, if type is 'user' or 'group', you must provide an emailAddress. When type is 'domain', you must provide a domain. There isn't extra information required for 'anyone' type.
>
> **domain** `string`
>
> The domain to which this permission refers. Required when type is 'domain'.
>
> **file\_id** `string` *required*
>
> The ID of the file or shared drive.
>
> **email\_address** `string`
>
> The email address of the user or group to which this permission refers. Required when type is 'user' or 'group'.
>
> **email\_message** `string`
>
> A plain text custom message to include in the notification email.
>
> **expiration\_time** `string`
>
> The time at which this permission will expire (RFC 3339 date-time). Expiration times can only be set on user and group permissions, must be in the future, and cannot be more than a year in the future.
>
> **transfer\_ownership** `boolean`
>
> Whether to transfer ownership to the specified user and downgrade the current owner to a writer. This parameter is required as an acknowledgement of the side effect.
>
> **supports\_all\_drives** `boolean`
>
> Whether the requesting application supports both My Drives and shared drives.
>
> **allow\_file\_discovery** `boolean`
>
> Whether the permission allows the file to be discovered through search. This is only applicable for permissions of type 'domain' or 'anyone'.
>
> **move\_to\_new\_owners\_root** `boolean`
>
> This parameter will only take effect if the item is not in a shared drive and the request is attempting to transfer the ownership of the item. If set to true, the item will be moved to the new owner's My Drive root folder and all prior parents removed. If set to false, parents are not changed.
>
> **send\_notification\_email** `boolean`
>
> Whether to send a notification email when sharing to users or groups. This defaults to true for users and groups, and is not allowed for other requests. It must not be disabled for ownership transfers.
>
> **use\_domain\_admin\_access** `boolean`
>
> Issue the request as a domain administrator; if set to true, then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Permissions Batch
>
> **Slug:** `GOOGLEDRIVE_CREATE_PERMISSIONS_BATCH`
>
> Creates multiple permissions for files or shared drives in a single batch request. Use this action when you need to share multiple files with users, or share a single file with multiple users or groups simultaneously. Each permission in the batch can target a different file and specify different access levels. Batch operations are more efficient than creating permissions individually, with a maximum of 100 permissions per batch.
>
> #### Input Parameters
>
> **permissions** `array` *required*
>
> A list of permissions to create. Each permission specifies the file\_id, type, role, and other details. Maximum 100 permissions per batch request.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Reply
>
> **Slug:** `GOOGLEDRIVE_CREATE_REPLY`
>
> Create a plain-text reply to a comment on a Google Drive file, optionally resolving or reopening the parent comment.
>
> #### Input Parameters
>
> **action** `string ("resolve" | "reopen")`
>
> The action the reply performed to the parent comment.
>
> **fields** `string`
>
> Selector specifying which fields to include in a partial response.
>
> **content** `string` *required*
>
> The plain text content of the reply. HTML content is not supported.
>
> **file\_id** `string` *required*
>
> The ID of the file.
>
> **comment\_id** `string` *required*
>
> The ID of the comment.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Shortcut to File/Folder
>
> **Slug:** `GOOGLEDRIVE_CREATE_SHORTCUT_TO_FILE`
>
> Tool to create a shortcut to a file or folder in Google Drive. Use when you need to link to an existing Drive item from another location without duplicating it. The shortcut receives its own distinct file ID (capture from response). No parent folder parameter exists; use GOOGLEDRIVE\_MOVE\_FILE after creation to place the shortcut in the desired location.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> The name of the shortcut.
>
> **target\_id** `string` *required*
>
> The ID of the file or folder that this shortcut points to.
>
> **includeLabels** `string`
>
> A comma-separated list of IDs of labels to include in the labelInfo part of the response.
>
> **supportsAllDrives** `boolean`
>
> Whether the requesting application supports both My Drives and shared drives. Recommended to set to true if interacting with shared drives.
>
> **keepRevisionForever** `boolean`
>
> Whether to set the 'keepForever' field in the new head revision.
>
> **ignoreDefaultVisibility** `boolean`
>
> Whether to ignore the domain's default visibility settings for the created file.
>
> **includePermissionsForView** `string ("published")`
>
> Enum for includePermissionsForView parameter.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Team Drive (Deprecated)
>
> **Slug:** `GOOGLEDRIVE_CREATE_TEAM_DRIVE`
>
> Tool to create a Team Drive. Deprecated: Use drives.create instead. Use when you need to create a Team Drive for collaboration.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> The name of this Team Drive. This is a required field.
>
> **themeId** `string`
>
> The ID of the theme from which the background image and color will be set. The set of possible teamDriveThemes can be retrieved from a drive.about.get response. When not specified on a drive.teamdrives.create request, a random theme is chosen from which the background image and color are set. This is a write-only field; it can only be set on requests that don't set colorRgb or backgroundImageFile.
>
> **colorRgb** `string`
>
> The color of this Team Drive as an RGB hex string. It can only be set on a drive.teamdrives.update request that does not set themeId.
>
> **requestId** `string`
>
> Optional. An ID for idempotent creation of a Team Drive. If not provided, a UUID will be auto-generated. Each requestId can only be used ONCE to successfully create a Team Drive. If retrying a request that succeeded previously with the same requestId, the existing Team Drive will be returned or a 409 error will occur.
>
> **backgroundImageFile** `object`
>
> An image file and cropping parameters from which a background image for this Team Drive is set. This is a write only field; it can only be set on drive.teamdrives.update requests that don't set themeId. When specified, all fields of the backgroundImageFile must be set.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Child (v2)
>
> **Slug:** `GOOGLEDRIVE_DELETE_CHILD`
>
> Tool to remove a child from a folder using Google Drive API v2. Use when you need to remove a file from a specific folder.
>
> #### Input Parameters
>
> **alt** `string ("json" | "media" | "proto")`
>
> Data format for response.
>
> **key** `string`
>
> API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
>
> **xgafv** `string ("1" | "2")`
>
> V1 error format enum.
>
> **fields** `string`
>
> Selector specifying which fields to include in a partial response.
>
> **childId** `string` *required*
>
> The ID of the child.
>
> **callback** `string`
>
> JSONP
>
> **folderId** `string` *required*
>
> The ID of the folder.
>
> **quotaUser** `string`
>
> Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
>
> **uploadType** `string`
>
> Legacy upload protocol for media (e.g. "media", "multipart").
>
> **oauth\_token** `string`
>
> OAuth 2.0 token for the current user.
>
> **prettyPrint** `boolean`
>
> Returns response with indentations and line breaks.
>
> **access\_token** `string`
>
> OAuth access token.
>
> **upload\_protocol** `string`
>
> Upload protocol for media (e.g. "raw", "multipart").
>
> **enforceSingleParent** `boolean`
>
> Deprecated: If an item is not in a shared drive and its last parent is removed, the item is placed under its owner's root.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Comment
>
> **Slug:** `GOOGLEDRIVE_DELETE_COMMENT`
>
> Permanently deletes a comment thread (and all its replies) from a Google Drive file — this action is irreversible. To remove only a single reply within a thread, use GOOGLEDRIVE\_DELETE\_REPLY instead. Verify the exact comment content and comment\_id before calling.
>
> #### Input Parameters
>
> **file\_id** `string` *required*
>
> The ID of the file.
>
> **comment\_id** `string` *required*
>
> The ID of the comment. Comment IDs are different from file IDs and have a distinct format (e.g., 'AAAByC37kko'). You must obtain the comment ID from the LIST\_COMMENTS or CREATE\_COMMENT actions. Do NOT use the file ID here.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Shared Drive
>
> **Slug:** `GOOGLEDRIVE_DELETE_DRIVE`
>
> Tool to permanently delete a shared drive. Use when you need to remove a shared drive and its contents (if specified).
>
> #### Input Parameters
>
> **driveId** `string` *required*
>
> The ID of the shared drive.
>
> **allowItemDeletion** `boolean`
>
> Whether any items inside the shared drive should also be deleted. This option is only supported when `useDomainAdminAccess` is also set to `true`.
>
> **useDomainAdminAccess** `boolean`
>
> Issue the request as a domain administrator; if set to true, then the requester will be granted access if they are an administrator of the domain to which the shared drive belongs.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete file
>
> **Slug:** `GOOGLEDRIVE_DELETE_FILE`
>
> DEPRECATED: Use GOOGLEDRIVE\_GOOGLE\_DRIVE\_DELETE\_FOLDER\_OR\_FILE\_ACTION instead. Tool to permanently delete a file owned by the user without moving it to trash. Use when permanent deletion is required. If the file belongs to a shared drive, the user must be an organizer on the parent folder.
>
> #### Input Parameters
>
> **fileId** `string` *required*
>
> The ID of the file to delete. This permanently removes the file without moving it to trash.
>
> **supportsAllDrives** `boolean`
>
> Whether the requesting application supports both My Drives and shared drives. Set to true if the file might be in a shared drive.
>
> **enforceSingleParent** `boolean`
>
> Deprecated parameter. If an item is not in a shared drive and its last parent is deleted but the item itself is not, the item is placed under its owner's root.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Parent (v2)
>
> **Slug:** `GOOGLEDRIVE_DELETE_PARENT`
>
> Tool to remove a parent from a file using Google Drive API v2. Use when you need to remove a file from a specific folder.
>
> #### Input Parameters
>
> **alt** `string ("json" | "media" | "proto")`
>
> Data format for response.
>
> **key** `string`
>
> API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
>
> **xgafv** `string ("1" | "2")`
>
> V1 error format enum.
>
> **fields** `string`
>
> Selector specifying which fields to include in a partial response.
>
> **fileId** `string` *required*
>
> The ID of the file.
>
> **callback** `string`
>
> JSONP
>
> **parentId** `string` *required*
>
> The ID of the parent.
>
> **quotaUser** `string`
>
> Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
>
> **uploadType** `string`
>
> Legacy upload protocol for media (e.g. "media", "multipart").
>
> **oauth\_token** `string`
>
> OAuth 2.0 token for the current user.
>
> **prettyPrint** `boolean`
>
> Returns response with indentations and line breaks.
>
> **access\_token** `string`
>
> OAuth access token.
>
> **upload\_protocol** `string`
>
> Upload protocol for media (e.g. "raw", "multipart").
>
> **enforceSingleParent** `boolean`
>
> Deprecated: If an item is not in a shared drive and its last parent is removed, the item is placed under its owner's root.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Permission
>
> **Slug:** `GOOGLEDRIVE_DELETE_PERMISSION`
>
> Deletes a specified permission from a file or shared drive by permission ID; deleting other permissions does not remove an existing public-access permission. Check the returned success flag: an owner permission that cannot be removed returns success=false.
>
> #### Input Parameters
>
> **file\_id** `string` *required*
>
> The ID of the file or shared drive.
>
> **permission\_id** `string` *required*
>
> The unique ID of the permission to delete. IMPORTANT: You MUST first call GOOGLEDRIVE\_LIST\_PERMISSIONS with the file\_id to retrieve valid permission IDs. Permission IDs are opaque identifiers assigned by Google (e.g., '18394857362947583', 'anyoneWithLink') and cannot be guessed. Do NOT use placeholder values like 'any' or '1234'.
>
> **supportsAllDrives** `boolean`
>
> Whether the requesting application supports both My Drives and shared drives.
>
> **useDomainAdminAccess** `boolean`
>
> Issue the request as a domain administrator; if set to true, then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Property (v2 API)
>
> **Slug:** `GOOGLEDRIVE_DELETE_PROPERTY`
>
> Delete a custom property from a Google Drive file using API v2. The property is selected by key and visibility; visibility defaults to private when omitted.
>
> #### Input Parameters
>
> **alt** `string ("json" | "media" | "proto")`
>
> Data format for response.
>
> **key** `string`
>
> API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
>
> **xgafv** `string ("1" | "2")`
>
> V1 error format values.
>
> **fields** `string`
>
> Selector specifying which fields to include in a partial response.
>
> **fileId** `string` *required*
>
> The ID of the file.
>
> **callback** `string`
>
> JSONP callback function name.
>
> **quotaUser** `string`
>
> Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
>
> **uploadType** `string`
>
> Legacy upload protocol for media (e.g. 'media', 'multipart').
>
> **visibility** `string`
>
> The visibility of the property. If specified, only deletes the property if it has this visibility level.
>
> **oauth\_token** `string`
>
> OAuth 2.0 token for the current user.
>
> **prettyPrint** `boolean`
>
> Returns response with indentations and line breaks.
>
> **propertyKey** `string` *required*
>
> The key of the property to delete.
>
> **access\_token** `string`
>
> OAuth access token.
>
> **upload\_protocol** `string`
>
> Upload protocol for media (e.g. 'raw', 'multipart').
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Reply
>
> **Slug:** `GOOGLEDRIVE_DELETE_REPLY`
>
> Tool to delete a specific reply by reply ID. Deletion is irreversible; obtain explicit user confirmation before calling. Removes only the targeted reply, not the full comment thread — use GOOGLEDRIVE\_DELETE\_COMMENT to remove the entire thread.
>
> #### Input Parameters
>
> **file\_id** `string` *required*
>
> The ID of the file.
>
> **reply\_id** `string` *required*
>
> The ID of the reply. Confirm correct target using createdTime and author alongside reply\_id, as multiple similar replies may exist on the same comment.
>
> **comment\_id** `string` *required*
>
> The ID of the comment.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Revision
>
> **Slug:** `GOOGLEDRIVE_DELETE_REVISION`
>
> Tool to permanently delete a file revision. Use when you need to remove a specific version of a binary file (images, videos, etc.). Cannot delete revisions for Google Docs/Sheets or the last remaining revision.
>
> #### Input Parameters
>
> **file\_id** `string` *required*
>
> The ID of the file.
>
> **revision\_id** `string` *required*
>
> The ID of the revision to delete. You can obtain revision IDs by calling GOOGLEDRIVE\_LIST\_REVISIONS. Important: You can only delete revisions for files with binary content (images, videos, etc.), not Google Docs or Sheets. You cannot delete the last remaining revision of a file.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Team Drive (Deprecated)
>
> **Slug:** `GOOGLEDRIVE_DELETE_TEAM_DRIVE`
>
> Tool to permanently delete a Team Drive. Deprecated: Use drives.delete instead. Use when you need to remove a Team Drive using the legacy endpoint.
>
> #### Input Parameters
>
> **teamDriveId** `string` *required*
>
> The ID of the Team Drive to delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Download a file from Google Drive
>
> **Slug:** `GOOGLEDRIVE_DOWNLOAD_FILE`
>
> Downloads a Drive file's content and returns it in `downloaded_file_content`. For native blob files such as PDFs, images, videos, and Office files, it returns the original bytes without conversion; leave `mime_type` unset. For Google Workspace documents, it exports the content and `mime_type` optionally selects the export format.
>
> #### Input Parameters
>
> **fileId** `string` *required*
>
> The unique identifier of the file to be downloaded from Google Drive. Must be a valid Google Drive file ID containing only alphanumeric characters, hyphens, and underscores. File paths with slashes (/) are not valid. This ID can typically be found in the file's URL in Google Drive or obtained from API calls that list files.
>
> **mime\_type** `string ("application/vnd.openxmlformats-officedocument.wordprocessingml.document" | "application/vnd.oasis.opendocument.text" | "application/rtf" | "application/pdf" | "text/plain" | "application/zip" | "application/epub+zip" | "text/html" | "text/markdown" | "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" | "application/vnd.oasis.opendocument.spreadsheet" | "text/csv" | "text/tab-separated-values" | "application/vnd.openxmlformats-officedocument.presentationml.presentation" | "application/vnd.oasis.opendocument.presentation" | "image/jpeg" | "image/png" | "image/svg+xml" | "application/vnd.google-apps.script+json" | "application/vnd.google-apps.vid")`
>
> ONLY for Google Workspace documents (Docs, Sheets, Slides, Drawings). Specifies the export format. Has NO effect on regular files (PDFs, images, videos, Office documents, etc.) - they are always downloaded in their native format. Google Forms and Maps cannot be downloaded as they do not support exports through the Drive API. If omitted for Google Workspace files, defaults to PDF. Different Workspace types support different formats. Use application/pdf for universal compatibility.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Download file content (Deprecated)
>
> **Slug:** `GOOGLEDRIVE_DOWNLOAD_FILE2`
>
> DEPRECATED: Use GOOGLEDRIVE\_DOWNLOAD\_FILE\_OPERATION instead. Tool to download file content as a long-running operation. Use when you need to download files from Google Drive. Operations are valid for 24 hours from the time of creation.
>
> #### Input Parameters
>
> **file\_id** `string` *required*
>
> The ID of the file to download
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Download file via operation
>
> **Slug:** `GOOGLEDRIVE_DOWNLOAD_FILE_OPERATION`
>
> Starts a long-running operation to download a Drive file, including Google Vids files, or export supported Google Workspace documents. Returns operation status and metadata; operations are valid for 24 hours from creation.
>
> #### Input Parameters
>
> **file\_id** `string` *required*
>
> The ID of the file to download. This is a required parameter. The file\_id can be found in the file's Google Drive URL or obtained from API calls that list files.
>
> **mime\_type** `string`
>
> The MIME type for exporting Google Workspace documents (Google Docs, Sheets, Slides, etc.) to different formats. Only applicable to Google Workspace documents (not blob files like PDFs, images, videos). If provided for a non-Google Workspace file, this parameter will be ignored to prevent API errors. Common export formats: 'application/pdf', 'application/vnd.openxmlformats-officedocument.wordprocessingml.document' (Word), 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' (Excel).
>
> **revision\_id** `string`
>
> The ID of the revision to download. If not specified, the current head revision will be downloaded. This field can only be set when downloading blob files, Google Docs, and Google Sheets.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Download File Revision
>
> **Slug:** `GOOGLEDRIVE_DOWNLOAD_FILE_REVISION`
>
> Download the stored bytes of one blob-file revision. This action does not export Google Docs, Sheets, Slides, or other Workspace revisions. Use GOOGLEDRIVE\_GET\_REVISION to retrieve a Workspace revision's exportLinks, then download the selected export URL separately.
>
> #### Input Parameters
>
> **file\_id** `string` *required*
>
> The ID of the blob file whose revision will be downloaded.
>
> **file\_name** `string`
>
> Optional name for the downloaded file. Unsafe path and filesystem characters are replaced. Defaults to a name derived from the file and revision IDs.
>
> **revision\_id** `string` *required*
>
> The ID of the blob-file revision to download, obtained from a revisions list or metadata response.
>
> **acknowledge\_abuse** `boolean`
>
> Set explicitly to true only when the file owner or shared-drive organizer accepts the risk of downloading a file Google has flagged as abusive.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Edit File
>
> **Slug:** `GOOGLEDRIVE_EDIT_FILE`
>
> Replaces the entire content of an existing Google Drive binary file with UTF-8 text while retaining its file ID. Google Docs, Sheets, Slides, and other checked Workspace file types are not supported.
>
> #### Input Parameters
>
> **content** `string` *required*
>
> New textual content to overwrite the existing file; will be UTF-8 encoded for upload. Overwrites the entire file body — partial edits are not possible, so reconstruct the full desired content before calling. Back up with GOOGLEDRIVE\_COPY\_FILE before irreversible edits.
>
> **file\_id** `string` *required*
>
> ID of the Google Drive file to update. Only works with files that have binary content (e.g., .txt, .json, .pdf, .jpg files uploaded to Drive). Does NOT support Google Workspace native files (Docs, Sheets, Slides) even if they appear as spreadsheets or documents - those must be edited via Google Docs/Sheets/Slides APIs. Use GOOGLEDRIVE\_FIND\_FILE to retrieve an existing file's ID; using an upload action instead would create a duplicate with a different ID.
>
> **mime\_type** `string`
>
> MIME type of the content being uploaded. Must match the actual format of the content being uploaded (not the existing file type). Cannot be a Google Workspace MIME type (application/vnd.google-apps.\*). Valid examples: text/plain, text/html, application/json, application/pdf, image/jpeg.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Empty Trash
>
> **Slug:** `GOOGLEDRIVE_EMPTY_TRASH`
>
> Tool to permanently and irreversibly delete ALL trashed files in the user's Google Drive or a specified shared drive. Recovery is impossible after execution — no Drive tool can restore items once trash is emptied. Affects every item in trash across the entire account or shared drive, not just files from the current workflow. Always obtain explicit user confirmation and clarify that recovery is impossible before executing. Provide driveId to target a specific shared drive's trash; omit to empty the user's root trash.
>
> #### Input Parameters
>
> **driveId** `string`
>
> If set, empties the trash of the provided shared drive. This parameter is ignored if the item is not in a shared drive.
>
> **enforceSingleParent** `boolean`
>
> Deprecated: If an item is not in a shared drive and its last parent is deleted but the item itself is not, the item will be placed under its owner's root. This parameter is ignored if the item is not in a shared drive.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Export Google Workspace file
>
> **Slug:** `GOOGLEDRIVE_EXPORT_GOOGLE_WORKSPACE_FILE`
>
> Exports a Google Workspace document to the requested MIME type and returns exported file content. Use when you need to export Google Docs, Sheets, Slides, Drawings, or Apps Script files to a specific format. Note: The exported content is limited to 10MB by Google Drive API.
>
> #### Input Parameters
>
> **fileId** `string` *required*
>
> The ID of the Google Workspace file to export. Must be a valid file ID for a Google Docs, Sheets, Slides, Drawings, or Apps Script file.
>
> **mimeType** `string ("application/vnd.openxmlformats-officedocument.wordprocessingml.document" | "application/vnd.oasis.opendocument.text" | "application/rtf" | "application/pdf" | "text/plain" | "application/zip" | "application/epub+zip" | "text/markdown" | "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" | "application/vnd.oasis.opendocument.spreadsheet" | "text/csv" | "text/tab-separated-values" | "application/vnd.openxmlformats-officedocument.presentationml.presentation" | "application/vnd.oasis.opendocument.presentation" | "image/jpeg" | "image/png" | "image/svg+xml" | "application/vnd.google-apps.script+json")` *required*
>
> The MIME type of the format requested for this export. Supported formats depend on the source file type: Google Docs -> DOCX, ODT, RTF, PDF, TXT, HTML (ZIP), EPUB, Markdown; Google Sheets -> XLSX, ODS, PDF, CSV, TSV, HTML (ZIP); Google Slides -> PPTX, ODP, PDF, TXT, JPG, PNG, SVG; Google Drawings -> PDF, JPG, PNG, SVG; Apps Script -> JSON.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Find file
>
> **Slug:** `GOOGLEDRIVE_FIND_FILE`
>
> The comprehensive Google Drive search tool that handles all file and folder discovery needs. Use this for any file finding task - from simple name searches to complex queries with date filters, MIME types, permissions, custom properties, folder scoping, and more. Searches across My Drive and shared drives with full metadata support. Examples: - Find PDFs: q="mimeType = 'application/pdf'" - Find recent files: q="modifiedTime > '2024-01-01T00:00:00'" - Search by name: q="name contains 'report'" - Files in folder: folderId="abc123" or q="'FOLDER\_ID' in parents"
>
> #### Input Parameters
>
> **q** `string`
>
> Query string to filter file results. Accepts both simple text searches and full Google Drive query syntax.          **Simple Text Search:** Bare text (e.g., "SAM RFP") is auto-converted to fullText search. Bare email addresses are auto-converted to owner search.          **Full Query Syntax:** 'field operator value' combined with 'and', 'or', 'not'          **Operators:** =, !=, \<, >, \<=, >=, contains, in          **Common Fields:**         - `name` - File name (exact match with = or partial match with contains)         - `fullText` - File content search         - `mimeType` - File type (e.g., 'application/pdf', 'application/vnd.google-apps.folder')         - `modifiedTime`, `createdTime` - Dates (RFC 3339: '2024-01-01T00:00:00')         - `parents` - Folder IDs containing the file         - `owners`, `writers` - User email addresses (MUST use 'in' operator, NOT colon syntax)         - `properties`, `appProperties` - Custom metadata          **Boolean Filter Fields (sharedWithMe, trashed, starred):**         These fields require explicit `= true` or `= false` syntax:         - `sharedWithMe = true` - Find files shared with you by others         - `sharedWithMe = false` - Find files NOT shared with you (your own files)         - `trashed = true` - Find files in trash         - `trashed = false` - Exclude trashed files from results         - `starred = true` - Find starred/favorited files         - `starred = false` - Find non-starred files          Combine with other conditions using 'and':         - "sharedWithMe = true and name contains 'report'" - Find shared files with 'report' in name         - "sharedWithMe = true and mimeType = 'application/pdf'" - Find shared PDF files         - "starred = true and modifiedTime > '2024-01-01T00:00:00'" - Find recently modified starred files          **Query Complexity Limits:**         Queries with many OR clauses (typically >5-10) may fail with 'The query is too complex' error.          **Name Field Usage:**         Wildcards (\*) are NOT supported. Use 'contains' operator for partial matching.          **User Email Searches:**         - CORRECT: "'[user@example.com](mailto:user@example.com)' in owners" or "'[user@example.com](mailto:user@example.com)' in writers" or "'[user@example.com](mailto:user@example.com)' in readers"         - INCORRECT: "owner:[user@example.com](mailto:user@example.com)" (colon syntax is NOT supported and will cause errors)         - Always use the 'in' operator with quoted email addresses for user-based searches          **Special Syntax:**         - Dates: RFC 3339 format (time zone defaults to UTC)         - Apostrophes/quotes in values: Automatically escaped. You can write "name = 'Jan'26'" or "name = 'Valentine's Day'" without manual escaping.         - Grouping: Use parentheses for OR: "(mimeType contains 'image/' or mimeType contains 'video/')"         - Custom properties: "properties has \{ key='department' and value='sales' }"          **IMPORTANT - Root Folder ('My Drive'):**         'My Drive' is NOT a searchable folder name. To work with the root folder, use the 'root' alias: folder\_id='root' or "'root' in parents" in your query.
>
> **fields** `string`
>
> Selector specifying which fields to include in a partial response. Use '\*' for all fields.  **Default Behavior (Recommended for Discovery):** When omitted, returns essential file discovery fields: id, name, mimeType, size, modifiedTime, createdTime, parents, webViewLink, trashed, starred. This lightweight default is optimized for file search/discovery use cases without verbose permission or capability metadata.  **Format:** For file fields, use 'files(field1,field2,...)' format. For example: 'files(id,name,mimeType)'. Top-level response fields (kind, nextPageToken, incompleteSearch) can be used directly.  **Note:** Bare field names like 'id,name,mimeType' will be automatically wrapped in 'files()' for convenience. The 'editors' field is not valid in Drive API v3; use 'permissions' instead for access control information.
>
> **spaces** `string`
>
> A comma-separated list of spaces to query. Supported values are 'drive', 'appDataFolder' and 'photos'.
>
> **corpora** `string ("user" | "drive" | "domain" | "allDrives")`
>
> Specifies which collections of files to search. Defaults to 'allDrives' (searches My Drive + all accessible shared drives).          **Values:**         - `user` - Search only user's personal My Drive         - `domain` - Search all files shared within Google Workspace domain         - `drive` - Search specific shared drive (requires 'driveId' parameter and 'includeItemsFromAllDrives' must be true)         - `allDrives` - Search My Drive + all accessible shared drives (DEFAULT, requires 'includeItemsFromAllDrives' to be true)          **When to Use:**         - Personal files only: Use 'user'         - Organization-wide: Use 'domain'         - Specific shared drive: Use 'drive' with 'driveId'         - Maximum coverage: Use 'allDrives' (auto-enables supportsAllDrives and includeItemsFromAllDrives)
>
> **driveId** `string`
>
> ID of the shared drive to search. When provided, 'corpora' will automatically be set to 'drive' (mutually exclusive with corpora='allDrives'). Required if 'corpora' is 'drive'.
>
> **orderBy** `string`
>
> Comma-separated sort keys. Ascending by default; add 'desc' for descending. Cannot be used when query (q) contains fullText search terms.          **Valid Keys:**         - `createdTime`, `modifiedTime`, `modifiedByMeTime` - Dates         - `viewedByMeTime`, `sharedWithMeTime` - Activity dates         - `name`, `name_natural` - File name (natural: file1, file2, file10)         - `folder` - Folder hierarchy         - `quotaBytesUsed` - Storage size (NOTE: 'size' is NOT valid, use 'quotaBytesUsed')         - `starred` - Starred status         - `recency` - Recent activity (combines view time and modification time for relevance-based sorting)          **Important:** 'size' is NOT a valid sort key. Use 'quotaBytesUsed' to sort by file size.          **Restriction:** Sorting is not supported when the query contains fullText searches (e.g., "fullText contains 'keyword'"). Omit orderBy when using fullText queries.
>
> **pageSize** `integer`
>
> The maximum number of files to return per page.
>
> **folder\_id** `string`
>
> ID of a specific folder to search within. This automatically adds "'folder\_id' in parents" to the query. Can be combined with the 'q' parameter to further filter results within the folder. Use 'root' to search within the user's root folder (My Drive). Note: 'My Drive' is not a searchable folder name - use 'root' alias instead.
>
> **pageToken** `string`
>
> The token for continuing a previous list request on the next page. IMPORTANT: This must be the exact opaque string from a previous response's 'nextPageToken' field - do not modify, truncate, URL-encode, or construct tokens manually. Invalid or corrupted tokens will result in API errors.
>
> **include\_labels** `string`
>
> A comma-separated list of label IDs to include in the `labelInfo` part of the response for each file. Empty strings are automatically treated as omitted.
>
> **pagetoken\_dropped** `boolean`
>
> Indicates whether the page token was dropped from the request.
>
> **supportsAllDrives** `boolean`
>
> Whether the requesting application supports both My Drives and shared drives. If 'includeItemsFromAllDrives' is true, this must also be true.
>
> **original\_email\_query** `string`
>
> The original email query before transformation.
>
> **editors\_field\_removed** `boolean`
>
> Indicates whether the editors field was removed from the request.
>
> **email\_query\_transformed** `boolean`
>
> Indicates whether an email query was transformed into a search filter.
>
> **orderby\_size\_transformed** `boolean`
>
> Indicates whether the orderBy size value was transformed.
>
> **original\_bare\_text\_query** `string`
>
> The original bare text query before transformation.
>
> **includeItemsFromAllDrives** `boolean`
>
> Whether both My Drive and shared drive items should be included in results. Must be true when corpora is 'drive' or 'allDrives'. If true, 'supportsAllDrives' should also be true.
>
> **emailaddress\_field\_removed** `boolean`
>
> Indicates whether the email address field was removed from the request.
>
> **original\_invalid\_pagetoken** `string`
>
> The original invalid page token that was dropped.
>
> **bare\_text\_query\_transformed** `boolean`
>
> Indicates whether a bare text query was transformed into a search filter.
>
> **include\_permissions\_for\_view** `string`
>
> Specifies which additional view's permissions to include in the response. Must be either omitted entirely or set to 'published'. Empty strings are automatically treated as omitted.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Find folder
>
> **Slug:** `GOOGLEDRIVE_FIND_FOLDER`
>
> Finds one page of Google Drive folders by name and optional parent. Use nextPageToken with page\_token to retrieve additional pages.
>
> #### Input Parameters
>
> **starred** `boolean`
>
> Set to true to search for folders that are starred, or false for those that are not.
>
> **page\_size** `integer`
>
> The maximum number of folders to return in this call (1-1000). This action returns one page per call; use the response's nextPageToken to retrieve additional pages.
>
> **name\_exact** `string`
>
> The exact name of the folder to search for as a string. This search is case-sensitive. Do not pass numbers - convert to string if needed.
>
> **page\_token** `string`
>
> Opaque token for the next page. Omit for the first page, then pass the previous response's nextPageToken unchanged to continue the same search.
>
> **name\_contains** `string`
>
> A substring to search for within folder names as a string. This search is case-insensitive.
>
> **modified\_after** `string`
>
> Search for folders modified after a specific date and time. The timestamp must be in RFC 3339 format (e.g., '2023-01-15T10:00:00Z' or '2023-01-15T10:00:00.000Z').
>
> **parent\_folder\_id** `string`
>
> The ID of the parent folder to search within. Only folders directly inside this parent folder will be returned. You can find parent folder IDs by first searching for the parent folder by name. Supports folders in both My Drive and Shared Drives.
>
> **name\_not\_contains** `string`
>
> A substring to exclude from folder names as a string. Folders with names containing this substring will not be returned. This search is case-insensitive.
>
> **full\_text\_contains** `string`
>
> A string to search for within the folder's name or description (NOT the content of files inside the folder). This search is case-insensitive. Note: Google Drive's fullText search on folders only matches the folder's own metadata, not files contained within.
>
> **full\_text\_not\_contains** `string`
>
> A string to exclude from the folder's name or description (NOT the content of files inside the folder). This search is case-insensitive. Note: Google Drive's fullText search on folders only matches the folder's own metadata, not files contained within.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Generate File IDs
>
> **Slug:** `GOOGLEDRIVE_GENERATE_IDS`
>
> Generates a set of file IDs which can be provided in create or copy requests. Use when you need to pre-allocate IDs for new files or copies.
>
> #### Input Parameters
>
> **type** `string`
>
> The type of items for which the IDs can be used. For example, 'files' or 'shortcuts'.
>
> **count** `integer`
>
> The number of IDs to return. Value must be between 1 and 1000, inclusive.
>
> **space** `string`
>
> The space in which the IDs can be used. Supported values are 'drive' and 'appDataFolder'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get about
>
> **Slug:** `GOOGLEDRIVE_GET_ABOUT`
>
> Tool to retrieve information about the user, the user's Drive, and system capabilities. Use when you need to check storage quotas, user details, or supported import/export formats. Note: storageQuota reflects My Drive (personal) storage only — it does not cover shared drives; use GOOGLEDRIVE\_LIST\_SHARED\_DRIVES and GOOGLEDRIVE\_GET\_DRIVE for shared drive quotas. A successful response confirms base Drive read access only; write access and shared drive access must be verified separately.
>
> #### Input Parameters
>
> **fields** `string`
>
> A comma-separated list of fields to include in the response. Use `*` to include all fields. Supported fields in Drive API v3: kind, user, storageQuota, importFormats, exportFormats, maxImportSizes, maxUploadSize, appInstalled, canCreateDrives, canCreateTeamDrives (deprecated), driveThemes, teamDriveThemes (deprecated), folderColorPalette. Note: rootFolderId was removed in v3 and is not supported. Note: storageQuota sub-fields (limit, usage, usageInDrive, usageInDriveTrash) are returned as strings representing bytes — convert to numeric types before arithmetic.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get App
>
> **Slug:** `GOOGLEDRIVE_GET_APP`
>
> Tool to get information about a specific Drive app by ID. Use 'self' as the app ID to get information about the calling app.
>
> #### Input Parameters
>
> **appId** `string` *required*
>
> The ID of the app. Use 'self' to refer to the calling app.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Change (v2 - Deprecated)
>
> **Slug:** `GOOGLEDRIVE_GET_CHANGE`
>
> Tool to get a specific change by ID from Google Drive v2 API. Deprecated: Use changes.getStartPageToken and changes.list to retrieve recent changes instead.
>
> #### Input Parameters
>
> **alt** `string ("json" | "media" | "proto")`
>
> Data format for response.
>
> **key** `string`
>
> API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
>
> **xgafv** `string ("1" | "2")`
>
> V1 error format.
>
> **fields** `string`
>
> Selector specifying which fields to include in a partial response.
>
> **driveId** `string`
>
> The shared drive from which the change will be returned.
>
> **callback** `string`
>
> JSONP
>
> **changeId** `string` *required*
>
> The ID of the change.
>
> **quotaUser** `string`
>
> Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
>
> **uploadType** `string`
>
> Legacy upload protocol for media (e.g. 'media', 'multipart').
>
> **oauth\_token** `string`
>
> OAuth 2.0 token for the current user.
>
> **prettyPrint** `boolean`
>
> Returns response with indentations and line breaks.
>
> **teamDriveId** `string`
>
> Deprecated: Use `driveId` instead.
>
> **access\_token** `string`
>
> OAuth access token.
>
> **upload\_protocol** `string`
>
> Upload protocol for media (e.g. 'raw', 'multipart').
>
> **supportsAllDrives** `boolean`
>
> Whether the requesting application supports both My Drives and shared drives.
>
> **supportsTeamDrives** `boolean`
>
> Deprecated: Use `supportsAllDrives` instead.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Changes Start Page Token
>
> **Slug:** `GOOGLEDRIVE_GET_CHANGES_START_PAGE_TOKEN`
>
> Tool to get the starting pageToken for listing future changes in Google Drive. Returns only a token — pass it to GOOGLEDRIVE\_LIST\_CHANGES to retrieve actual changes. Persist this token; losing it requires a full rescan. The token is forward-looking: GOOGLEDRIVE\_LIST\_CHANGES may return no results if no changes have occurred since issuance. For simple recent-file lookups, prefer GOOGLEDRIVE\_FIND\_FILE; use this tool only for incremental change-feed workflows.
>
> #### Input Parameters
>
> **driveId** `string`
>
> The ID of the shared drive for which the starting pageToken for listing future changes from that shared drive will be returned.
>
> **teamDriveId** `string`
>
> Deprecated: Use driveId instead.
>
> **supportsAllDrives** `boolean`
>
> Whether the requesting application supports both My Drives and shared drives. Defaults to false.
>
> **supportsTeamDrives** `boolean`
>
> Deprecated: Use supportsAllDrives instead.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Child Reference (v2)
>
> **Slug:** `GOOGLEDRIVE_GET_CHILD`
>
> Tool to get a specific child reference for a folder using Drive API v2. Use when you need to verify a specific file exists as a child of a folder.
>
> #### Input Parameters
>
> **alt** `string ("json" | "media" | "proto")`
>
> Data format for response.
>
> **key** `string`
>
> API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
>
> **xgafv** `string ("1" | "2")`
>
> V1 error format options.
>
> **fields** `string`
>
> Selector specifying which fields to include in a partial response.
>
> **childId** `string` *required*
>
> The ID of the child.
>
> **callback** `string`
>
> JSONP callback parameter.
>
> **folderId** `string` *required*
>
> The ID of the folder.
>
> **quotaUser** `string`
>
> Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
>
> **uploadType** `string`
>
> Legacy upload protocol for media (e.g. 'media', 'multipart').
>
> **oauth\_token** `string`
>
> OAuth 2.0 token for the current user.
>
> **prettyPrint** `boolean`
>
> Returns response with indentations and line breaks.
>
> **access\_token** `string`
>
> OAuth access token.
>
> **upload\_protocol** `string`
>
> Upload protocol for media (e.g. 'raw', 'multipart').
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Comment
>
> **Slug:** `GOOGLEDRIVE_GET_COMMENT`
>
> Tool to get a comment by ID. Use when you need to retrieve a specific comment from a Google Drive file and have both the file ID and comment ID.
>
> #### Input Parameters
>
> **fileId** `string` *required*
>
> The ID of the file.
>
> **commentId** `string` *required*
>
> The ID of the comment.
>
> **includeDeleted** `boolean`
>
> Whether to return deleted comments. Deleted comments will not include their original content.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Document
>
> **Slug:** `GOOGLEDRIVE_GET_DOCUMENT`
>
> Retrieve a native Google Docs document's structured content and metadata by ID.
>
> #### Input Parameters
>
> **document\_id** `string` *required*
>
> The unique ID of a native Google Docs document. Provide the ID itself, not a document title or URL.
>
> **include\_tabs\_content** `boolean`
>
> When true, return content for every tab under tabs. When false, return the first tab through legacy top-level fields such as body, headers, and footers.
>
> **suggestions\_view\_mode** `string ("DEFAULT_FOR_CURRENT_ACCESS" | "SUGGESTIONS_INLINE" | "PREVIEW_SUGGESTIONS_ACCEPTED" | "PREVIEW_WITHOUT_SUGGESTIONS")`
>
> How suggested changes are represented in the returned document.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Shared Drive
>
> **Slug:** `GOOGLEDRIVE_GET_DRIVE`
>
> Tool to get a shared drive by ID. Use when you need to retrieve information about a specific shared drive. To discover drive\_ids, use GOOGLEDRIVE\_LIST\_SHARED\_DRIVES first; GOOGLEDRIVE\_GET\_ABOUT reflects overall user storage, not individual shared drive details. Permission changes may have a brief propagation delay before appearing in results.
>
> #### Input Parameters
>
> **drive\_id** `string` *required*
>
> The ID of the shared drive.
>
> **use\_domain\_admin\_access** `boolean`
>
> Issue the request as a domain administrator; if set to true, then the requester will be granted access if they are an administrator of the domain to which the shared drive belongs.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get File Metadata
>
> **Slug:** `GOOGLEDRIVE_GET_FILE_METADATA`
>
> Gets a Drive file's metadata by ID, optionally returning only the metadata selected by `fields`. Use `fields` such as `id,name,mimeType,parents,modifiedTime` when a compact partial response is needed; omit it for Google's default metadata. This does not download file content: use GOOGLEDRIVE\_DOWNLOAD\_FILE for native bytes or exported Workspace content.
>
> #### Input Parameters
>
> **fields** `string`
>
> Comma-separated list of fields to include in the response. Use this for partial responses to request only specific metadata fields. Common fields: id, name, mimeType, webViewLink, webContentLink, createdTime, modifiedTime, size, quotaBytesUsed, parents, owners, permissions. Use '*' to return all available fields. Note: The deprecated v2 field 'alternateLink' is automatically migrated to 'webViewLink'. Example: 'id,name,mimeType,webViewLink,createdTime,modifiedTime'. Most fields (webViewLink, parents, owners, size, modifiedTime, etc.) are omitted by default — explicitly list required fields or use '*' (increases latency). `md5Checksum` is null for native Google Workspace files (Docs/Sheets/Slides); use `mimeType` to classify items — folders use `mimeType='application/vnd.google-apps.folder'` and Workspace files return `size=null`. `modifiedTime` is RFC 3339 UTC format.
>
> **fileId** `string` *required*
>
> The Google Drive file ID (an opaque alphanumeric string like '1a2b3c4d5e6f7g8h9i0j'), NOT a file name. If you only have a file name, use GOOGLEDRIVE\_FIND\_FILE or GOOGLEDRIVE\_LIST\_FILES to get the file ID first.
>
> **includeLabels** `string`
>
> A comma-separated list of IDs of labels to include in the labelInfo part of the response.
>
> **supportsAllDrives** `boolean`
>
> Whether the requesting application supports both My Drives and shared drives. Defaults to true to ensure files in shared drives are accessible.
>
> **includePermissionsForView** `string`
>
> Specifies which additional view's permissions to include in the response. Only 'published' is supported.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Property (v2)
>
> **Slug:** `GOOGLEDRIVE_GET_FILE_PROPERTY`
>
> Tool to get a property by its key using Google Drive API v2. Use when you need to retrieve a specific custom property attached to a file.
>
> #### Input Parameters
>
> **fileId** `string` *required*
>
> The ID of the file.
>
> **visibility** `string`
>
> The visibility of the property. Allowed values are PRIVATE (default) and PUBLIC. Private properties can only be retrieved using an authenticated request.
>
> **propertyKey** `string` *required*
>
> The key of the property.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get File (v2 API) (Deprecated)
>
> **Slug:** `GOOGLEDRIVE_GET_FILE_V2`
>
> Retrieves metadata for a Google Drive file by ID using the v2 API, optionally selecting fields for a partial response. DEPRECATED: Use GetFileMetadata instead. This action does not support returning file content as a media download.
>
> #### Input Parameters
>
> **alt** `string ("json" | "media" | "proto")`
>
> Data format for response.
>
> **key** `string`
>
> API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
>
> **xgafv** `string ("1" | "2")`
>
> V1 error format values.
>
> **fields** `string`
>
> Selector specifying which fields to include in a partial response.
>
> **fileId** `string` *required*
>
> The ID for the file in question. This is a required parameter and cannot be empty.
>
> **callback** `string`
>
> JSONP callback function name.
>
> **quotaUser** `string`
>
> Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
>
> **projection** `string ("BASIC" | "FULL")`
>
> Projection parameter values (deprecated).
>
> **revisionId** `string`
>
> Specifies the Revision ID that should be downloaded. Ignored unless alt=media is specified.
>
> **uploadType** `string`
>
> Legacy upload protocol for media (e.g. 'media', 'multipart').
>
> **oauth\_token** `string`
>
> OAuth 2.0 token for the current user.
>
> **prettyPrint** `boolean`
>
> Returns response with indentations and line breaks.
>
> **access\_token** `string`
>
> OAuth access token.
>
> **includeLabels** `string`
>
> A comma-separated list of IDs of labels to include in the labelInfo part of the response.
>
> **upload\_protocol** `string`
>
> Upload protocol for media (e.g. 'raw', 'multipart').
>
> **acknowledgeAbuse** `boolean`
>
> Whether the user is acknowledging the risk of downloading known malware or other abusive files.
>
> **updateViewedDate** `boolean`
>
> Deprecated: Use files.update with modifiedDateBehavior=noChange, updateViewedDate=true and an empty request body.
>
> **supportsAllDrives** `boolean`
>
> Whether the requesting application supports both My Drives and shared drives.
>
> **supportsTeamDrives** `boolean`
>
> Deprecated: Use supportsAllDrives instead.
>
> **includePermissionsForView** `string`
>
> Specifies which additional view's permissions to include in the response. Only 'published' is supported.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Google Form
>
> **Slug:** `GOOGLEDRIVE_GET_FORM`
>
> Retrieve a Google Form's definition, questions, settings, and publishing state by ID.
>
> #### Input Parameters
>
> **form\_id** `string` *required*
>
> The unique Google Form ID. In a Forms editor URL, this is the value after '/forms/d/'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Parent Reference (v2)
>
> **Slug:** `GOOGLEDRIVE_GET_PARENT`
>
> Tool to get a specific parent reference for a file using Drive API v2. Use when you need to retrieve information about a specific parent folder of a file.
>
> #### Input Parameters
>
> **alt** `string ("json" | "media" | "proto")`
>
> Data format for response.
>
> **key** `string`
>
> API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
>
> **xgafv** `string ("1" | "2")`
>
> V1 error format options.
>
> **fields** `string`
>
> Selector specifying which fields to include in a partial response.
>
> **fileId** `string` *required*
>
> The ID of the file.
>
> **callback** `string`
>
> JSONP callback parameter.
>
> **parentId** `string` *required*
>
> The ID of the parent.
>
> **quotaUser** `string`
>
> Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
>
> **uploadType** `string`
>
> Legacy upload protocol for media (e.g. 'media', 'multipart').
>
> **oauth\_token** `string`
>
> OAuth 2.0 token for the current user.
>
> **prettyPrint** `boolean`
>
> Returns response with indentations and line breaks.
>
> **access\_token** `string`
>
> OAuth access token.
>
> **upload\_protocol** `string`
>
> Upload protocol for media (e.g. 'raw', 'multipart').
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Permission
>
> **Slug:** `GOOGLEDRIVE_GET_PERMISSION`
>
> Gets a permission by ID. Use this tool to retrieve a specific permission for a file or shared drive. Newly created or updated permissions on shared drives may have a brief propagation delay before appearing.
>
> #### Input Parameters
>
> **fields** `string`
>
> Selector specifying which fields to include in a partial response. Use 'fields=\*' to return all available fields for the permission resource.
>
> **file\_id** `string` *required*
>
> The ID of the file.
>
> **permission\_id** `string` *required*
>
> The numeric ID of the permission. Note: The 'me' alias is NOT supported by the Google Drive permissions API. You must provide an actual numeric permission ID (e.g., '12345678901234567890'). Use the LIST\_PERMISSIONS action to get permission IDs for a file.
>
> **supports\_all\_drives** `boolean`
>
> Whether the requesting application supports both My Drives and shared drives.
>
> **use\_domain\_admin\_access** `boolean`
>
> Issue the request as a domain administrator; if set to true, then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Permission ID for Email
>
> **Slug:** `GOOGLEDRIVE_GET_PERMISSION_ID_FOR_EMAIL`
>
> Tool to get the permission ID for an email address using the Drive API v2. Use when you need to convert an email address to its corresponding permission ID.
>
> #### Input Parameters
>
> **alt** `string ("json" | "media" | "proto")`
>
> Data format for response.
>
> **key** `string`
>
> API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
>
> **email** `string` *required*
>
> The email address for which to return a permission ID
>
> **xgafv** `string ("1" | "2")`
>
> V1 error format options.
>
> **fields** `string`
>
> Selector specifying which fields to include in a partial response.
>
> **callback** `string`
>
> JSONP callback parameter.
>
> **quotaUser** `string`
>
> Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
>
> **uploadType** `string`
>
> Legacy upload protocol for media (e.g. 'media', 'multipart').
>
> **oauth\_token** `string`
>
> OAuth 2.0 token for the current user.
>
> **prettyPrint** `boolean`
>
> Returns response with indentations and line breaks.
>
> **access\_token** `string`
>
> OAuth access token.
>
> **upload\_protocol** `string`
>
> Upload protocol for media (e.g. 'raw', 'multipart').
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Google Slides Presentation
>
> **Slug:** `GOOGLEDRIVE_GET_PRESENTATION`
>
> Retrieves a Google Slides presentation by ID, including its page structures. An optional field selector can limit the returned data.
>
> #### Input Parameters
>
> **fields** `string`
>
> A Google API partial-response selector. Use comma-separated field names and parentheses for nested fields, such as 'presentationId,title' or 'slides(objectId,pageElements(objectId,shape))'. If omitted, Google returns the full presentation resource.
>
> **presentation\_id** `string` *required*
>
> The Google Slides presentation ID from its URL, not its title.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Presentation Page Thumbnail
>
> **Slug:** `GOOGLEDRIVE_GET_PRESENTATION_PAGE_THUMBNAIL`
>
> Generate one short-lived page thumbnail URL using an expensive Slides quota read.
>
> #### Input Parameters
>
> **mime\_type** `string`
>
> Thumbnail image format. Google currently supports only PNG.
>
> **page\_object\_id** `string` *required*
>
> The object ID of the slide, master, layout, notes page, or notes master to render. Obtain slide IDs from GOOGLEDRIVE\_GET\_PRESENTATION slides\[].objectId.
>
> **thumbnail\_size** `string ("LARGE" | "MEDIUM" | "SMALL")`
>
> Maximum thumbnail width while preserving aspect ratio: LARGE is 1600 px, MEDIUM is 800 px, and SMALL is 200 px.
>
> **presentation\_id** `string` *required*
>
> The Google Slides presentation ID from its URL, not its title.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Reply
>
> **Slug:** `GOOGLEDRIVE_GET_REPLY`
>
> Tool to get a specific reply to a comment on a file. Use when you need to retrieve the details of a particular reply.
>
> #### Input Parameters
>
> **fileId** `string` *required*
>
> The ID of the file.
>
> **replyId** `string` *required*
>
> The ID of the reply.
>
> **commentId** `string` *required*
>
> The ID of the comment.
>
> **includeDeleted** `boolean`
>
> Whether to return deleted replies. Deleted replies will not include their original content.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Revision
>
> **Slug:** `GOOGLEDRIVE_GET_REVISION`
>
> Tool to get a specific revision's metadata (name, modifiedTime, keepForever, etc.) by revision ID. Returns metadata only — not file content. Use a separate download tool to retrieve file content or restore a revision.
>
> #### Input Parameters
>
> **file\_id** `string` *required*
>
> The ID of the file.
>
> **revision\_id** `string` *required*
>
> The ID of the revision.
>
> **acknowledge\_abuse** `boolean`
>
> Whether the user is acknowledging the risk of downloading known malware or other abusive files. This is only applicable when the alt parameter is set to media and the user is the owner of the file or an organizer of the shared drive in which the file resides.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Spreadsheet
>
> **Slug:** `GOOGLEDRIVE_GET_SPREADSHEET`
>
> Retrieve a Google Spreadsheet's structure, metadata, and selected grid data.
>
> #### Input Parameters
>
> **fields** `string`
>
> Google partial-response selector, for example 'spreadsheetId,properties(title),sheets(properties(sheetId,title))'. Omit for Google's full normal response. When present it overrides include\_grid\_data behavior; explicitly select sheets.data or descendants to receive grid data.
>
> **ranges** `array`
>
> Up to 10 A1 ranges whose sheet data should be returned. Use bounded ranges such as 'Sheet1!A1:D100'; omit to address the whole spreadsheet resource.
>
> **spreadsheet\_id** `string` *required*
>
> The spreadsheet ID from its Google Sheets URL, not its title or full URL.
>
> **include\_grid\_data** `boolean`
>
> Include cell grid data for the requested ranges. This can produce a large response. When fields is supplied, Google ignores includeGridData, so this query parameter is omitted and the fields mask must select sheets.data descendants.
>
> **exclude\_tables\_in\_banded\_ranges** `boolean`
>
> Exclude table data embedded in banded ranges from the response. Leave false to include it.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Spreadsheet Values
>
> **Slug:** `GOOGLEDRIVE_GET_SPREADSHEET_VALUES`
>
> Read values from one range in a Google Spreadsheet.
>
> #### Input Parameters
>
> **range** `string` *required*
>
> An A1 or R1C1 range to read, such as 'Sheet1!A1:D100'. Prefer a bounded range; whole-sheet or whole-column ranges can return very large responses.
>
> **spreadsheet\_id** `string` *required*
>
> The spreadsheet ID from its Google Sheets URL, not its title.
>
> **major\_dimension** `string ("ROWS" | "COLUMNS")`
>
> Whether the outer values array represents rows or columns. If omitted, Google defaults to ROWS.
>
> **value\_render\_option** `string ("FORMATTED_VALUE" | "UNFORMATTED_VALUE" | "FORMULA")`
>
> How cell values are rendered: formatted display values, unformatted calculated values, or formulas.
>
> **date\_time\_render\_option** `string ("SERIAL_NUMBER" | "FORMATTED_STRING")`
>
> How dates, times, and durations are rendered when value\_render\_option is UNFORMATTED\_VALUE.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Team Drive (Deprecated)
>
> **Slug:** `GOOGLEDRIVE_GET_TEAM_DRIVE`
>
> Tool to get metadata about a Team Drive by ID. Deprecated: Use the drives.get endpoint instead.
>
> #### Input Parameters
>
> **teamDriveId** `string` *required*
>
> The ID of the Team Drive
>
> **useDomainAdminAccess** `boolean`
>
> Issue the request as a domain administrator; if set to true, then the requester will be granted access if they are an administrator of the domain to which the Team Drive belongs.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete folder or file
>
> **Slug:** `GOOGLEDRIVE_GOOGLE_DRIVE_DELETE_FOLDER_OR_FILE_ACTION`
>
> Tool to delete a file or folder in Google Drive. Use when you need to permanently remove a specific file or folder using its ID. Note: This action is irreversible. Deleting a folder permanently removes all nested files and subfolders.
>
> #### Input Parameters
>
> **fileId** `string` *required*
>
> The ID of the file or folder to delete. This is a required field.
>
> **supportsAllDrives** `boolean`
>
> Whether the application supports both My Drives and shared drives. If false or unspecified, the file is attempted to be deleted from the user's My Drive. If true, the item will be deleted from shared drives as well if necessary.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Hide Shared Drive
>
> **Slug:** `GOOGLEDRIVE_HIDE_DRIVE`
>
> Tool to hide a shared drive from the default view. Use when you want to remove a shared drive from the user's main Google Drive interface without deleting it.
>
> #### Input Parameters
>
> **drive\_id** `string` *required*
>
> The ID of the shared drive.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Insert Child Into Folder (v2)
>
> **Slug:** `GOOGLEDRIVE_INSERT_CHILD`
>
> Tool to insert a file into a folder using Drive API v2. Use when you need to add an existing file to a folder.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The ID of the child file to insert into the folder.
>
> **alt** `string ("json" | "media" | "proto")`
>
> Data format for response.
>
> **key** `string`
>
> API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
>
> **xgafv** `string ("1" | "2")`
>
> V1 error format options.
>
> **fields** `string`
>
> Selector specifying which fields to include in a partial response.
>
> **callback** `string`
>
> JSONP callback parameter.
>
> **folderId** `string` *required*
>
> The ID of the folder.
>
> **quotaUser** `string`
>
> Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
>
> **uploadType** `string`
>
> Legacy upload protocol for media (e.g. 'media', 'multipart').
>
> **oauth\_token** `string`
>
> OAuth 2.0 token for the current user.
>
> **prettyPrint** `boolean`
>
> Returns response with indentations and line breaks.
>
> **access\_token** `string`
>
> OAuth access token.
>
> **upload\_protocol** `string`
>
> Upload protocol for media (e.g. 'raw', 'multipart').
>
> **supportsAllDrives** `boolean`
>
> Whether the requesting application supports both My Drives and shared drives.
>
> **supportsTeamDrives** `boolean`
>
> Deprecated: Use supportsAllDrives instead.
>
> **enforceSingleParent** `boolean`
>
> Deprecated: Adding files to multiple folders is no longer supported. Use shortcuts instead.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Access Proposals
>
> **Slug:** `GOOGLEDRIVE_LIST_ACCESS_PROPOSALS`
>
> Tool to list pending access proposals on a file. Use when you need to retrieve access proposals for a specific file. Note: Only approvers can list access proposals; non-approvers will receive a 403 error.
>
> #### Input Parameters
>
> **fileId** `string` *required*
>
> The ID of the file to list access proposals for
>
> **pageSize** `integer`
>
> The number of results per page
>
> **pageToken** `string`
>
> The continuation token on the list of access requests
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Approvals
>
> **Slug:** `GOOGLEDRIVE_LIST_APPROVALS`
>
> Lists a page of approvals associated with a Google Drive file, with pagination for browsing subsequent pages. Approval details are unavailable through this action.
>
> #### Input Parameters
>
> **fileId** `string` *required*
>
> The ID of the file to list approvals for
>
> **pageSize** `integer`
>
> The maximum number of approvals to return per page
>
> **pageToken** `string`
>
> A pagination token returned as 'nextPageToken' from a previous list approvals response. Must be an exact, unmodified token from a prior API call - do not construct, encode, or guess token values. Only provide this parameter when paginating through results.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Changes
>
> **Slug:** `GOOGLEDRIVE_LIST_CHANGES`
>
> Lists a page of changes for a user or shared drive; without a page token, it obtains a current start token and lists subsequent changes rather than earlier activity. Follow nextPageToken to continue and save newStartPageToken for future monitoring.
>
> #### Input Parameters
>
> **fields** `string`
>
> FieldMask selecting the change-list fields to return. Include pagination tokens when paging and use parentheses for nested change or file fields, for example 'nextPageToken,newStartPageToken,changes(fileId,removed,file(id,name,mimeType))'. Leave blank for Google's default fields; use '\*' only when every field is necessary because it increases response size.
>
> **spaces** `string`
>
> A comma-separated list of spaces to query within the corpora. Supported values are 'drive' and 'appDataFolder'.
>
> **driveId** `string`
>
> The shared drive from which changes will be returned. If specified the change IDs will be reflective of the shared drive; use the combined drive ID and change ID as an identifier. When driveId is provided, supportsAllDrives is automatically set to true.
>
> **pageSize** `integer`
>
> The maximum number of changes to return per page.
>
> **pageToken** `string`
>
> The token for continuing a previous list request on the next page. Must be a valid token from a previous LIST\_CHANGES response's 'nextPageToken' field or from the get\_changes\_start\_page\_token action. If not provided, the current start page token will be automatically fetched and used. Tokens can become stale — always use a fresh token from GOOGLEDRIVE\_GET\_CHANGES\_START\_PAGE\_TOKEN or the most recent prior response to avoid missed or duplicate changes. Paginate until nextPageToken is absent; stopping early silently omits changes.
>
> **includeLabels** `string`
>
> A comma-separated list of IDs of labels to include in the `labelInfo` part of the response.
>
> **includeRemoved** `boolean`
>
> Whether to include changes indicating that items have been removed from the list of changes, for example by deletion or loss of access.
>
> **restrictToMyDrive** `boolean`
>
> Whether to restrict the results to changes inside the My Drive hierarchy. This omits changes to files such as those in the Application Data folder or shared files which have not been added to My Drive.
>
> **supportsAllDrives** `boolean`
>
> Whether the requesting application supports both My Drives and shared drives. Must be true when driveId is specified (will be automatically set to true when driveId is provided).
>
> **includeCorpusRemovals** `boolean`
>
> Whether changes should include the file resource if the file is still accessible by the user at the time of the request, even when a file was removed from the list of changes and there will be no further change entries for this file. Note: When set to true, includeRemoved must also be true (will be automatically set).
>
> **includeItemsFromAllDrives** `boolean`
>
> Whether both My Drive and shared drive items should be included in results. Must be true when driveId is specified (will be automatically set to true when driveId is provided).
>
> **includePermissionsForView** `string`
>
> Specifies which additional view's permissions to include in the response.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Folder Children (v2)
>
> **Slug:** `GOOGLEDRIVE_LIST_CHILDREN_V2`
>
> Lists a page of child references for a folder using Google Drive API v2. Follow the returned nextPageToken to retrieve additional pages.
>
> #### Input Parameters
>
> **q** `string`
>
> Query string for searching children.
>
> **alt** `string ("json" | "media" | "proto")`
>
> Data format for response enum.
>
> **key** `string`
>
> API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
>
> **xgafv** `string ("1" | "2")`
>
> V1 error format enum.
>
> **fields** `string`
>
> Selector specifying which fields to include in a partial response. This endpoint returns ChildReference objects, NOT full File objects. Valid ChildReference fields are: 'id' (child ID), 'selfLink' (link to this reference), 'kind' (resource type), 'childLink' (link to the child). File-level fields like 'title', 'modifiedDate', 'fileSize', 'alternateLink', 'mimeType' are NOT valid. Example: 'items(id,childLink),nextPageToken'
>
> **orderBy** `string`
>
> A comma-separated list of sort keys. Valid keys are 'createdDate', 'folder', 'lastViewedByMeDate', 'modifiedByMeDate', 'modifiedDate', 'quotaBytesUsed', 'recency', 'sharedWithMeDate', 'starred', and 'title'. Each key sorts ascending by default, but may be reversed with the 'desc' modifier. Example usage: ?orderBy=folder,modifiedDate desc,title.
>
> **callback** `string`
>
> JSONP callback parameter.
>
> **folderId** `string` *required*
>
> The ID of the folder.
>
> **pageToken** `string`
>
> Page token for children.
>
> **quotaUser** `string`
>
> Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
>
> **maxResults** `integer`
>
> Maximum number of children to return.
>
> **uploadType** `string`
>
> Legacy upload protocol for media (e.g. 'media', 'multipart').
>
> **oauth\_token** `string`
>
> OAuth 2.0 token for the current user.
>
> **prettyPrint** `boolean`
>
> Returns response with indentations and line breaks.
>
> **access\_token** `string`
>
> OAuth access token.
>
> **upload\_protocol** `string`
>
> Upload protocol for media (e.g. 'raw', 'multipart').
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Comments
>
> **Slug:** `GOOGLEDRIVE_LIST_COMMENTS`
>
> Lists comments on a Google Drive file, with pagination, an option to include deleted comments, and a minimum modification-time filter. Filter by author or content client-side.
>
> #### Input Parameters
>
> **fields** `string`
>
> A comma-separated list of fields to include in the response. Use `*` to include all fields. Prefer selective field masks (e.g., 'comments(id,content,author)') over '\*' to reduce payload size and latency.
>
> **fileId** `string` *required*
>
> The ID of the file. Equivalent to the Google Docs document\_id; pass it here under the fileId parameter name.
>
> **pageSize** `integer`
>
> The maximum number of comments to return per page.
>
> **pageToken** `string`
>
> The token for continuing a previous list request on the next page. This should be set to the value of 'nextPageToken' from the previous response. Comments may be added or modified during pagination on active files; use startModifiedTime to bound the window if consistency is required.
>
> **includeDeleted** `boolean`
>
> Whether to include deleted comments. Deleted comments will not include their original content.
>
> **startModifiedTime** `string`
>
> The minimum value of 'modifiedTime' for the result comments (RFC 3339 date-time).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List File Labels
>
> **Slug:** `GOOGLEDRIVE_LIST_FILE_LABELS`
>
> Lists labels applied to a Google Drive file, including label IDs and applied field IDs. An empty labels array is a valid response; additional pages may be available.
>
> #### Input Parameters
>
> **file\_id** `string` *required*
>
> The ID of the file.
>
> **page\_token** `string`
>
> Token to retrieve a specific page of results.
>
> **max\_results** `integer`
>
> The maximum number of labels to return per page. Default is 100.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Properties (v2 API)
>
> **Slug:** `GOOGLEDRIVE_LIST_FILE_PROPERTIES`
>
> Tool to list a file's properties in Google Drive API v2. Use when you need to retrieve custom properties (key-value pairs) attached to a file.
>
> #### Input Parameters
>
> **alt** `string ("json" | "media" | "proto")`
>
> Data format for response.
>
> **key** `string`
>
> API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
>
> **xgafv** `string ("1" | "2")`
>
> V1 error format values.
>
> **fields** `string`
>
> Selector specifying which fields to include in a partial response.
>
> **fileId** `string` *required*
>
> The ID of the file. This is a required parameter and cannot be empty.
>
> **callback** `string`
>
> JSONP callback function name.
>
> **quotaUser** `string`
>
> Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
>
> **uploadType** `string`
>
> Legacy upload protocol for media (e.g. 'media', 'multipart').
>
> **oauth\_token** `string`
>
> OAuth 2.0 token for the current user.
>
> **prettyPrint** `boolean`
>
> Returns response with indentations and line breaks.
>
> **access\_token** `string`
>
> OAuth access token.
>
> **upload\_protocol** `string`
>
> Upload protocol for media (e.g. 'raw', 'multipart').
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Files and Folders (Deprecated)
>
> **Slug:** `GOOGLEDRIVE_LIST_FILES`
>
> Lists and searches Google Drive files and folders using filters such as a folder, search query, or drive selection. Results are paginated; a 404 response is returned as an empty list and does not establish that no files match. DEPRECATED: Use GOOGLEDRIVE\_FIND\_FILE instead.
>
> #### Input Parameters
>
> **q** `string`
>
> A query string for filtering the file results. Supports operators 'and', 'or', 'not'. VALID query terms: 'name' (contains, =, !=), 'fullText' (contains), 'mimeType' (contains, =, !=), 'modifiedTime' (\<=, \<, =, !=, >, >=), 'viewedByMeTime' (\<=, \<, =, !=, >, >=), 'trashed' (=, !=), 'starred' (=, !=), 'parents' (in), 'owners' (in), 'writers' (in), 'readers' (in), 'sharedWithMe' (=, !=), 'createdTime' (\<=, \<, =, !=, >, >=), 'properties' (has), 'appProperties' (has), 'visibility' (=, !=), 'shortcutDetails.targetId' (=, !=). IMPORTANT: 'id' is NOT a valid query term - you cannot search by file ID using this parameter. To get a specific file by ID, use the 'Get File Metadata' action instead. Example: "name contains 'important' and mimeType = 'application/vnd.google-apps.folder'".
>
> **fields** `string`
>
> Selector specifying which file fields to include in the response. Provide a comma-separated list of file field names (e.g., 'id,name,mimeType,webViewLink'). The action will automatically format this into the proper API format 'files(field1,field2,...)'. Common file fields include: id, name, description, mimeType, webViewLink, webContentLink, size, createdTime, modifiedTime, parents, owners, permissions. To also include the pagination token, add 'nextPageToken' to the list. NOTE: Google Drive API v2 field names are automatically converted to v3 equivalents (e.g., alternateLink→webViewLink, downloadUrl→webContentLink, title→name, createdDate→createdTime, modifiedDate→modifiedTime).
>
> **spaces** `string`
>
> A comma-separated list of spaces to query within the corpora. Supported values are 'drive' and 'appDataFolder'. 'drive' represents files in My Drive and shared drives, while 'appDataFolder' represents the application's private data folder.
>
> **corpora** `string`
>
> Specifies the bodies of items (files/documents) to which the query applies. Supported values are 'user', 'domain', 'drive', and 'allDrives'. It's generally more efficient to use 'user' or 'drive' instead of 'allDrives'. Defaults to 'user'.
>
> **driveId** `string`
>
> The ID of the shared drive to search. This is used when `corpora` is set to 'drive'.
>
> **orderBy** `string`
>
> A comma-separated list of sort keys. Valid keys are: 'createdTime', 'folder', 'modifiedByMeTime', 'modifiedTime', 'name', 'name\_natural', 'quotaBytesUsed', 'recency', 'sharedWithMeTime', 'starred', 'viewedByMeTime'. IMPORTANT: Use 'quotaBytesUsed' to sort by file size (do NOT use 'size' - it is not a valid key). Each key sorts in ascending order by default, but can be reversed with the 'desc' modifier (e.g., 'modifiedTime desc').
>
> **folderId** `string`
>
> ID of a specific folder to list files from. This is a convenience parameter that automatically adds "'folder\_id' in parents" to the query. Cannot be used together with a custom 'q' parameter.
>
> **pageSize** `integer`
>
> The maximum number of files to return per page. The value must be between 1 and 1000, inclusive. Defaults to 100.
>
> **pageToken** `string`
>
> The token for continuing a previous list request on the next page. This MUST be set to the value of 'nextPageToken' from the previous response. Do not manually construct or modify pageToken values as they are opaque tokens generated by the API. If the token is rejected, pagination should be restarted from the first page.
>
> **includeLabels** `string`
>
> A comma-separated list of label IDs to include in the `labelInfo` part of the response for each file.
>
> **supportsAllDrives** `boolean`
>
> Whether the requesting application supports both My Drives and shared drives. Defaults to false. If true, then `includeItemsFromAllDrives` can be used to extend the search to all drives.
>
> **includeItemsFromAllDrives** `boolean`
>
> Whether to include items from both My Drive and shared drives. This is relevant when `corpora` is 'user' or 'domain'. Defaults to false.
>
> **includePermissionsForView** `string`
>
> Include additional permissions for a specific view. The only valid value is 'published', which includes permissions for files with published content. Omit this parameter if you don't need published view permissions.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Google Form Responses
>
> **Slug:** `GOOGLEDRIVE_LIST_FORM_RESPONSES`
>
> Return one page of submissions for a Google Form.
>
> #### Input Parameters
>
> **filter** `string`
>
> Filter responses by submission time. Supported forms are 'timestamp > RFC3339\_Z' and 'timestamp >= RFC3339\_Z', for example 'timestamp >= 2026-01-01T00:00:00Z'.
>
> **form\_id** `string` *required*
>
> The ID of the Google Form whose responses to list.
>
> **page\_size** `integer`
>
> The maximum number of responses to return on this page, from 1 to 5000.
>
> **page\_token** `string`
>
> The exact next\_page\_token returned by a previous call. Keep the same form\_id and filter when requesting the next page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Label Definitions
>
> **Slug:** `GOOGLEDRIVE_LIST_LABEL_DEFINITIONS`
>
> Lists available Google Drive labels, returning each label's ID and display name without requiring a file ID.
>
> #### Input Parameters
>
> **customer** `string`
>
> Customer resource name to scope the request to, such as customers/123abc789. Defaults to the current customer.
>
> **page\_size** `integer`
>
> Maximum number of labels to return. Defaults to 10; the provider allows at most 200.
>
> **page\_token** `string`
>
> Exact next-page token returned by an earlier call.
>
> **minimum\_role** `string ("LABEL_ROLE_UNSPECIFIED" | "READER" | "APPLIER" | "ORGANIZER" | "EDITOR")`
>
> Minimum role the current user must have on returned labels. Defaults to READER.
>
> **language\_code** `string`
>
> BCP-47 language code used to evaluate localized field labels. The provider uses its configured default language when omitted.
>
> **published\_only** `boolean`
>
> Whether to return only current published label revisions. Disabled labels are included when true; when false, current revisions may be unpublished.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Permissions
>
> **Slug:** `GOOGLEDRIVE_LIST_PERMISSIONS`
>
> Lists a page of permissions for a file or shared drive. Use the returned next page token to retrieve further pages when present.
>
> #### Input Parameters
>
> **fields** `string`
>
> FieldMask selecting the permission-list fields to return. Use comma-separated fields and parentheses for nested permission fields, for example 'nextPageToken,permissions(id,type,role,emailAddress)'. Leave blank for Google's default fields; use '\*' only when every field is necessary because it increases response size.
>
> **fileId** `string` *required*
>
> The ID of the file or shared drive. Must be a non-empty string.
>
> **pageSize** `integer`
>
> The maximum number of permissions to return per page. When not set for files in a shared drive, at most 100 results will be returned. When not set for files that are not in a shared drive, the entire list will be returned.
>
> **pageToken** `string`
>
> The token for continuing a previous list request on the next page. This should be set to the value of 'nextPageToken' from the previous response.
>
> **supportsAllDrives** `boolean`
>
> Whether the requesting application supports both My Drives and shared drives. Default: false
>
> **useDomainAdminAccess** `boolean`
>
> Issue the request as a domain administrator; if set to true, then theRequester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs.
>
> **includePermissionsForView** `string`
>
> Specifies which additional view's permissions to include in the response. Only 'published' is supported.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Replies to Comment
>
> **Slug:** `GOOGLEDRIVE_LIST_REPLIES`
>
> List a page of replies to a specific comment on a Google Drive file. Supports pagination and optionally including deleted replies.
>
> #### Input Parameters
>
> **fields** `string`
>
> Selector specifying which fields to include in a partial response. Use '\*' for all fields or e.g. 'replies(id,content),nextPageToken'
>
> **file\_id** `string` *required*
>
> The ID of the file.
>
> **page\_size** `integer`
>
> The maximum number of replies to return per page.
>
> **comment\_id** `string` *required*
>
> The ID of the comment.
>
> **page\_token** `string`
>
> The token for continuing a previous list request on the next page. This should be set to the value of 'nextPageToken' from the previous response.
>
> **include\_deleted** `boolean`
>
> Whether to include deleted replies. Deleted replies will not include their original content.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List File Revisions
>
> **Slug:** `GOOGLEDRIVE_LIST_REVISIONS`
>
> Tool to list a file's revision metadata (not content) in Google Drive. Drive may prune old revisions, so history may be incomplete for frequently edited files. Filter client-side for specific revisionIds; do not assume the last entry is the active version.
>
> #### Input Parameters
>
> **fileId** `string` *required*
>
> The ID of the file.
>
> **pageSize** `integer`
>
> The maximum number of revisions to return per page.
>
> **pageToken** `string`
>
> The token for continuing a previous list request on the next page. This should be set to the value of 'nextPageToken' from the previous response. Continue paginating until `nextPageToken` is absent; stopping early silently omits revisions.
>
> **supportsAllDrives** `boolean`
>
> Whether the requesting application supports both My Drives and shared drives. Defaults to false. Must be set to `true` for shared drive files; omitting it causes `fileId` resolution failures on shared drives.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Shared Drives
>
> **Slug:** `GOOGLEDRIVE_LIST_SHARED_DRIVES`
>
> Tool to list the user's shared drives. Use when you need to get a list of all shared drives accessible to the authenticated user. Results may differ from the web UI due to admin policies; listing a drive does not guarantee access to its contents. Paginated calls may trigger 403 rateLimitExceeded or 429 tooManyRequests; apply exponential backoff when iterating many pages.
>
> #### Input Parameters
>
> **q** `string`
>
> Query string for searching shared drives using Google Drive query syntax (e.g., "name contains 'ProjectX'" or "createdTime > '2023-01-01T00:00:00'"). Query format: query\_term operator values. Common query terms: name, createdTime, memberCount, organizerCount, hidden. Common operators: contains, =, >, \<, >=, !=. String values must be enclosed in single quotes. Special characters (apostrophes, backslashes) must be escaped. Multiple terms can be combined with 'and'/'or' operators and parentheses for grouping.
>
> **fields** `string`
>
> FieldMask selecting the shared-drive list fields to return. Use comma-separated fields and parentheses for nested drive fields, for example 'nextPageToken,drives(id,name,hidden,createdTime)'. Leave blank for Google's default fields; use '\*' only when every field is necessary because it increases response size.
>
> **pageSize** `integer`
>
> Maximum number of shared drives to return per page. Maximum allowed value is 1000. Paginate by passing the returned nextPageToken back as pageToken until no nextPageToken is returned to avoid silently missing drives.
>
> **pageToken** `string`
>
> Page token for shared drives.
>
> **useDomainAdminAccess** `boolean`
>
> Issue the request as a domain administrator. If set to true, then all shared drives of the domain in which the requester is an administrator are returned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Team Drives (Deprecated)
>
> **Slug:** `GOOGLEDRIVE_LIST_TEAM_DRIVES`
>
> Tool to list Team Drives (deprecated, use List Shared Drives instead). Use when you need to retrieve Team Drives using the legacy endpoint.
>
> #### Input Parameters
>
> **q** `string`
>
> Query string for searching Team Drives.
>
> **alt** `string ("json" | "media" | "proto")`
>
> Data format for response.
>
> **key** `string`
>
> API key. Your API key identifies your project and provides you with API access, quota, and reports.
>
> **xgafv** `string ("1" | "2")`
>
> V1 error format values.
>
> **fields** `string`
>
> Selector specifying which fields to include in a partial response.
>
> **callback** `string`
>
> JSONP callback.
>
> **pageSize** `integer`
>
> Maximum number of Team Drives to return per page.
>
> **pageToken** `string`
>
> Page token for Team Drives.
>
> **quotaUser** `string`
>
> Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
>
> **uploadType** `string`
>
> Legacy upload protocol for media (e.g. 'media', 'multipart').
>
> **oauth\_token** `string`
>
> OAuth 2.0 token for the current user.
>
> **prettyPrint** `boolean`
>
> Returns response with indentations and line breaks.
>
> **access\_token** `string`
>
> OAuth access token.
>
> **upload\_protocol** `string`
>
> Upload protocol for media (e.g. 'raw', 'multipart').
>
> **useDomainAdminAccess** `boolean`
>
> Issue the request as a domain administrator; if set to true, then all Team Drives of the domain in which the requester is an administrator are returned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Modify File Labels
>
> **Slug:** `GOOGLEDRIVE_MODIFY_FILE_LABELS`
>
> Modifies the set of labels applied to a file. Returns a list of the labels that were added or modified. Use when you need to programmatically change labels on a Google Drive file, such as adding, updating, or removing them.
>
> #### Input Parameters
>
> **kind** `string`
>
> This is always drive#modifyLabelsRequest.
>
> **file\_id** `string` *required*
>
> The ID of the file.
>
> **label\_modifications** `array` *required*
>
> The list of modifications to apply to the labels on the file.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Move File
>
> **Slug:** `GOOGLEDRIVE_MOVE_FILE`
>
> Moves a file to another Google Drive folder. At least one of `add_parents` or `remove_parents` is required; calls with neither are rejected. Supply `add_parents` with the destination folder ID; if `remove_parents` is omitted, the action checks and removes the current parent automatically before adding the destination. For My Drive files only, `remove_parents` without `add_parents` moves the file to My Drive root. For shared-drive items, set `supports_all_drives=true` and provide `add_parents` because the item must retain exactly one parent; membership, role, and domain policies can restrict moves, and the Drive API cannot move a folder from My Drive into a shared drive. Google Drive files have one parent, so use a shortcut for additional placements.
>
> #### Input Parameters
>
> **file\_id** `string` *required*
>
> The ID of the file to move. Must be a non-empty string.
>
> **add\_parents** `string`
>
> The ID of the single destination folder (e.g., '1FmTIJYwTENUDXOKyNJp7OmcRBvP\_6DmT'). Folder names are not accepted. When remove\_parents is omitted, the action checks the file's current parent and removes it automatically before adding this destination. Omit this only when using remove\_parents to move a My Drive file to My Drive root. For a shared-drive item, set supports\_all\_drives=true and provide this destination because the item must retain exactly one parent. At least one of add\_parents or remove\_parents is required.
>
> **ocr\_language** `string`
>
> A language hint for OCR processing during image import (ISO 639-1 code).
>
> **include\_labels** `string`
>
> A comma-separated list of IDs of labels to include in the `labelInfo` part of the response.
>
> **remove\_parents** `string`
>
> A comma-separated list of current parent folder IDs to remove. This is optional when add\_parents is supplied because the action checks and removes the current parent automatically. For My Drive files only, supplying this without add\_parents moves the file to My Drive root. Do not use remove\_parents alone for a shared-drive item; shared-drive items must retain exactly one parent. At least one of add\_parents or remove\_parents is required.
>
> **supports\_all\_drives** `boolean`
>
> Whether the request supports both My Drive and shared drives. Set this to true when the source file or destination folder is in a shared drive; otherwise Google can return not-found or unsupported-drive errors.
>
> **keep\_revision\_forever** `boolean`
>
> Whether to set the 'keepForever' field in the new head revision. This is only applicable to files with binary content in Google Drive.
>
> **include\_permissions\_for\_view** `string`
>
> Specifies which additional view's permissions to include in the response. Only 'published' is supported.
>
> **use\_content\_as\_indexable\_text** `boolean`
>
> Whether to use the uploaded content as indexable text.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Export or download a file
>
> **Slug:** `GOOGLEDRIVE_PARSE_FILE`
>
> DEPRECATED: Exports Google Workspace files (max 10MB) to a specified format using `mime_type`, or downloads other file types; use `GOOGLEDRIVE_DOWNLOAD_FILE` instead.
>
> #### Input Parameters
>
> **file\_id** `string` *required*
>
> The unique ID of the file stored in Google Drive that you want to export or download.
>
> **mime\_type** `string ("application/vnd.openxmlformats-officedocument.wordprocessingml.document" | "application/vnd.oasis.opendocument.text" | "application/rtf" | "application/pdf" | "text/plain" | "application/zip" | "application/epub+zip" | "text/markdown" | "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" | "application/vnd.oasis.opendocument.spreadsheet" | "text/csv" | "text/tab-separated-values" | "application/vnd.openxmlformats-officedocument.presentationml.presentation" | "application/vnd.oasis.opendocument.presentation" | "image/jpeg" | "image/png" | "image/svg+xml" | "application/vnd.google-apps.script+json" | "video/mp4")`
>
> Target MIME type for exporting Google Workspace files only. Supported exports by source type: Google Docs -> DOCX, ODT, RTF, PDF, TXT, ZIP (HTML), EPUB, MD; Google Sheets -> XLSX, ODS, PDF, ZIP (HTML), CSV, TSV; Google Slides -> PPTX, ODP, PDF, TXT, JPG, PNG, SVG; Google Drawings -> PDF, JPG, PNG, SVG; Apps Script -> JSON. If omitted, a default format is used: Docs->PDF, Sheets->XLSX, Slides->PDF, Drawings->PDF. For non-Workspace files (PDFs, images, text files, etc.), this parameter is ignored and the file is downloaded in its native format.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Patch Permission
>
> **Slug:** `GOOGLEDRIVE_PATCH_PERMISSION`
>
> Tool to update a permission using patch semantics. Use when you need to modify specific fields of an existing permission without affecting other fields. **Warning:** Concurrent permissions operations on the same file are not supported; only the last update is applied.
>
> #### Input Parameters
>
> **role** `string ("owner" | "organizer" | "fileOrganizer" | "writer" | "reader")`
>
> Permission roles that can be granted in Google Drive.
>
> **file\_id** `string` *required*
>
> The ID for the file or shared drive.
>
> **with\_link** `boolean`
>
> Whether the link is required for this permission. Set to true for 'anyone with the link' access (not publicly discoverable), or false for publicly discoverable access.
>
> **permission\_id** `string` *required*
>
> The ID for the permission. Use 'anyone' for public link permissions, or specific permission IDs for user/group/domain permissions. You can get permission IDs by calling GOOGLEDRIVE\_LIST\_PERMISSIONS.
>
> **expiration\_date** `string`
>
> The time at which this permission will expire (RFC 3339 date-time). Can only be set on user and group permissions. The date must be in the future and cannot be more than a year in the future.
>
> **additional\_roles** `array`
>
> Additional roles for this user. Only 'commenter' is currently allowed.
>
> **remove\_expiration** `boolean`
>
> Whether to remove the expiration date. Set to true to make the permission permanent.
>
> **transfer\_ownership** `boolean`
>
> Whether changing a role to 'owner' downgrades the current owners to writers. Does nothing if the specified role is not 'owner'. Required as an acknowledgement when transferring ownership.
>
> **supports\_all\_drives** `boolean`
>
> Whether the requesting application supports both My Drives and shared drives.
>
> **use\_domain\_admin\_access** `boolean`
>
> Issue the request as a domain administrator; if set to true, then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Patch Property (v2 API)
>
> **Slug:** `GOOGLEDRIVE_PATCH_PROPERTY`
>
> Tool to update a property on a file using PATCH semantics (v2 API). Use when you need to partially update custom key-value metadata attached to a Google Drive file.
>
> #### Input Parameters
>
> **alt** `string ("json" | "media" | "proto")`
>
> Data format for response.
>
> **key** `string`
>
> API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
>
> **value** `string`
>
> The value of this property.
>
> **xgafv** `string ("1" | "2")`
>
> V1 error format values.
>
> **fields** `string`
>
> Selector specifying which fields to include in a partial response.
>
> **fileId** `string` *required*
>
> The ID of the file.
>
> **callback** `string`
>
> JSONP callback function name.
>
> **quotaUser** `string`
>
> Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
>
> **uploadType** `string`
>
> Legacy upload protocol for media (e.g. 'media', 'multipart').
>
> **visibility** `string ("PRIVATE" | "PUBLIC")`
>
> Property visibility values.
>
> **oauth\_token** `string`
>
> OAuth 2.0 token for the current user.
>
> **prettyPrint** `boolean`
>
> Returns response with indentations and line breaks.
>
> **propertyKey** `string` *required*
>
> The key of the property to update.
>
> **access\_token** `string`
>
> OAuth access token.
>
> **upload\_protocol** `string`
>
> Upload protocol for media (e.g. 'raw', 'multipart').
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Read Spreadsheet Values
>
> **Slug:** `GOOGLEDRIVE_READ_SPREADSHEET_VALUES`
>
> Read values from one or more ranges in a Google spreadsheet.
>
> #### Input Parameters
>
> **ranges** `array` *required*
>
> One or more A1 or R1C1 ranges to read. Results are returned in the same order.
>
> **spreadsheet\_id** `string` *required*
>
> The ID of the Google spreadsheet, found in its URL between '/d/' and '/edit'.
>
> **major\_dimension** `string ("ROWS" | "COLUMNS")`
>
> Whether each inner values array represents a row or a column. Google defaults to ROWS.
>
> **value\_render\_option** `string ("FORMATTED_VALUE" | "UNFORMATTED_VALUE" | "FORMULA")`
>
> How values are represented. Google defaults to FORMATTED\_VALUE.
>
> **date\_time\_render\_option** `string ("SERIAL_NUMBER" | "FORMATTED_STRING")`
>
> How dates, times, and durations are represented when values are not formatted. Google defaults to SERIAL\_NUMBER.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Resumable Upload
>
> **Slug:** `GOOGLEDRIVE_RESUMABLE_UPLOAD`
>
> Upload a file to Google Drive using a resumable session, creating a new file or updating an existing file by ID. The upload is sent in chunks.
>
> #### Input Parameters
>
> **file\_id** `string`
>
> Optional file ID if updating an existing file instead of creating a new one.
>
> **metadata** `object`
>
> JSON metadata for the Drive File resource (e.g., \{'name': 'photo.jpg', 'parents': \['folderId']}). To convert to a Google Docs MIME type, set metadata.mimeType to the target Docs type but send the real file MIME type as the upload content type — using the Docs MIME type as upload content type causes invalidContentType errors.
>
> **chunkSize** `integer`
>
> Chunk size in bytes; must be a multiple of 256 KB.
>
> **queryParams** `object`
>
> Optional Drive query parameters.
>
> **file\_to\_upload** `object` *required*
>
> File to upload to Google Drive via resumable upload.
>
> **folder\_to\_upload\_to** `string`
>
> Optional folder ID where NEW files should be uploaded. Only used during file creation, not updates. Will be added to metadata.parents. Must reference a valid, non-trashed folder ID; invalid or trashed IDs silently place files at root.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Stop Watch Channel
>
> **Slug:** `GOOGLEDRIVE_STOP_WATCH_CHANNEL`
>
> Tool to stop watching resources through a specified channel. Use this when you want to stop receiving notifications for a previously established watch. Both `id` and `resourceId` must be saved from the original watch response — they cannot be retrieved after the fact.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The ID of the channel to stop.
>
> **kind** `string`
>
> Identifies this as a notification channel used to watch for changes to a resource.
>
> **token** `string`
>
> An arbitrary string delivered to the target address with each notification delivered over this channel.
>
> **params** `object`
>
> Additional parameters controlling delivery channel behavior.
>
> **address** `string`
>
> The address where notifications are delivered for this channel.
>
> **payload** `boolean`
>
> A Boolean value to indicate whether payload is wanted.
>
> **expiration** `string`
>
> Date and time of notification channel expiration, expressed as a Unix timestamp, in milliseconds.
>
> **resourceId** `string` *required*
>
> The ID of the resource being watched.
>
> **channelType** `string ("web_hook" | "webhook")`
>
> The type of delivery mechanism used for this channel.
>
> **resourceUri** `string`
>
> A version-specific identifier for the watched resource.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Trash File
>
> **Slug:** `GOOGLEDRIVE_TRASH_FILE`
>
> Tool to move a file or folder to trash (soft delete). Use when you need to delete a file but want to allow recovery via UNTRASH\_FILE. This action is distinct from permanent deletion and provides a safer cleanup workflow.
>
> #### Input Parameters
>
> **fields** `string`
>
> Comma-separated list of fields to include in the response. Use to limit the amount of data returned. If omitted, returns basic file metadata.
>
> **file\_id** `string` *required*
>
> The ID of the file to trash.
>
> **supportsAllDrives** `boolean`
>
> Whether the requesting application supports both My Drives and shared drives. Defaults to true.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Unhide Shared Drive
>
> **Slug:** `GOOGLEDRIVE_UNHIDE_DRIVE`
>
> Tool to unhide a shared drive. Use when you need to restore a shared drive to the default view.
>
> #### Input Parameters
>
> **driveId** `string` *required*
>
> The ID of the shared drive.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Untrash File
>
> **Slug:** `GOOGLEDRIVE_UNTRASH_FILE`
>
> Restore a file from Google Drive trash. The file must still be in the trash; this does not recover permanently deleted files.
>
> #### Input Parameters
>
> **file\_id** `string` *required*
>
> The ID of the file to untrash.
>
> **supportsAllDrives** `boolean`
>
> Whether the requesting application supports both My Drives and shared drives.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Comment
>
> **Slug:** `GOOGLEDRIVE_UPDATE_COMMENT`
>
> Tool to update an existing comment on a Google Drive file. Use when you need to change the content of a comment. NOTE: The 'resolved' field is read-only in the Google Drive API. To resolve or reopen a comment, use CREATE\_REPLY with action='resolve' or action='reopen'.
>
> #### Input Parameters
>
> **fields** `string`
>
> Selector specifying which fields to include in a partial response. The API documentation states this is required. If not specified by the user, this action defaults to '\*' to retrieve all fields, ensuring the API requirement is met. Example: 'id,content,resolved'.
>
> **content** `string`
>
> The plain text content of the comment. This field is used to update the comment's text. If not provided, the existing content will be retained unless 'resolved' is being updated.
>
> **file\_id** `string` *required*
>
> The ID of the file.
>
> **resolved** `boolean`
>
> NOTE: The 'resolved' field is READ-ONLY in the Google Drive API. To resolve or reopen a comment, use the CREATE\_REPLY action with action='resolve' or action='reopen'. This parameter is kept for backwards compatibility but will be silently ignored by the API.
>
> **comment\_id** `string` *required*
>
> The ID of the comment to update.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Shared Drive
>
> **Slug:** `GOOGLEDRIVE_UPDATE_DRIVE`
>
> Tool to update the metadata for a shared drive. Use when you need to modify properties like the name, theme, background image, or restrictions of a shared drive.
>
> #### Input Parameters
>
> **name** `string`
>
> The new name for the shared drive.
>
> **hidden** `boolean`
>
> Whether the shared drive is hidden from the default view.
>
> **driveId** `string` *required*
>
> The ID of the shared drive to update.
>
> **themeId** `string`
>
> The ID of a theme to apply to the shared drive. Cannot be set if colorRgb or backgroundImageFile are set.
>
> **colorRgb** `string`
>
> The color of this shared drive as an RGB hex string (e.g., "#FF0000"). Cannot be set if themeId is set.
>
> **restrictions** `object`
>
> A set of restrictions to apply to the shared drive.
>
> **backgroundImageFile** `object`
>
> An image file and cropping parameters for the shared drive's background. Cannot be set if themeId is set.
>
> **useDomainAdminAccess** `boolean`
>
> If set to true, the request is issued as a domain administrator.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update File Metadata (PATCH v2)
>
> **Slug:** `GOOGLEDRIVE_UPDATE_FILE_METADATA_PATCH`
>
> Tool to update file metadata using the Drive API v2 PATCH method. Use when you need to modify file properties like title, description, or labels using patch semantics.
>
> #### Input Parameters
>
> **ocr** `boolean`
>
> Whether to attempt OCR on .jpg, .png, .gif, or .pdf uploads.
>
> **title** `string`
>
> The title of the file. Used to change the name of the file.
>
> **fileId** `string` *required*
>
> The ID of the file to update.
>
> **labels** `object`
>
> A group of labels for the file. For example: \{'starred': true, 'trashed': false, 'restricted': false, 'viewed': true}.
>
> **pinned** `boolean`
>
> Whether to pin the new revision. A file can have a maximum of 200 pinned revisions.
>
> **mimeType** `string`
>
> The MIME type of the file.
>
> **addParents** `string`
>
> Comma-separated list of parent IDs to add.
>
> **properties** `array`
>
> The list of properties.
>
> **description** `string`
>
> A short description of the file.
>
> **newRevision** `boolean`
>
> Whether a blob upload should create a new revision. If not set, a new revision is created.
>
> **ocrLanguage** `string`
>
> If ocr is true, hints at the language to use. Valid values are BCP 47 codes.
>
> **modifiedDate** `string`
>
> Last time this file was modified by anyone (RFC 3339 date-time). Requires setModifiedDate=true.
>
> **includeLabels** `string`
>
> A comma-separated list of IDs of labels to include in the labelInfo part of the response.
>
> **indexableText** `object`
>
> Indexable text attributes for the file (can be used to improve fulltext queries).
>
> **removeParents** `string`
>
> Comma-separated list of parent IDs to remove.
>
> **setModifiedDate** `boolean`
>
> Whether to set the modified date using the value supplied in the request body.
>
> **writersCanShare** `boolean`
>
> Whether writers can share the document with other users.
>
> **updateViewedDate** `boolean`
>
> Whether to update the view date after successfully updating the file.
>
> **supportsAllDrives** `boolean`
>
> Whether the requesting application supports both My Drives and shared drives. Defaults to true.
>
> **timedTextLanguage** `string`
>
> The language of the timed text.
>
> **timedTextTrackName** `string`
>
> The timed text track name.
>
> **includePermissionsForView** `string`
>
> Specifies which additional view's permissions to include in the response. Only 'published' is supported.
>
> **useContentAsIndexableText** `boolean`
>
> Whether to use the content as indexable text.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Property (v2 API)
>
> **Slug:** `GOOGLEDRIVE_UPDATE_FILE_PROPERTY`
>
> Tool to update a property on a file using Google Drive API v2. Use when you need to modify an existing custom property attached to a file.
>
> #### Input Parameters
>
> **alt** `string ("json" | "media" | "proto")`
>
> Data format for response.
>
> **key** `string`
>
> API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
>
> **xgafv** `string ("1" | "2")`
>
> V1 error format values.
>
> **fields** `string`
>
> Selector specifying which fields to include in a partial response.
>
> **fileId** `string` *required*
>
> The ID of the file.
>
> **callback** `string`
>
> JSONP callback function name.
>
> **quotaUser** `string`
>
> Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
>
> **uploadType** `string`
>
> Legacy upload protocol for media (e.g. 'media', 'multipart').
>
> **visibility** `string ("PRIVATE" | "PUBLIC")`
>
> Visibility options for the property.
>
> **oauth\_token** `string`
>
> OAuth 2.0 token for the current user.
>
> **prettyPrint** `boolean`
>
> Returns response with indentations and line breaks.
>
> **propertyKey** `string` *required*
>
> The key of the property.
>
> **access\_token** `string`
>
> OAuth access token.
>
> **property\_value** `string`
>
> The value of this property.
>
> **upload\_protocol** `string`
>
> Upload protocol for media (e.g. 'raw', 'multipart').
>
> **property\_visibility** `string ("PRIVATE" | "PUBLIC")`
>
> Visibility options for the property.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update File (Metadata)
>
> **Slug:** `GOOGLEDRIVE_UPDATE_FILE_PUT`
>
> Updates file metadata. Uses PATCH semantics (partial update) as per Google Drive API v3 — only explicitly provided fields are updated, so omit fields you do not intend to overwrite. Use this tool to modify attributes of an existing file like its name, description, or parent folders. To move a file, supply add\_parents and remove\_parents together; omitting remove\_parents creates multiple parents, omitting add\_parents can orphan the file. Bulk updates may trigger 429 Too Many Requests; apply exponential backoff. Note: supports metadata updates only; file content updates are not yet implemented.
>
> #### Input Parameters
>
> **name** `string`
>
> The name of the file. Google Drive does not enforce name uniqueness within a folder; duplicate names are allowed and can cause ambiguous results when searching by name.
>
> **fileId** `string` *required*
>
> The ID of the file to update.
>
> **starred** `boolean`
>
> Whether the user has starred the file.
>
> **mime\_type** `string`
>
> The MIME type of the file. Google Drive will attempt to automatically detect an appropriate value from uploaded content if no value is provided. The value cannot be changed unless a new revision is uploaded.
>
> **add\_parents** `string`
>
> Comma-separated list of folder IDs (not folder names) to add as parents. Folder IDs are alphanumeric strings typically 20+ characters long (e.g., '1A2B3C4D5E6F7G8H9I0J'). Folder names will not work and will cause a 'Parent folder not found' error. Moving a file requires pairing with remove\_parents (source folder ID); omitting remove\_parents results in multiple parents. Reparenting to a shared folder changes collaborator access to that folder's permissions.
>
> **description** `string`
>
> A short description of the file.
>
> **ocr\_language** `string`
>
> A language hint for OCR processing during image import (ISO 639-1 code).
>
> **remove\_parents** `string`
>
> Comma-separated list of folder IDs (not folder names) to remove as parents. Folder IDs are alphanumeric strings typically 20+ characters long (e.g., '1A2B3C4D5E6F7G8H9I0J'). Folder names will not work and will cause a 'Parent folder not found' error.
>
> **writers\_can\_share** `boolean`
>
> Whether writers can share the document with other users.
>
> **supports\_all\_drives** `boolean`
>
> Whether the requesting application supports both My Drives and shared drives. Defaults to true to ensure compatibility with shared drive files.
>
> **keep\_revision\_forever** `boolean`
>
> Whether to set this revision of the file to be kept forever. This is only applicable to files with binary content in Google Drive. Only 200 revisions for the file can be kept forever. If the limit is reached, try deleting pinned revisions.
>
> **use\_domain\_admin\_access** `boolean`
>
> Whether the requesting application is using domain-wide delegation to access content belonging to a user in a different domain. This is only applicable to files with binary content in Google Drive.
>
> **viewers\_can\_copy\_content** `boolean`
>
> Whether viewers are prevented from copying content of the file.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update File Revision Metadata
>
> **Slug:** `GOOGLEDRIVE_UPDATE_FILE_REVISION_METADATA`
>
> Updates ONLY the metadata properties of a specific file revision (keepForever, published, publishAuto, publishedOutsideDomain). IMPORTANT: This action does NOT update file content. To update file content, use EDIT\_FILE or UPDATE\_FILE\_PUT instead. This action requires BOTH file\_id AND revision\_id parameters. Use LIST\_REVISIONS to get available revision IDs for a file. Valid parameters: file\_id (required), revision\_id (required), keep\_forever, published, publish\_auto, published\_outside\_domain. Invalid parameters (use other actions): file\_contents, mime\_type, content, name - these are NOT supported by this action.
>
> #### Input Parameters
>
> **file\_id** `string` *required*
>
> Required. The ID of the file whose revision metadata you want to update. Use LIST\_FILES or FIND\_FILE to get the file ID.
>
> **published** `boolean`
>
> Whether this revision is published. This is only applicable to Docs Editors files.
>
> **keepForever** `boolean`
>
> Whether to keep this revision forever, even if it is no longer the head revision. If not set, the revision will be automatically purged 30 days after newer content is uploaded. This can be set on a maximum of 200 revisions for a file. This field is only applicable to files with binary content in Drive.
>
> **publishAuto** `boolean`
>
> Whether subsequent revisions will be automatically republished. This is only applicable to Docs Editors files.
>
> **revision\_id** `string` *required*
>
> Required. The ID of the revision to update. Use LIST\_REVISIONS to get available revision IDs for a file.
>
> **publishedOutsideDomain** `boolean`
>
> Whether this revision is published outside the domain. This is only applicable to Docs Editors files.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Permission
>
> **Slug:** `GOOGLEDRIVE_UPDATE_PERMISSION`
>
> Tool to update a permission with patch semantics. Use when you need to modify an existing permission for a file or shared drive. Inherited or domain-managed permissions may not be editable; verify editability with GOOGLEDRIVE\_LIST\_PERMISSIONS before updating.
>
> #### Input Parameters
>
> **fileId** `string` *required*
>
> The ID of the file or shared drive.
>
> **permission** `object` *required*
>
> The permission resource to update. Only 'role' and 'expirationTime' can be updated. Role changes take effect immediately and can be difficult to reverse; confirm intent before applying.
>
> **permissionId** `string` *required*
>
> The ID of the permission. For anyone-type permissions, use 'anyone' as the permission ID.
>
> **removeExpiration** `boolean`
>
> Whether to remove the expiration date.
>
> **supportsAllDrives** `boolean`
>
> Whether the requesting application supports both My Drives and shared drives. Must be set to true when operating on shared drives; omitting this causes the request to fail.
>
> **transferOwnership** `boolean`
>
> Whether to transfer ownership to the specified user and downgrade the current owner to a writer. This parameter is required as an acknowledgement of the side effect when set to true.
>
> **useDomainAdminAccess** `boolean`
>
> Issue the request as a domain administrator; if set to true, then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs.
>
> **enforceExpansiveAccess** `boolean`
>
> Whether the request should enforce expansive access rules. This field is deprecated, it is recommended to use `permissionDetails` instead.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Reply
>
> **Slug:** `GOOGLEDRIVE_UPDATE_REPLY`
>
> Tool to update a reply to a comment on a Google Drive file. Use when you need to modify the content of an existing reply.
>
> #### Input Parameters
>
> **fields** `string`
>
> Selector specifying which fields to include in a partial response. If not provided, defaults to '\*' to return all fields.
>
> **content** `string` *required*
>
> The new plain text content of the reply.
>
> **file\_id** `string` *required*
>
> The ID of the file.
>
> **reply\_id** `string` *required*
>
> The ID of the reply.
>
> **comment\_id** `string` *required*
>
> The ID of the comment.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Spreadsheet Values
>
> **Slug:** `GOOGLEDRIVE_UPDATE_SPREADSHEET_VALUES`
>
> Write values to one exact Google Sheets range.
>
> #### Input Parameters
>
> **range** `string` *required*
>
> The exact A1 notation of the range to update, such as 'Sheet1!A1:C2'.
>
> **values** `array` *required*
>
> Values to write. The outer list follows major\_dimension. A null skips the corresponding cell; an empty string writes an empty value.
>
> **spreadsheet\_id** `string` *required*
>
> The Google Spreadsheet ID from its URL.
>
> **major\_dimension** `string ("ROWS" | "COLUMNS")`
>
> Whether each inner values list represents a row or a column.
>
> **value\_input\_option** `string ("RAW" | "USER_ENTERED")` *required*
>
> How Google Sheets interprets input: RAW stores values as supplied; USER\_ENTERED parses them as if entered in the Sheets UI.
>
> **include\_values\_in\_response** `boolean`
>
> Whether the response should include the resulting cell values in updated\_data.
>
> **response\_value\_render\_option** `string ("FORMATTED_VALUE" | "UNFORMATTED_VALUE" | "FORMULA")`
>
> How returned values are rendered when include\_values\_in\_response is true.
>
> **response\_date\_time\_render\_option** `string ("SERIAL_NUMBER" | "FORMATTED_STRING")`
>
> How returned dates, times, and durations are rendered when values are unformatted.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Team Drive (Deprecated)
>
> **Slug:** `GOOGLEDRIVE_UPDATE_TEAM_DRIVE`
>
> Tool to update a Team Drive's metadata. Deprecated: Use the drives.update endpoint instead. Use when you need to modify Team Drive properties.
>
> #### Input Parameters
>
> **name** `string`
>
> The name of this Team Drive.
>
> **themeId** `string`
>
> The ID of the theme from which the background image and color will be set. This is a write-only field; it can only be set on requests that don't set colorRgb or backgroundImageFile.
>
> **colorRgb** `string`
>
> The color of this Team Drive as an RGB hex string. It can only be set on a drive.teamdrives.update request that does not set themeId.
>
> **teamDriveId** `string` *required*
>
> The ID of the Team Drive to update.
>
> **restrictions** `object`
>
> A set of restrictions that apply to this Team Drive or items inside this Team Drive.
>
> **backgroundImageFile** `object`
>
> An image file and cropping parameters from which a background image for this Team Drive is set. This is a write only field; it can only be set on drive.teamdrives.update requests that don't set themeId.
>
> **useDomainAdminAccess** `boolean`
>
> Issue the request as a domain administrator; if set to true, then the requester will be granted access if they are an administrator of the domain to which the Team Drive belongs.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upload File
>
> **Slug:** `GOOGLEDRIVE_UPLOAD_FILE`
>
> Upload a new file to Google Drive, optionally placing it in a specified folder. If no folder ID is provided, it is uploaded to the Drive root.
>
> #### Input Parameters
>
> **file\_to\_upload** `object` *required*
>
> File to upload to Google Drive (max 5MB). Use a clear filename and accurate MIME type, for example `application/pdf`; incorrect values can cause Drive to convert or misrender the file.
>
> **folder\_to\_upload\_to** `string`
>
> Optional ID of the target Google Drive folder; can be obtained using 'Find Folder' or similar actions. Invalid or missing IDs silently fall back to Drive root with no error — resolve the correct folder ID first using GOOGLEDRIVE\_FIND\_FILE.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upload File from URL to Drive
>
> **Slug:** `GOOGLEDRIVE_UPLOAD_FROM_URL`
>
> Tool to fetch a file from a provided URL server-side and upload it into Google Drive. Use when you need to reliably persist externally hosted files into Drive without client-side downloads or temporary storage.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Name for the file in Google Drive, including extension (e.g., 'report.pdf', 'image.png').
>
> **mime\_type** `string`
>
> Target MIME type for the file in Google Drive. If not specified, Drive auto-detects from content. Google Workspace MIME types (application/vnd.google-apps.\*) trigger automatic conversion from compatible source formats: google-apps.document converts Word/ODT/HTML/RTF/TXT/PDF/images (OCR); google-apps.spreadsheet converts Excel/ODS/CSV/TSV; google-apps.presentation converts PowerPoint/ODP. Conversion requires the source content to be in a compatible format. Incompatible formats will cause upload errors.
>
> **source\_url** `string` *required*
>
> HTTPS URL of the file to download and upload to Google Drive. Must be publicly accessible or include necessary authentication in source\_headers.
>
> **verify\_ssl** `boolean`
>
> Whether to verify SSL certificates when downloading from HTTPS URLs. Set to false to bypass SSL verification for URLs with certificate issues (expired certificates, hostname mismatches, self-signed certificates). Only disable for trusted sources.
>
> **source\_headers** `object`
>
> Optional HTTP headers to include when downloading from source\_url. Use for authentication tokens, signed URLs, or CDN-specific headers.
>
> **parent\_folder\_id** `string`
>
> ID of the parent folder in Google Drive. If not specified, the file will be uploaded to the root of My Drive.
>
> **supports\_all\_drives** `boolean`
>
> Whether the request supports both My Drives and shared drives. Defaults to true for broader compatibility.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upload/Update File Content
>
> **Slug:** `GOOGLEDRIVE_UPLOAD_UPDATE_FILE`
>
> Tool to update file content in Google Drive by uploading new binary content. Use when you need to replace the contents of an existing file with new file data.
>
> #### Input Parameters
>
> **fileId** `string` *required*
>
> The ID of the file to update with new content.
>
> **addParents** `string`
>
> Comma-separated list of parent folder IDs to add.
>
> **uploadType** `string`
>
> The type of upload request. 'media' for simple upload (content only), 'multipart' for metadata + content, 'resumable' for large files.
>
> **ocrLanguage** `string`
>
> Language hint for OCR processing (ISO 639-1 code, e.g., 'en').
>
> **removeParents** `string`
>
> Comma-separated list of parent folder IDs to remove.
>
> **file\_to\_upload** `object` *required*
>
> The file content to upload.
>
> **supportsAllDrives** `boolean`
>
> Whether the app supports both My Drives and shared drives. Defaults to true.
>
> **keepRevisionForever** `boolean`
>
> Whether to set the 'keepForever' field in the new head revision.
>
> **useContentAsIndexableText** `boolean`
>
> Whether to use the uploaded content as indexable text for search.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Watch Drive Changes
>
> **Slug:** `GOOGLEDRIVE_WATCH_CHANGES`
>
> Subscribe to Google Drive changes for a user or shared drive and receive notifications at a webhook URL. Supply a start or continuation page token; notifications may cover multiple changes, so fetch changes since the last known token.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> A unique string that identifies this channel. UUIDs are recommended. Must be unique per active channel; reusing an ID can cause missed, delayed, or duplicate notifications.
>
> **type** `string` *required*
>
> The type of delivery mechanism for notifications.
>
> **token** `string`
>
> An arbitrary string that will be delivered with each notification. Can be used for verification.
>
> **params** `object`
>
> Optional parameters for the notification channel. Example: \{"additional\_properties": \{"ttl": "3600"}} for a 1-hour time-to-live (actual support depends on Google API).
>
> **spaces** `string`
>
> A comma-separated list of spaces to query within the corpora. Supported values are 'drive' and 'appDataFolder'.
>
> **address** `string` *required*
>
> The URL where notifications are to be delivered. Must be a publicly reachable HTTPS URL with a valid SSL certificate; HTTP, localhost, and private network endpoints are rejected by the API.
>
> **drive\_id** `string`
>
> The shared drive from which changes will be returned. If specified, change IDs will be specific to the shared drive.
>
> **page\_size** `integer`
>
> The maximum number of changes to return per page.
>
> **expiration** `integer`
>
> Timestamp in milliseconds since the epoch for when the channel should expire. If not set, channel may not expire or have a default expiration. Channels are invalidated after expiry; re-establish the watch with a new channel before or after expiration to avoid missed changes.
>
> **page\_token** `string`
>
> The token for continuing a previous list request on the next page. This should be set to the value of 'nextPageToken' from the previous response or to the response from the getStartPageToken method. Persist this token per channel so change processing can resume correctly after restarts or interruptions.
>
> **include\_labels** `string`
>
> A comma-separated list of IDs of labels to include in the labelInfo part of the response.
>
> **include\_removed** `boolean`
>
> Whether to include changes indicating that items have been removed from the list of changes (e.g., by deletion or loss of access).
>
> **supports\_all\_drives** `boolean`
>
> Whether the requesting application supports both My Drives and shared drives. Recommended to set to true if driveId is used or if interactions with shared drives are expected.
>
> **restrict\_to\_my\_drive** `boolean`
>
> Whether to restrict the results to changes inside the My Drive hierarchy. This omits changes to files like those in the Application Data folder or shared files not added to My Drive.
>
> **include\_corpus\_removals** `boolean`
>
> Whether changes should include the file resource if the file is still accessible by the user at the time of the request, even when a file was removed from the list of changes.
>
> **include\_permissions\_for\_view** `string`
>
> Specifies which additional view's permissions to include in the response.
>
> **include\_items\_from\_all\_drives** `boolean`
>
> Whether both My Drive and shared drive items should be included in results.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Watch File for Changes
>
> **Slug:** `GOOGLEDRIVE_WATCH_FILE`
>
> Tool to subscribe to push notifications for changes to a specific file. Use when you need to monitor a file for modifications and receive real-time notifications at a webhook URL.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> A UUID or similar unique string that identifies this notification channel (max 64 characters).
>
> **type** `string ("web_hook" | "webhook")` *required*
>
> The type of delivery mechanism used for this channel.
>
> **token** `string`
>
> An arbitrary string delivered to the target address with each notification for verification (max 256 characters).
>
> **fileId** `string` *required*
>
> The ID of the file to watch for changes.
>
> **params** `object`
>
> Additional parameters controlling delivery channel behavior.
>
> **address** `string` *required*
>
> The HTTPS address where notifications are delivered for this channel. Must have a valid SSL certificate.
>
> **payload** `boolean`
>
> Whether payload data should be included in notifications.
>
> **expiration** `integer`
>
> Date and time of notification channel expiration as Unix timestamp in milliseconds. Default: 3600 seconds, max: 86400 seconds for files.
>
> **includeLabels** `string`
>
> A comma-separated list of IDs of labels to include in the labelInfo part of the response.
>
> **acknowledgeAbuse** `boolean`
>
> Whether the user is acknowledging the risk of downloading known malware or other abusive files. Only applicable to file owner/organizer.
>
> **supportsAllDrives** `boolean`
>
> Whether the requesting application supports both My Drives and shared drives.
>
> **supportsTeamDrives** `boolean`
>
> Deprecated. Use supportsAllDrives instead.
>
> **includePermissionsForView** `string`
>
> Specifies which additional view's permissions to include in the response.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Write Spreadsheet Values
>
> **Slug:** `GOOGLEDRIVE_WRITE_SPREADSHEET_VALUES`
>
> Replace values in one range of a Google spreadsheet.
>
> #### Input Parameters
>
> **range** `string` *required*
>
> The A1 notation range whose values to replace, such as 'Sheet1!A1:B2'.
>
> **values** `array` *required*
>
> A matrix of string, number, boolean, or null cell values. Each inner list follows major\_dimension.
>
> **spreadsheet\_id** `string` *required*
>
> The ID of the Google spreadsheet to update.
>
> **major\_dimension** `string ("ROWS" | "COLUMNS")`
>
> How the values matrix is oriented. Defaults to ROWS when omitted.
>
> **value\_input\_option** `string ("RAW" | "USER_ENTERED")` *required*
>
> Required interpretation mode. RAW stores values as supplied; USER\_ENTERED parses them as if entered in Google Sheets.
>
> **include\_values\_in\_response** `boolean`
>
> Whether the response should include the values written in updatedData.
>
> **response\_value\_render\_option** `string ("FORMATTED_VALUE" | "UNFORMATTED_VALUE" | "FORMULA")`
>
> How values in updatedData are rendered when updated values are included.
>
> **response\_date\_time\_render\_option** `string ("SERIAL_NUMBER" | "FORMATTED_STRING")`
>
> How dates, times, and durations in updatedData are rendered when updated values are included.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

## Triggers

> [accordion] Comment Added (Docs/Sheets/Slides)
>
> **Slug:** `GOOGLEDRIVE_COMMENT_ADDED_TRIGGER`
>
> **Type:** poll
>
> Triggers when a new comment is added to Google Docs, Sheets, or Slides.
>
> #### Configuration
>
> **file\_id** `string`
>
> If provided, monitor comments only for this specific file ID. If omitted, the trigger scans recent Docs/Sheets/Slides files for new comments.
>
> **interval** `number`
>
> Deprecated: use `polling_interval` on the trigger instance instead. Minutes between checks for new events.
>
> **max\_files** `integer`
>
> Maximum number of recent Docs/Sheets/Slides files to inspect in each poll when no file ID is specified. Values above 100 are clamped at runtime to protect Drive quota — comments.list is a per-file fanout.
>
> #### Payload
>
> **comment\_id** `string` *required*
>
> The ID of the comment
>
> **comment\_text** `string`
>
> The plain text content of the comment
>
> **commenter** `object`
>
> Information about the commenter (displayName, permissionId, photoLink, me).
>
> **created\_time** `string`
>
> The time the comment was created (RFC 3339)
>
> **file\_id** `string` *required*
>
> The ID of the file on which the comment was added

> [accordion] File Created
>
> **Slug:** `GOOGLEDRIVE_FILE_CREATED_TRIGGER`
>
> **Type:** poll
>
> Triggers when a new file is created in Google Drive.
>
> #### Configuration
>
> **folder\_id** `string`
>
> If provided, monitor only files within this folder (by folder ID). Adds the filter `'folder_id' in parents` to the query.
>
> **interval** `number`
>
> Deprecated: use `polling_interval` on the trigger instance instead. Minutes between checks for new events.
>
> **max\_results** `integer`
>
> Maximum number of newly-created files to emit in a single poll. Acts as an event cap, not an API page size — the trigger paginates Drive responses internally.
>
> **query** `string`
>
> Optional Drive search query to filter files. Examples: name contains 'report', mimeType = 'application/pdf', or complex queries like name contains 'project' and mimeType != 'application/vnd.google-apps.folder'. Leave empty to monitor all files.
>
> #### Payload
>
> **creator** `object`
>
> Information about the file's creator (derived as first owner if available)
>
> **event\_type** `string`
>
> Type of event that occurred
>
> **file** `object` *required*
>
> The newly created Google Drive file

> [accordion] File Deleted or Trashed
>
> **Slug:** `GOOGLEDRIVE_FILE_DELETED_OR_TRASHED_TRIGGER`
>
> **Type:** poll
>
> Triggers when a file is moved to trash or permanently deleted in Drive.
>
> #### Configuration
>
> **drive\_id** `string`
>
> Optional shared drive ID to monitor. When unset, the trigger monitors My Drive plus shared drives surfaced by `include_items_from_all_drives`.
>
> **include\_corpus\_removals** `boolean`
>
> Include changes where the user lost access to the file (e.g. permission removal). When false, only true deletions and trash events surface.
>
> **include\_items\_from\_all\_drives** `boolean`
>
> Whether items from My Drive AND all visible shared drives should appear in results.
>
> **interval** `number`
>
> Deprecated: use `polling_interval` on the trigger instance instead. Minutes between checks for new events.
>
> **page\_size** `integer`
>
> Maximum number of changes per `changes.list` page (1-1000).
>
> **restrict\_to\_my\_drive** `boolean`
>
> If true, restrict results to changes inside the My Drive hierarchy.
>
> **spaces** `string`
>
> Comma-separated list of spaces to query. Supported values are 'drive' and 'appDataFolder'.
>
> #### Payload
>
> **deletion\_timestamp** `string` *required*
>
> Timestamp of the delete/trash event in RFC 3339 format
>
> **event\_type** `string` *required*
>
> Type of deletion event. Either 'trashed' (soft-delete, recoverable from the user's trash) or 'removed' (hard-delete or, when include\_corpus\_removals=true, access loss).
>
> **file\_id** `string` *required*
>
> ID of the file that was deleted or trashed
>
> **name** `string`
>
> Name of the file. May be absent when the file was permanently removed (the file resource is gone, only the change record remains).

> [accordion] File Shared (Permissions Added)
>
> **Slug:** `GOOGLEDRIVE_FILE_SHARED_PERMISSIONS_ADDED`
>
> **Type:** poll
>
> Triggers when new sharing permissions are granted to a file or folder.
>
> Uses Drive's `changes.list` endpoint with inline `permissions` in the `fields` mask so each change carries the file's current permission set provider-atomically. We diff that against `seen_permission_keys` to identify newly added grants. Drive page tokens are the primary cursor; if Drive rejects a stored token, the trigger raises `PollingTriggerError` without clearing state rather than silently re-baselining and dropping events.
>
> Limitation: truly ephemeral permissions (added and revoked between two polls without any other file modification in between) are not detected. Drive Activity API would catch those but requires an additional OAuth scope and a different payload contract.
>
> #### Configuration
>
> **drive\_id** `string`
>
> The shared drive ID to monitor. If omitted, monitors My Drive and any shared drives surfaced via include\_items\_from\_all\_drives.
>
> **file\_id** `string`
>
> If provided, only emit permission changes for this specific file or folder ID.
>
> **interval** `number`
>
> Deprecated: use `polling_interval` on the trigger instance instead. Minutes between checks for new events.
>
> **page\_size** `integer`
>
> Maximum number of changes to fetch per `changes.list` page (1-1000).
>
> **supports\_all\_drives** `boolean`
>
> Whether to include both My Drive and shared drives when monitoring changes.
>
> #### Payload
>
> **event\_type** `string`
>
> Type of event that occurred
>
> **new\_permissions** `array`
>
> List of newly detected permissions

> [accordion] File Updated
>
> **Slug:** `GOOGLEDRIVE_FILE_UPDATED_TRIGGER`
>
> **Type:** poll
>
> Triggers when a file's metadata or content changes in Google Drive.
>
> #### Configuration
>
> **content\_only** `boolean`
>
> When true, fire only on content changes (new revision) and suppress metadata-only updates such as rename or move. Relies on `headRevisionId`, which Drive only exposes for binary files — Google-native docs (Docs/Sheets/Slides) do not carry `headRevisionId` and will not fire this trigger under `content_only=true`.
>
> **drive\_id** `string`
>
> Optional shared drive ID to monitor. When unset, the trigger monitors My Drive plus shared drives surfaced by `include_items_from_all_drives`.
>
> **include\_items\_from\_all\_drives** `boolean`
>
> Whether items from My Drive AND all visible shared drives should appear in results.
>
> **interval** `number`
>
> Deprecated: use `polling_interval` on the trigger instance instead. Minutes between checks for new events.
>
> **page\_size** `integer`
>
> Maximum number of changes per `changes.list` page (1-1000).
>
> #### Payload
>
> **file\_id** `string` *required*
>
> The ID of the file that changed
>
> **last\_modifying\_user** `object`
>
> Information about the last user who modified the file
>
> **modified\_time** `string`
>
> The last time the file was modified (RFC 3339 date-time)

> [accordion] Google Drive Changes
>
> **Slug:** `GOOGLEDRIVE_GOOGLE_DRIVE_CHANGES`
>
> **Type:** poll
>
> Triggers when changes are detected in a Google Drive.
>
> #### Configuration
>
> **drive\_id** `string`
>
> Optional shared drive ID to monitor. When unset, the trigger monitors the user's My Drive plus any shared drives surfaced by `include_items_from_all_drives`.
>
> **include\_items\_from\_all\_drives** `boolean`
>
> Whether items from My Drive AND all visible shared drives should appear in results. Required for shared-drive coverage.
>
> **interval** `number`
>
> Deprecated: use `polling_interval` on the trigger instance instead. Minutes between checks for new events.
>
> **restrict\_to\_my\_drive** `boolean`
>
> If true, restrict results to changes inside the My Drive hierarchy even when `include_items_from_all_drives` is true.
>
> **spaces** `string`
>
> Comma-separated list of spaces to query. Supported values are 'drive' and 'appDataFolder'.

> [accordion] New File Matching Query
>
> **Slug:** `GOOGLEDRIVE_NEW_FILE_MATCHING_QUERY_TRIGGER`
>
> **Type:** poll
>
> Triggers when a new Google Drive file matches a provided query.
>
> This is the legacy query-centric trigger: it preserves Drive API query config such as `corpora` / `driveId` aliases and emits the historical `file_matching_query` event type. `FileCreatedTrigger` covers the broader "new file" case and emits `file_created`.
>
> #### Configuration
>
> **corpora** `string`
>
> Bodies of items to which the query applies. Supported: 'user', 'domain', 'drive', 'allDrives'.
>
> **driveId** `string`
>
> ID of the shared drive to search (use with corpora='drive').
>
> **includeItemsFromAllDrives** `boolean`
>
> Include items from both My Drive and shared drives.
>
> **interval** `number`
>
> Deprecated: use `polling_interval` on the trigger instance instead. Minutes between checks for new events.
>
> **max\_results** `integer`
>
> Maximum number of newly-matching files to emit per poll. The trigger paginates Drive responses internally bounded by an internal page cap; this field caps emitted events, not API pages.
>
> **query** `string`
>
> Drive query to filter files. Examples: name contains 'report', mimeType = 'application/pdf', (name contains 'Draft' and not trashed). The query is composed with a `createdTime >= <watermark>` boundary plus ID dedup so the trigger only fires for newly created files.
>
> **spaces** `string`
>
> A comma-separated list of spaces to query within. Supported: 'drive', 'appDataFolder'.
>
> **supportsAllDrives** `boolean`
>
> Whether the requesting application supports both My Drives and shared drives.
>
> #### Payload
>
> **event\_type** `string`
>
> Type of event that occurred
>
> **file** `object` *required*
>
> The newly matched Drive file
