# Google Drive Your Toolhouse AI Worker can connect to Googledrive using 89 specialized tools. ## Auth Connection This service requires an auth connection to use its tools. You can set this up in your Toolhouse dashboard under [Auth Connections](https://toolhouse.app/auth-connections?authkit_slugs=googledrive). ## Tools (89) ### `Googledrive Add File Sharing Preference` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | -------------------- | ------- | :------: | ------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `role` | string | ✅ | `"reader"` | Permission role to grant. Accepted values: 'reader', 'commenter', 'writer', 'fileOrganizer', 'organizer', 'owner'. Invalid strings cause validation failures. | | `type` | string | ✅ | `"user"` | 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 | | `"example.com"` | Domain to grant permission to (e.g., 'example.com'). Required if 'type' is 'domain'. | | `file_id` | string | ✅ | `"1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms"` | 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 | | `"user@example.com"` | 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. | *** ### `Googledrive Add Parent` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | --------------------- | ------- | :------: | ------------------------------------------------ | ----------------------------------------------------------------------------------------------- | | `id` | string | ✅ | `"1WKV9eNX4QggD5THTud3YMeN3Z7cP0CHf"` | The ID of the parent folder to add. This is the folder that will become a parent of the file. | | `fileId` | string | ✅ | `"1FT9IW4UpvEc4Ezxv8xS2jEda17MztBXzK7CMqfz-s98"` | 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. | *** ### `Googledrive Add Property` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | ----------------- | ------- | :------: | ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | `alt` | string | | — | 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 | | — | V1 error format values. | | `fields` | string | | — | Selector specifying which fields to include in a partial response. | | `fileId` | string | ✅ | `"1FT9IW4UpvEc4Ezxv8xS2jEda17MztBXzK7CMqfz-s98"` | 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"` | 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 | ✅ | `"test_property"` | The key of this property. | | `property_value` | string | ✅ | `"test_value"` | The value of this property. | | `upload_protocol` | string | | — | Upload protocol for media (e.g. 'raw', 'multipart'). | *** ### `Googledrive Copy File` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | ----------- | ------ | :------: | ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `file_id` | string | ✅ | `"1A2b3C4d5E6fG7h8I9j0KlMNOPqRstUVW"` | 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 | | `"Copy of Quarterly Report"` | 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 '. | *** ### `Googledrive Copy File Advanced` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | ------------------------------ | ------- | :------: | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `alt` | string | | — | 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 | | — | V1 error format options. | | `fields` | string | | — | Selector specifying which fields to include in a partial response. Use comma-separated field paths. | | `fileId` | string | ✅ | `"1A2b3C4d5E6fG7h8I9j0KlMNOPqRstUVW"` | 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. | *** ### `Googledrive Create Comment` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | ------------------------------- | ------ | :------: | -------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `anchor` | string | | `"{\"region\": {\"kind\": \"drive#commentRegion\", \"line\": 12, \"rev\": \"head\"}}"` | A JSON string defining the region of the document to which the comment is anchored. Format: {"region": {"kind": "drive#commentRegion", "": , "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 | ✅ | `"This is a great document!"` | The plain text content of the comment. | | `file_id` | string | ✅ | `"1a2b3c4d5e6f7g8h9i0j"` | The ID of the file. The `id` field from GOOGLEDOCS\_SEARCH\_DOCUMENTS results can be used directly without conversion. | | `quoted_file_content_value` | string | | `"This is the text to quote."` | The quoted content itself. | | `quoted_file_content_mime_type` | string | | `"text/plain"` | The MIME type of the quoted content. | *** ### `Googledrive Create Drive` Integration name: **GOOGLEDRIVE\_CREATE\_DRIVE** Tool to create a new shared drive. Use when you need to programmatically create a new shared drive for collaboration or storage. #### Parameters | Parameter | Type | Required | Example | Description | | --------------------- | ------- | :------: | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `name` | string | ✅ | `"My New Shared Drive"` | The name of this shared drive. | | `hidden` | boolean | | — | Whether the shared drive is hidden from default view. | | `themeId` | string | | `"default"` | 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 | | `"#FF0000"` | 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 | | `"your-unique-request-id-123"` | 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. | *** ### `Googledrive Create File` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | ---------------- | ------- | :------: | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `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 | | — | 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. FileUploadable object where 'name' is the filename (can override the 'name' parameter above). 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.). | *** ### `Googledrive Create File From Text` Integration name: **GOOGLEDRIVE\_CREATE\_FILE\_FROM\_TEXT** Creates a new file in Google Drive from provided text content (up to 10MB), supporting various formats including automatic conversion to Google Workspace types. Returns flat metadata fields (`id`, `mimeType`, `name`) at the top level — not nested under a `file` object. Created files are private by default; use a sharing tool afterward for collaborative access. Rapid successive calls may trigger `403 rateLimitExceeded` or `429 userRateLimitExceeded`; apply exponential backoff between retries. Does not support shared-drive targets in all cases. #### Parameters | Parameter | Type | Required | Example | Description | | -------------- | ------ | :------: | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `file_name` | string | ✅ | `"meeting_notes.txt"` | Required. Desired name for the new file on Google Drive. Also accepts 'title' or 'name' as aliases. | | `mime_type` | string | | `"text/plain"` | 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 | | `"1KMXpS5g9N04W44_1T7_IDN18V8x00AKE"` | 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. 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. | *** ### `Googledrive Create Folder` Integration name: **GOOGLEDRIVE\_CREATE\_FOLDER** Creates a new folder in Google Drive, optionally within an EXISTING parent folder specified by its ID or name. The parent folder MUST already exist - use GOOGLEDRIVE\_FIND\_FOLDER first to verify the parent exists or find its ID. Google Drive permits duplicate folder names, so always store and reuse the folder ID returned by this action rather than relying on names for future lookups. #### Parameters | Parameter | Type | Required | Example | Description | | ----------- | ------ | :------: | ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `name` | string | ✅ | `"Project Files"` | Name for the new folder. This is a required field. | | `parent_id` | string | | `"1A2b3C4d5E6fG7h8I9j0KlMNOPqRstUVW"` | 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. | *** ### `Googledrive Create Permission` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | ------------------------- | ------- | :------: | ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `role` | string | ✅ | `"reader"` | The role granted by this permission. Valid values are: owner, organizer, fileOrganizer, writer, commenter, reader. | | `type` | string | ✅ | `"user"` | 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 | | `"example.com"` | The domain to which this permission refers. Required when type is 'domain'. | | `file_id` | string | ✅ | `"1Cw6BhxeaUWjjuXJNFniIE0aPxS6y3BZgwQtdmr43tAY"` | The ID of the file or shared drive. | | `email_address` | string | | `"user@example.com"` | The email address of the user or group to which this permission refers. Required when type is 'user' or 'group'. | | `email_message` | string | | `"Check out this document!"` | A plain text custom message to include in the notification email. | | `expiration_time` | string | | `"2024-12-31T23:59:59Z"` | 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. | *** ### `Googledrive Create Reply` Integration name: **GOOGLEDRIVE\_CREATE\_REPLY** Tool to create a reply to a comment in Google Drive. Use when you need to respond to an existing comment on a file. #### Parameters | Parameter | Type | Required | Example | Description | | ------------ | ------ | :------: | ---------------------------------------- | ------------------------------------------------------------------- | | `action` | string | | `"resolve"` | The action the reply performed to the parent comment. | | `fields` | string | | `"id,content"` | Selector specifying which fields to include in a partial response. | | `content` | string | ✅ | `"Thanks for the feedback!"` | The plain text content of the reply. HTML content is not supported. | | `file_id` | string | ✅ | `"1234567890abcdefghijklmnopqrstuvwxyz"` | The ID of the file. | | `comment_id` | string | ✅ | `"0987654321zyxwutsrqponmlkjihgfedcba"` | The ID of the comment. | *** ### `Googledrive Create Shortcut To File` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | --------------------------- | ------- | :------: | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | | `name` | string | ✅ | `"My Shortcut to Important Document"` | The name of the shortcut. | | `target_id` | string | ✅ | `"1_DRbC10_AYSg3tNA2c2P9H2a26n9_2VA"` | The ID of the file or folder that this shortcut points to. | | `includeLabels` | string | | `"labelId1,labelId2"` | A comma-separated list of IDs of labels to include in the labelInfo part of the response. | | `supportsAllDrives` | boolean | | `true` | Whether the requesting application supports both My Drives and shared drives. Recommended to set to true if interacting with shared drives. | | `keepRevisionForever` | boolean | | `false` | Whether to set the 'keepForever' field in the new head revision. | | `ignoreDefaultVisibility` | boolean | | `false` | Whether to ignore the domain's default visibility settings for the created file. | | `includePermissionsForView` | string | | `"published"` | Enum for includePermissionsForView parameter. | *** ### `Googledrive Create Team Drive` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | --------------------- | ------ | :------: | ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `name` | string | ✅ | `"My New Team Drive"` | The name of this Team Drive. This is a required field. | | `themeId` | string | | `"default"` | 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 | | `"#FF0000"` | 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 | | `"your-unique-request-id-123"` | 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. | *** ### `Googledrive Delete Child` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | --------------------- | ------- | :------: | ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | `alt` | string | | — | 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 | | — | V1 error format enum. | | `fields` | string | | — | Selector specifying which fields to include in a partial response. | | `childId` | string | ✅ | `"1FT9IW4UpvEc4Ezxv8xS2jEda17MztBXzK7CMqfz-s98"` | The ID of the child. | | `callback` | string | | — | JSONP | | `folderId` | string | ✅ | `"1WKV9eNX4QggD5THTud3YMeN3Z7cP0CHf"` | 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. | *** ### `Googledrive Delete Comment` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | ------------ | ------ | :------: | ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `file_id` | string | ✅ | `"1a2b3c4d5e6f7g8h9i0j"` | The ID of the file. | | `comment_id` | string | ✅ | `"AAAByC37kko"` | 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. | *** ### `Googledrive Delete Drive` Integration name: **GOOGLEDRIVE\_DELETE\_DRIVE** Tool to permanently delete a shared drive. Use when you need to remove a shared drive and its contents (if specified). #### Parameters | Parameter | Type | Required | Example | Description | | ---------------------- | ------- | :------: | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `driveId` | string | ✅ | `"0AEMyflX29xHjUk9PVA"` | The ID of the shared drive. | | `allowItemDeletion` | boolean | | `true` | 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 | | `true` | 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. | *** ### `Googledrive Delete File` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | --------------------- | ------- | :------: | ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `fileId` | string | ✅ | `"1xiFp6uO3jRczGuFJ_LdaRVg3ene6lNq-"` | 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. | *** ### `Googledrive Delete Parent` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | --------------------- | ------- | :------: | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | `alt` | string | | — | 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 | | — | V1 error format enum. | | `fields` | string | | — | Selector specifying which fields to include in a partial response. | | `fileId` | string | ✅ | `"1xygSVDktMDb4chxS3AQTMzABKWYdWtOB"` | The ID of the file. | | `callback` | string | | — | JSONP | | `parentId` | string | ✅ | `"1IL1JRSfkm9B_L-guI7g-birKApFyD_Di"` | 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. | *** ### `Googledrive Delete Permission` Integration name: **GOOGLEDRIVE\_DELETE\_PERMISSION** Deletes a permission from a file by permission ID. Deletion is irreversible — confirm the target user, group, or permission type before executing. IMPORTANT: You must first call GOOGLEDRIVE\_LIST\_PERMISSIONS to get valid permission IDs. To fully revoke public access, the type='anyone' (link-sharing) permission must be explicitly deleted; revoking other permissions leaves the file publicly accessible via link. Use when you need to revoke access for a specific user or group from a file. #### Parameters | Parameter | Type | Required | Example | Description | | ---------------------- | ------- | :------: | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `file_id` | string | ✅ | `"1a2b3c4d5e6f7g8h9i0j"` | The ID of the file or shared drive. | | `permission_id` | string | ✅ | `"18394857362947583"` | 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. | *** ### `Googledrive Delete Property` Integration name: **GOOGLEDRIVE\_DELETE\_PROPERTY** Tool to delete a property from a file using Google Drive API v2. Use when you need to remove custom key-value metadata from a file. #### Parameters | Parameter | Type | Required | Example | Description | | ----------------- | ------- | :------: | ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | `alt` | string | | — | 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 | | — | V1 error format values. | | `fields` | string | | — | Selector specifying which fields to include in a partial response. | | `fileId` | string | ✅ | `"1FT9IW4UpvEc4Ezxv8xS2jEda17MztBXzK7CMqfz-s98"` | 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 | ✅ | `"test_delete_property"` | The key of the property to delete. | | `access_token` | string | | — | OAuth access token. | | `upload_protocol` | string | | — | Upload protocol for media (e.g. 'raw', 'multipart'). | *** ### `Googledrive Delete Reply` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | ------------ | ------ | :------: | ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | | `file_id` | string | ✅ | `"1ZdR3L3Kek7szY1j11SQZ9A_00up1j2xG"` | The ID of the file. | | `reply_id` | string | ✅ | `"AAAA_example_reply_id"` | 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 | ✅ | `"AAAA_example_comment_id"` | The ID of the comment. | *** ### `Googledrive Delete Revision` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | ------------- | ------ | :------: | ------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `file_id` | string | ✅ | `"19GP5DRpUcmQHBVnk39RTB57twIWVEMjO"` | The ID of the file. | | `revision_id` | string | ✅ | `"0B_vaZgd8EyufZ0xKU1BBemkvQnNBL0hESWdiY3VTWWQxNWRFPQ"` | 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. | *** ### `Googledrive Delete Team Drive` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | ------------- | ------ | :------: | ----------------------- | ----------------------------------- | | `teamDriveId` | string | ✅ | `"0AIHqBGLiYNb7Uk9PVA"` | The ID of the Team Drive to delete. | *** ### `Googledrive Download File` Integration name: **GOOGLEDRIVE\_DOWNLOAD\_FILE** Downloads a file from Google Drive by its ID. For Google Workspace documents (Docs, Sheets, Slides), optionally exports to a specified `mime_type`. For other file types, downloads in their native format regardless of mime\_type. Examples: Export a Google Doc to plain text: {"file\_id": "1N2o5xQWmAbCdEfGhIJKlmnOPq", "mime\_type": "text/plain"} Download a Google Sheet as CSV: {"file\_id": "1ZyXwVuTsRqPoNmLkJiHgFeDcB", "mime\_type": "text/csv"} #### Parameters | Parameter | Type | Required | Example | Description | | ----------- | ------ | :------: | ----------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `fileId` | string | ✅ | `"1aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789"` | 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/pdf"` | 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. | *** ### `Googledrive Download File2` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | --------- | ------ | :------: | ------------------------------------- | ------------------------------ | | `file_id` | string | ✅ | `"1iau-j_ezb2Vcx1tZDMDdfpqlzxVzlscg"` | The ID of the file to download | *** ### `Googledrive Download File Operation` Integration name: **GOOGLEDRIVE\_DOWNLOAD\_FILE\_OPERATION** Tool to download file content using long-running operations. Use when you need to download Google Vids files or export Google Workspace documents as part of a long-running operation. Operations are valid for 24 hours from creation. Returns a response containing `downloaded_file_content.s3url` — a short-lived S3 URL; fetch the actual file bytes from that URL promptly after the call. #### Parameters | Parameter | Type | Required | Example | Description | | ------------- | ------ | :------: | ------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `file_id` | string | ✅ | `"1xAHUNyfubIa8K07EVv9_5Hc5EsgdIhUx-QNcrGJ_yQk"` | 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 | | `"application/pdf"` | 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 | | `"1"` | 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. | *** ### `Googledrive Edit File` Integration name: **GOOGLEDRIVE\_EDIT\_FILE** Updates an existing Google Drive file with binary content by overwriting its entire content with new text (max 10MB). IMPORTANT: This action only works with files that have binary content (text files, PDFs, images, etc.). It does NOT support editing Google Workspace native files (Google Docs, Sheets, Slides, etc.). For Google Workspace files, use the Google Docs API, Google Sheets API, or Google Slides API directly. Preserves the original file\_id (unlike GOOGLEDRIVE\_UPLOAD\_FILE which creates a new ID). #### Parameters | Parameter | Type | Required | Example | Description | | ----------- | ------ | :------: | -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `content` | string | ✅ | — | 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 | ✅ | — | 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 | | `"text/plain"` | 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. | *** ### `Googledrive Empty Trash` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | --------------------- | ------- | :------: | ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `driveId` | string | | `"0ABmN4q4aF7dPUk9PVA"` | 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. | *** ### `Googledrive Export Google Workspace File` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `fileId` | string | ✅ | `"1FT9IW4UpvEc4Ezxv8xS2jEda17MztBXzK7CMqfz-s98"` | 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/pdf"` | 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. | *** ### `Googledrive Find File` Integration name: **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" #### Parameters | Parameter | Type | Required | Example | Description | | ------------------------------ | ------- | :------: | ------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `q` | string | | `"name = 'Budget 2024'"` | 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: "'' in owners" or "'' in writers" or "'' in readers" - INCORRECT: "owner:" (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 | | `"drive"` | A comma-separated list of spaces to query. Supported values are 'drive', 'appDataFolder' and 'photos'. | | `corpora` | string | | `"user"` | 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 | | `"modifiedTime desc"` | 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 | | `10` | The maximum number of files to return per page. | | `folder_id` | string | | `"1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms"` | 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 | | `"label_abc123"` | 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 | | `"published"` | 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. | *** ### `Googledrive Find Folder` Integration name: **GOOGLEDRIVE\_FIND\_FOLDER** Tool to find a folder in Google Drive by its name and optionally a parent folder. Use when you need to locate a specific folder to perform further actions like creating files in it or listing its contents. #### Parameters | Parameter | Type | Required | Example | Description | | ------------------------ | ------- | :------: | -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `starred` | boolean | | — | Set to true to search for folders that are starred, or false for those that are not. | | `name_exact` | string | | `"Project Alpha"` | 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. | | `name_contains` | string | | `"report"` | A substring to search for within folder names as a string. This search is case-insensitive. | | `modified_after` | string | | `"2023-08-01T00:00:00Z"` | 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 | | `"1aBcDeFgHiJkLmNoPqRsTuVwXyZ"` | 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 | | `"archive"` | 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 | | `"confidential project details"` | 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 | | `"draft"` | 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. | *** ### `Googledrive Generate Ids` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | --------- | ------- | :------: | --------- | ----------------------------------------------------------------------------------------- | | `type` | string | | `"files"` | The type of items for which the IDs can be used. For example, 'files' or 'shortcuts'. | | `count` | integer | | `10` | The number of IDs to return. Value must be between 1 and 1000, inclusive. | | `space` | string | | `"drive"` | The space in which the IDs can be used. Supported values are 'drive' and 'appDataFolder'. | *** ### `Googledrive Get About` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | --------- | ------ | :------: | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `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. | *** ### `Googledrive Get App` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | --------- | ------ | :------: | -------- | ---------------------------------------------------------- | | `appId` | string | ✅ | `"self"` | The ID of the app. Use 'self' to refer to the calling app. | *** ### `Googledrive Get Change` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | -------------------- | ------- | :------: | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | `alt` | string | | — | 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 | | — | 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 | ✅ | `"50"` | 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. | *** ### `Googledrive Get Changes Start Page Token` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | -------------------- | ------- | :------: | -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | | `driveId` | string | | `"0AB_CD1234EFG5HIJ6KLM7N8PQRST9UVWX"` | The ID of the shared drive for which the starting pageToken for listing future changes from that shared drive will be returned. | | `teamDriveId` | string | | `"0AB_CD1234EFG5HIJ6KLM7N8PQRST9UVWX"` | Deprecated: Use driveId instead. | | `supportsAllDrives` | boolean | | `true` | Whether the requesting application supports both My Drives and shared drives. Defaults to false. | | `supportsTeamDrives` | boolean | | `true` | Deprecated: Use supportsAllDrives instead. | *** ### `Googledrive Get Child` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | ----------------- | ------- | :------: | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | `alt` | string | | — | 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 | | — | V1 error format options. | | `fields` | string | | — | Selector specifying which fields to include in a partial response. | | `childId` | string | ✅ | `"1iau-j_ezb2Vcx1tZDMDdfpqlzxVzlscg"` | The ID of the child. | | `callback` | string | | — | JSONP callback parameter. | | `folderId` | string | ✅ | `"0APvaZgd8EyufUk9PVA"` | 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'). | *** ### `Googledrive Get Comment` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | ---------------- | ------- | :------: | ---------------------------------- | --------------------------------------------------------------------------------------------- | | `fileId` | string | ✅ | `"1a2b3c4d5e6f7g8h9i0j"` | The ID of the file. | | `commentId` | string | ✅ | `"11a22b33c44d55e66f77g88h99i00j"` | The ID of the comment. | | `includeDeleted` | boolean | | — | Whether to return deleted comments. Deleted comments will not include their original content. | *** ### `Googledrive Get Drive` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | ------------------------- | ------- | :------: | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `drive_id` | string | ✅ | `"0ABCA123456789"` | The ID of the shared drive. | | `use_domain_admin_access` | boolean | | `true` | 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. | *** ### `Googledrive Get File Metadata` Integration name: **GOOGLEDRIVE\_GET\_FILE\_METADATA** Tool to get a file's metadata by ID. Use to verify `mimeType`, `parents`, and `trashed` status before destructive operations (delete/move/export), or to confirm `mimeType='application/vnd.google-apps.document'` before calling GOOGLEDOCS\_\* tools (non-native files require GOOGLEDRIVE\_DOWNLOAD\_FILE). Only returns metadata visible to the connected account; public access requires GOOGLEDRIVE\_ADD\_FILE\_SHARING\_PREFERENCE. High-frequency calls risk `403 rateLimitExceeded`; apply exponential backoff. #### Parameters | Parameter | Type | Required | Example | Description | | --------------------------- | ------- | :------: | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `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 | ✅ | `"1a2b3c4d5e6f7g8h9i0j"` | 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. | *** ### `Googledrive Get File Property` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | ------------- | ------ | :------: | ------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- | | `fileId` | string | ✅ | `"1FT9IW4UpvEc4Ezxv8xS2jEda17MztBXzK7CMqfz-s98"` | 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 | ✅ | `"test_key"` | The key of the property. | *** ### `Googledrive Get File V2` Integration name: **GOOGLEDRIVE\_GET\_FILE\_V2** DEPRECATED: Use GetFileMetadata instead. Tool to get a file's metadata or content by ID from Google Drive API v2. Use when you need file metadata with alt=json, or file content with alt=media. #### Parameters | Parameter | Type | Required | Example | Description | | --------------------------- | ------- | :------: | ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | `alt` | string | | — | 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 | | — | V1 error format values. | | `fields` | string | | — | Selector specifying which fields to include in a partial response. | | `fileId` | string | ✅ | `"1FT9IW4UpvEc4Ezxv8xS2jEda17MztBXzK7CMqfz-s98"` | 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 | | — | 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. | *** ### `Googledrive Get Parent` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | ----------------- | ------- | :------: | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | `alt` | string | | — | 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 | | — | V1 error format options. | | `fields` | string | | — | Selector specifying which fields to include in a partial response. | | `fileId` | string | ✅ | `"1xygSVDktMDb4chxS3AQTMzABKWYdWtOB"` | The ID of the file. | | `callback` | string | | — | JSONP callback parameter. | | `parentId` | string | ✅ | `"0APvaZgd8EyufUk9PVA"` | 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'). | *** ### `Googledrive Get Permission` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | ------------------------- | ------- | :------: | ------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `fields` | string | | `"id,emailAddress,displayName,role,permissionDetails"` | Selector specifying which fields to include in a partial response. Use 'fields=\*' to return all available fields for the permission resource. | | `file_id` | string | ✅ | `"1a2b3c4d5e6f7g8h9i0j"` | The ID of the file. | | `permission_id` | string | ✅ | `"12345678901234567890"` | 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. | *** ### `Googledrive Get Permission Id For Email` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | ----------------- | ------- | :------: | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | `alt` | string | | — | 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 | ✅ | `"test@example.com"` | The email address for which to return a permission ID | | `xgafv` | string | | — | V1 error format values. | | `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'). | *** ### `Googledrive Get Reply` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | ---------------- | ------- | :------: | ----------------------------------------- | ------------------------------------------------------------------------------------------- | | `fileId` | string | ✅ | `"1aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789"` | The ID of the file. | | `replyId` | string | ✅ | `"CCCCCCDDDDDD"` | The ID of the reply. | | `commentId` | string | ✅ | `"AAAAAABBBBBB"` | The ID of the comment. | | `includeDeleted` | boolean | | — | Whether to return deleted replies. Deleted replies will not include their original content. | *** ### `Googledrive Get Revision` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | ------------------- | ------- | :------: | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `file_id` | string | ✅ | `"1ZdR3L3Kek7szY1G1-2VUX8cW6CnU0c4a"` | The ID of the file. | | `revision_id` | string | ✅ | `"0B9B5CLMDv-N4Z2FhY0E5RUQzNVE"` | 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. | *** ### `Googledrive Get Team Drive` Integration name: **GOOGLEDRIVE\_GET\_TEAM\_DRIVE** Tool to get metadata about a Team Drive by ID. Deprecated: Use the drives.get endpoint instead. #### Parameters | Parameter | Type | Required | Example | Description | | ---------------------- | ------- | :------: | ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `teamDriveId` | string | ✅ | `"0AMndV9-YuXjwUk9PVA"` | 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. | *** ### `Googledrive Google Drive Delete Folder Or File Action` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | ------------------- | ------- | :------: | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `fileId` | string | ✅ | `"1XyZAbcDefGhiJklMnoPqRsTuVwXyZAbcDef"` | 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. | *** ### `Googledrive Hide Drive` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ----------------------- | --------------------------- | | `drive_id` | string | ✅ | `"0AEMgNk_8MPnAUk9PVA"` | The ID of the shared drive. | *** ### `Googledrive Insert Child` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | --------------------- | ------- | :------: | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | `id` | string | ✅ | `"19GP5DRpUcmQHBVnk39RTB57twIWVEMjO"` | The ID of the child file to insert into the folder. | | `alt` | string | | — | 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 | | — | V1 error format options. | | `fields` | string | | — | Selector specifying which fields to include in a partial response. | | `callback` | string | | — | JSONP callback parameter. | | `folderId` | string | ✅ | `"1IL1JRSfkm9B_L-guI7g-birKApFyD_Di"` | 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. | *** ### `Googledrive List Access Proposals` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | ----------- | ------- | :------: | ------------------------------------- | ----------------------------------------------------- | | `fileId` | string | ✅ | `"1lu9-CzH7k2a_ktFQvt8xfYM1L0FVGJx6"` | 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 | *** ### `Googledrive List Approvals` Integration name: **GOOGLEDRIVE\_LIST\_APPROVALS** Tool to list approvals on a file for workflow-based access control. Use when you need to retrieve all approvals associated with a specific file in Google Drive. #### Parameters | Parameter | Type | Required | Example | Description | | ----------- | ------- | :------: | ------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `fileId` | string | ✅ | `"1xAHUNyfubIa8K07EVv9_5Hc5EsgdIhUx-QNcrGJ_yQk"` | 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. | *** ### `Googledrive List Changes` Integration name: **GOOGLEDRIVE\_LIST\_CHANGES** Tool to list the changes for a user or shared drive. Use when a full incremental change feed is needed (for simple recent-file lookups, prefer GOOGLEDRIVE\_FIND\_FILE instead). Tracks modifications such as creations, deletions, or permission changes. The pageToken is optional - if not provided, the current start page token will be automatically fetched; an empty result is valid if no recent activity has occurred. Example usage: `json { "pageToken": "22633", "pageSize": 100, "includeRemoved": true }` Returns changes with timestamps, file IDs, and modification details. Paginate by following `nextPageToken` until it is absent — stopping early will silently omit changes. Save `newStartPageToken` to monitor future changes efficiently. #### Parameters | Parameter | Type | Required | Example | Description | | --------------------------- | ------- | :------: | ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `spaces` | string | | `"drive,appDataFolder"` | A comma-separated list of spaces to query within the corpora. Supported values are 'drive' and 'appDataFolder'. | | `driveId` | string | | `"0AB1CDEfghijklmNOP"` | 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 | | `100` | The maximum number of changes to return per page. | | `pageToken` | string | | `"22633"` | 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 | | `"labelId1,labelId2"` | 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 | | `"published"` | Specifies which additional view's permissions to include in the response. | *** ### `Googledrive List Children V2` Integration name: **GOOGLEDRIVE\_LIST\_CHILDREN\_V2** Tool to list a folder's children using Google Drive API v2. Use when you need to retrieve all files and folders within a specific folder. #### Parameters | Parameter | Type | Required | Example | Description | | ----------------- | ------- | :------: | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `q` | string | | — | Query string for searching children. | | `alt` | string | | — | 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 | | — | 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 | ✅ | `"root"` | 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'). | *** ### `Googledrive List Comments` Integration name: **GOOGLEDRIVE\_LIST\_COMMENTS** Tool to list all comments for a file in Google Drive. Results are paginated; iterate using nextPageToken until absent to retrieve all comments. Filtering by author, content, or other criteria must be done client-side. Use commentId, createdTime, and author from results to uniquely identify comments before acting on them. #### Parameters | Parameter | Type | Required | Example | Description | | ------------------- | ------- | :------: | ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `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 | ✅ | `"1234567890abcdefghijklmnopqrstuvwxyz"` | 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). | *** ### `Googledrive List File Labels` Integration name: **GOOGLEDRIVE\_LIST\_FILE\_LABELS** Tool to list the labels already applied to a file in Google Drive. An empty labels array is a valid response indicating no labels are applied, not an error. This tool shows only applied labels; label\_id and field\_id values required by other Drive label tools must be obtained from admin configuration. #### Parameters | Parameter | Type | Required | Example | Description | | ------------- | ------- | :------: | ----------------------------------------- | ---------------------------------------------------------------- | | `file_id` | string | ✅ | `"1aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789"` | 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. | *** ### `Googledrive List File Properties` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | ----------------- | ------- | :------: | ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | `alt` | string | | — | 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 | | — | V1 error format values. | | `fields` | string | | — | Selector specifying which fields to include in a partial response. | | `fileId` | string | ✅ | `"1FT9IW4UpvEc4Ezxv8xS2jEda17MztBXzK7CMqfz-s98"` | 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'). | *** ### `Googledrive List Files` Integration name: **GOOGLEDRIVE\_LIST\_FILES** DEPRECATED: Use GOOGLEDRIVE\_FIND\_FILE instead. Tool to list a user's files and folders in Google Drive. Use this to search or browse for files and folders based on various criteria. #### Parameters | Parameter | Type | Required | Example | Description | | --------------------------- | ------- | :------: | ------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `q` | string | | `"name contains 'report' and starred = true"` | 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 | | `"id,name,mimeType"` | 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 | | `"drive,appDataFolder"` | 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 | | `"user"` | 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 | | `"0ABCA123456789"` | The ID of the shared drive to search. This is used when `corpora` is set to 'drive'. | | `orderBy` | string | | `"modifiedTime desc,name"` | 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 | | `"1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms"` | 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 | | `50` | The maximum number of files to return per page. The value must be between 1 and 1000, inclusive. Defaults to 100. | | `pageToken` | string | | `" nextPageTokenValue"` | 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 | | `"labelId1,labelId2"` | A comma-separated list of label IDs to include in the `labelInfo` part of the response for each file. | | `supportsAllDrives` | boolean | | `true` | 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 | | `true` | 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 | | `"published"` | 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. | *** ### `Googledrive List Permissions` Integration name: **GOOGLEDRIVE\_LIST\_PERMISSIONS** Tool to list a file's permissions. Use when you need to retrieve all permissions associated with a specific file or shared drive. #### Parameters | Parameter | Type | Required | Example | Description | | --------------------------- | ------- | :------: | ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `fileId` | string | ✅ | `"1234567890abcdefghijklmnopqrstuvwxyz"` | 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. | *** ### `Googledrive List Replies` Integration name: **GOOGLEDRIVE\_LIST\_REPLIES** Tool to list replies to a comment in Google Drive. Use this when you need to retrieve all replies associated with a specific comment on a file. #### Parameters | Parameter | Type | Required | Example | Description | | ----------------- | ------- | :------: | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | | `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 | ✅ | `"12345abcdef"` | The ID of the file. | | `page_size` | integer | | — | The maximum number of replies to return per page. | | `comment_id` | string | ✅ | `"67890ghijkl"` | 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. | *** ### `Googledrive List Revisions` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | ------------------- | ------- | :------: | ---------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `fileId` | string | ✅ | `"1234567890abcdefghijklmnopqrstuvwxyz"` | The ID of the file. | | `pageSize` | integer | | `100` | The maximum number of revisions to return per page. | | `pageToken` | string | | `"abcdef123456"` | 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. | *** ### `Googledrive List Shared Drives` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | ---------------------- | ------- | :------: | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `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. | | `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. | *** ### `Googledrive List Team Drives` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | ---------------------- | ------- | :------: | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | | `q` | string | | — | Query string for searching Team Drives. | | `alt` | string | | — | 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 | | — | 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. | *** ### `Googledrive Modify File Labels` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | --------------------- | ------ | :------: | ------- | ------------------------------------------------------------- | | `kind` | string | | — | This is always drive#modifyLabelsRequest. | | `file_id` | string | ✅ | — | The ID of the file. | | `label_modifications` | array | ✅ | — | The list of modifications to apply to the labels on the file. | *** ### `Googledrive Move File` Integration name: **GOOGLEDRIVE\_MOVE\_FILE** Tool to move a file from one folder to another in Google Drive. To truly move (not just copy the parent), always provide both `add_parents` (destination folder ID) and `remove_parents` (source folder ID); omitting `remove_parents` leaves the file in multiple folders. Useful for reorganizing files, including newly created Google Docs/Sheets that default to Drive root. #### Parameters | Parameter | Type | Required | Example | Description | | ------------------------------- | ------- | :------: | ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `file_id` | string | ✅ | `"1XyZ..."` | The ID of the file to move. Must be a non-empty string. | | `add_parents` | string | | `"1FmTIJYwTENUDXOKyNJp7OmcRBvP_6DmT"` | The ID of the single destination folder (e.g., '1FmTIJYwTENUDXOKyNJp7OmcRBvP\_6DmT'). Must be a valid Google Drive folder ID consisting of alphanumeric characters, hyphens, and underscores. Folder names are not accepted. | | `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 | | `"folder_id_3,folder_id_4"` | A comma-separated list of parent folder IDs to remove the file from. Use this to specify the source folder. | | `supports_all_drives` | boolean | | — | Whether the requesting application supports both My Drives and shared drives. Set to true if moving files to or from a shared drive. | | `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. | *** ### `Googledrive Parse File` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | ----------- | ------ | :------: | ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `file_id` | string | ✅ | — | The unique ID of the file stored in Google Drive that you want to export or download. | | `mime_type` | string | | `"application/pdf"` | 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. | *** ### `Googledrive Patch Permission` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | ------------------------- | ------- | :------: | ------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `role` | string | | `"reader"` | Permission roles that can be granted in Google Drive. | | `file_id` | string | ✅ | `"1FT9IW4UpvEc4Ezxv8xS2jEda17MztBXzK7CMqfz-s98"` | 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 | ✅ | `"anyone"` | 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 | | `"2024-12-31T23:59:59Z"` | 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 | | `["commenter"]` | 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. | *** ### `Googledrive Patch Property` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | ----------------- | ------- | :------: | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | `alt` | string | | — | 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 | | `"updatedValue"` | The value of this property. | | `xgafv` | string | | — | V1 error format values. | | `fields` | string | | — | Selector specifying which fields to include in a partial response. | | `fileId` | string | ✅ | `"19GP5DRpUcmQHBVnk39RTB57twIWVEMjO"` | 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"` | 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 | ✅ | `"testPatchKey"` | The key of the property to update. | | `access_token` | string | | — | OAuth access token. | | `upload_protocol` | string | | — | Upload protocol for media (e.g. 'raw', 'multipart'). | *** ### `Googledrive Resumable Upload` Integration name: **GOOGLEDRIVE\_RESUMABLE\_UPLOAD** Tool to start and complete a Google Drive resumable upload session. Use for files larger than \~5 MB to avoid timeouts or size-limit failures. HTTP 308 means continue the session from the correct byte offset; HTTP 410 means the session expired and a full restart with a new session is required. #### Parameters | Parameter | Type | Required | Example | Description | | --------------------- | ------- | :------: | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `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 | | `262144` | Chunk size in bytes; must be a multiple of 256 KB. | | `queryParams` | object | | — | Optional Drive query parameters. | | `file_to_upload` | object | ✅ | — | 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. | *** ### `Googledrive Stop Watch Channel` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | ------------- | ------- | :------: | ------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | | `id` | string | ✅ | `"01234567-89ab-cdef-0123-456789abcdef"` | The ID of the channel to stop. | | `kind` | string | | `"api#channel"` | Identifies this as a notification channel used to watch for changes to a resource. | | `token` | string | | `"clientToken#0123456789"` | An arbitrary string delivered to the target address with each notification delivered over this channel. | | `params` | object | | `{"ttl":"24"}` | Additional parameters controlling delivery channel behavior. | | `address` | string | | `"https://example.com/notifications"` | The address where notifications are delivered for this channel. | | `payload` | boolean | | `true` | A Boolean value to indicate whether payload is wanted. | | `expiration` | string | | `"1426325213000"` | Date and time of notification channel expiration, expressed as a Unix timestamp, in milliseconds. | | `resourceId` | string | ✅ | `"0BwDAzcyS3R3CUlRMW0xVExQNk0"` | The ID of the resource being watched. | | `channelType` | string | | `"web_hook"` | The type of delivery mechanism used for this channel. | | `resourceUri` | string | | `"https://www.googleapis.com/drive/v3/files/0BwDAzcyS3R3CUlRMW0xVExQNk0"` | A version-specific identifier for the watched resource. | *** ### `Googledrive Trash File` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | ------------------- | ------- | :------: | ----------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | | `fields` | string | | `"id,name,trashed,trashedTime"` | 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 | ✅ | `"1aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789"` | The ID of the file to trash. | | `supportsAllDrives` | boolean | | `true` | Whether the requesting application supports both My Drives and shared drives. Defaults to true. | *** ### `Googledrive Unhide Drive` Integration name: **GOOGLEDRIVE\_UNHIDE\_DRIVE** Tool to unhide a shared drive. Use when you need to restore a shared drive to the default view. #### Parameters | Parameter | Type | Required | Example | Description | | --------- | ------ | :------: | ----------------------- | --------------------------- | | `driveId` | string | ✅ | `"0AEMV2k3MjA19Uk9PVA"` | The ID of the shared drive. | *** ### `Googledrive Untrash File` Integration name: **GOOGLEDRIVE\_UNTRASH\_FILE** Tool to restore a file from the trash. Use when you need to recover a deleted file. This action updates the file's metadata to set the 'trashed' property to false. Only works while the file remains in trash — recovery is impossible after trash is emptied via GOOGLEDRIVE\_EMPTY\_TRASH or auto-purged by policy. #### Parameters | Parameter | Type | Required | Example | Description | | ------------------- | ------- | :------: | ----------------------------------------- | ----------------------------------------------------------------------------- | | `file_id` | string | ✅ | `"1aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789"` | The ID of the file to untrash. | | `supportsAllDrives` | boolean | | `true` | Whether the requesting application supports both My Drives and shared drives. | *** ### `Googledrive Update Comment` Integration name: **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'. #### Parameters | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `fields` | string | | `"id,content,resolved"` | 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 | | `"This is the updated comment content."` | 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 | ✅ | `"1a2b3c4d5e6f7g8h9i0j"` | The ID of the file. | | `resolved` | boolean | | `true` | 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 | ✅ | `"11a22b33c44d55e66f77g88h99i00j"` | The ID of the comment to update. | *** ### `Googledrive Update Drive` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | ---------------------- | ------- | :------: | ------- | --------------------------------------------------------------------------------------------------------- | | `name` | string | | — | The new name for the shared drive. | | `hidden` | boolean | | — | Whether the shared drive is hidden from the default view. | | `driveId` | string | ✅ | — | 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. | *** ### `Googledrive Update File Metadata Patch` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | --------------------------- | ------- | :------: | ------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------- | | `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 | ✅ | `"1FT9IW4UpvEc4Ezxv8xS2jEda17MztBXzK7CMqfz-s98"` | 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. | *** ### `Googledrive Update File Property` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | --------------------- | ------- | :------: | ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | `alt` | string | | — | 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 | | — | V1 error format values. | | `fields` | string | | — | Selector specifying which fields to include in a partial response. | | `fileId` | string | ✅ | `"1FT9IW4UpvEc4Ezxv8xS2jEda17MztBXzK7CMqfz-s98"` | 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 | | — | 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 | ✅ | `"test_property"` | The key of the property. | | `access_token` | string | | — | OAuth access token. | | `property_value` | string | | `"updated_test_value"` | The value of this property. | | `upload_protocol` | string | | — | Upload protocol for media (e.g. 'raw', 'multipart'). | | `property_visibility` | string | | — | Visibility options for the property. | *** ### `Googledrive Update File Put` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | -------------------------- | ------- | :------: | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `name` | string | | `"My Updated Document"` | 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 | ✅ | `"1XyZ_6AbCdEfGhIjKlMnOpQrStUvWxYz0"` | The ID of the file to update. | | `starred` | boolean | | — | Whether the user has starred the file. | | `mime_type` | string | | `"application/vnd.google-apps.document"` | 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 | | `"1A2B3C4D5E6F7G8H9I0J"` | 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 | | `"Updated version of the project proposal."` | A short description of the file. | | `ocr_language` | string | | `"en"` | A language hint for OCR processing during image import (ISO 639-1 code). | | `remove_parents` | string | | `"1A2B3C4D5E6F7G8H9I0J"` | 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. | *** ### `Googledrive Update File Revision Metadata` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | ------------------------ | ------- | :------: | ----------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `file_id` | string | ✅ | `"1aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789"` | 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 | ✅ | `"1"` | 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. | *** ### `Googledrive Update Permission` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | ------------------------ | ------- | :------: | ---------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `fileId` | string | ✅ | `"1234567890abcdefghijklmnopqrstuvwxyz"` | The ID of the file or shared drive. | | `permission` | object | ✅ | — | 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 | ✅ | `"01234567890123456789"` | 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. | *** ### `Googledrive Update Reply` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | ------------ | ------ | :------: | ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- | | `fields` | string | | `"id,content"` | Selector specifying which fields to include in a partial response. If not provided, defaults to '\*' to return all fields. | | `content` | string | ✅ | `"This is an updated reply."` | The new plain text content of the reply. | | `file_id` | string | ✅ | `"1ZdR3L3Kek7szY1j11SQZ9A_00up1j3aA"` | The ID of the file. | | `reply_id` | string | ✅ | `"ANmBhkFXXXXX"` | The ID of the reply. | | `comment_id` | string | ✅ | `"AAAAAAMAAAAA"` | The ID of the comment. | *** ### `Googledrive Update Team Drive` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | ---------------------- | ------- | :------: | ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `name` | string | | `"Bug Reproduce Test Drive"` | 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 | ✅ | `"0AMndV9-YuXjwUk9PVA"` | 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. | *** ### `Googledrive Upload File` Integration name: **GOOGLEDRIVE\_UPLOAD\_FILE** Uploads a file (max 5MB) to Google Drive, placing it in the specified folder or root if no valid folder ID is provided. Always creates a new file (never updates existing); use GOOGLEDRIVE\_EDIT\_FILE to update with a stable file\_id. Uploaded files are private by default; configure sharing via GOOGLEDRIVE\_ADD\_FILE\_SHARING\_PREFERENCE. #### Parameters | Parameter | Type | Required | Example | Description | | --------------------- | ------ | :------: | ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `file_to_upload` | object | ✅ | — | File to upload to Google Drive (max 5MB). Must be a dict with fields: `name` (sanitized filename, no slashes or control characters), `mimetype` (accurate MIME type, e.g. `application/pdf`; incorrect values cause Drive to convert or misrender the file), and `s3key` (path from a previously staged Composio object — not an s3url, not a local path, not a fabricated key). When chaining with TEXT\_TO\_PDF\_CONVERT\_TEXT\_TO\_PDF, pass the returned `s3key` field, not `s3url`. | | `folder_to_upload_to` | string | | `"1duXYCvYC5tIp5B_B1HWLq8LyDYXfMhPU"` | 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. | *** ### `Googledrive Upload From Url` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | --------------------- | ------- | :------: | ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `name` | string | ✅ | `"report.pdf"` | Name for the file in Google Drive, including extension (e.g., 'report.pdf', 'image.png'). | | `mime_type` | string | | `"application/pdf"` | 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 | ✅ | `"https://example.com/document.pdf"` | URL of the file to download and upload to Google Drive. Must be a publicly accessible URL 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 | | `{"Authorization":"Bearer token123"}` | Optional HTTP headers to include when downloading from source\_url. Use for authentication tokens, signed URLs, or CDN-specific headers. | | `parent_folder_id` | string | | `"1aBcDeFgHiJkLmNoPqRsTuVwXyZ"` | 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. | *** ### `Googledrive Upload Update File` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | --------------------------- | ------- | :------: | ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | | `fileId` | string | ✅ | `"1iau-j_ezb2Vcx1tZDMDdfpqlzxVzlscg"` | The ID of the file to update with new content. | | `addParents` | string | | `"1A2B3C4D5E6F7G8H9I0J"` | Comma-separated list of parent folder IDs to add. | | `uploadType` | string | | `"media"` | The type of upload request. 'media' for simple upload (content only), 'multipart' for metadata + content, 'resumable' for large files. | | `ocrLanguage` | string | | `"en"` | Language hint for OCR processing (ISO 639-1 code, e.g., 'en'). | | `removeParents` | string | | `"1A2B3C4D5E6F7G8H9I0J"` | Comma-separated list of parent folder IDs to remove. | | `file_to_upload` | object | ✅ | — | 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. | *** ### `Googledrive Watch Changes` Integration name: **GOOGLEDRIVE\_WATCH\_CHANGES** Tool to subscribe to changes for a user or shared drive in Google Drive. Use when you need to monitor a Google Drive for modifications and receive notifications at a specified webhook URL. Notifications may be batched rather than per-change; design handlers to be idempotent and fetch all changes since the last known page\_token on each notification. #### Parameters | Parameter | Type | Required | Example | Description | | ------------------------------- | ------- | :------: | ---------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `id` | string | ✅ | `"your-unique-channel-id-123"` | 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 | ✅ | `"web_hook"` | The type of delivery mechanism for notifications. | | `token` | string | | `"optional-arbitrary-string-for-verification"` | An arbitrary string that will be delivered with each notification. Can be used for verification. | | `params` | object | | — | Optional parameters for the notification channel. Example: {"ttl": "3600"} for a 1-hour time-to-live (actual support depends on Google API). | | `spaces` | string | | `"drive"` | A comma-separated list of spaces to query within the corpora. Supported values are 'drive' and 'appDataFolder'. | | `address` | string | ✅ | `"https://example.com/notifications"` | 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 | | `"0ABqLz1XZc1Z9Uk9PVA"` | 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 | | `1678886400000` | 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 | | `"labelId1,labelId2"` | 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 | | `"published"` | 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. | *** ### `Googledrive Watch File` Integration name: **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. #### Parameters | Parameter | Type | Required | Example | Description | | --------------------------- | ------- | :------: | ------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------- | | `id` | string | ✅ | `"01234567-89ab-cdef-0123456789ab"` | A UUID or similar unique string that identifies this notification channel (max 64 characters). | | `type` | string | ✅ | `"web_hook"` | The type of delivery mechanism used for this channel. | | `token` | string | | `"my-secret-token-12345"` | An arbitrary string delivered to the target address with each notification for verification (max 256 characters). | | `fileId` | string | ✅ | `"1xAHUNyfubIa8K07EVv9_5Hc5EsgdIhUx-QNcrGJ_yQk"` | The ID of the file to watch for changes. | | `params` | object | | `{"ttl":"3600"}` | Additional parameters controlling delivery channel behavior. | | `address` | string | ✅ | `"https://webhook.site/unique-id-here"` | The HTTPS address where notifications are delivered for this channel. Must have a valid SSL certificate. | | `payload` | boolean | | `true` | Whether payload data should be included in notifications. | | `expiration` | integer | | `1678886400000` | 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. | --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.toolhouse.ai/toolhouse/integrations/google-drive.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.