- Category: file management & storage
- Auth: OAUTH2
- Composio-managed OAuth available? Yes
- Tools: 105
- Triggers: 7
- Slug:
GOOGLEDRIVE - Version: 20261101_00
Frequently Asked Questions
How do I set up custom Google OAuth credentials for Google Drive?
How do I set up custom Google OAuth credentials for Google Drive?
Why am I seeing "App is blocked" when connecting Google Drive?
Why am I seeing "App is blocked" when connecting Google Drive?
Why am I getting "Google Drive API has not been used in project" error?
Why am I getting "Google Drive API has not been used in project" error?
Why am I getting "Error 400: invalid_scope"?
Why am I getting "Error 400: invalid_scope"?
Why does the OAuth consent screen show "Composio" instead of my app?
Why does the OAuth consent screen show "Composio" instead of my app?
Why am I getting 401 errors on tool calls?
Why am I getting 401 errors on tool calls?
Tools
Add file sharing preference (Deprecated)
Add file sharing preference (Deprecated)
GOOGLEDRIVE_ADD_FILE_SHARING_PREFERENCEDEPRECATED: Use GOOGLEDRIVE_CREATE_PERMISSION instead; use GOOGLEDRIVE_UPDATE_PERMISSION to modify existing permissions (avoids duplicate entries). Modifies sharing permissions for an existing Google Drive file, granting a specified role to a user, group, domain, or ‘anyone’. Bulk calls may trigger 403 rateLimitExceeded (~100 req/100s/user); use jittered exponential backoff.Input Parameters
Output
Insert File Parent (v2)
Insert File Parent (v2)
GOOGLEDRIVE_ADD_PARENTTool to add a parent folder for a file using Google Drive API v2. Use when you need to add a file to an additional folder.Input Parameters
Output
Insert Property (v2 API)
Insert Property (v2 API)
GOOGLEDRIVE_ADD_PROPERTYTool to add a property to a file, or update it if it already exists (v2 API). Use when you need to attach custom key-value metadata to a Google Drive file.Input Parameters
Output
Batch Get Spreadsheet Values
Batch Get Spreadsheet Values
GOOGLEDRIVE_BATCH_GET_SPREADSHEET_VALUESRead multiple explicit ranges from one Google Spreadsheet in one request.Input Parameters
Output
Batch Update Spreadsheet Values
Batch Update Spreadsheet Values
GOOGLEDRIVE_BATCH_UPDATE_SPREADSHEET_VALUESWrite values to multiple Google Sheets ranges in one batch request.Input Parameters
Output
Clear Spreadsheet Values
Clear Spreadsheet Values
Copy file (Deprecated)
Copy file (Deprecated)
GOOGLEDRIVE_COPY_FILEDEPRECATED: Use GOOGLEDRIVE_COPY_FILE_ADVANCED instead. Duplicates an existing file (not folders) in Google Drive by file_id; copy lands in same folder as original — use GOOGLEDRIVE_MOVE_FILE afterward for precise placement. Copy receives a new file_id; update stored references accordingly. For shared drives, requires organizer/manager rights.Input Parameters
file_id before calling.Output
Copy file with advanced options
Copy file with advanced options
GOOGLEDRIVE_COPY_FILE_ADVANCEDCreates a copy of a file and applies any requested updates with patch semantics. Use when you need to duplicate a file with advanced options like label inclusion, visibility settings, or custom metadata.Input Parameters
Output
Create Comment
Create Comment
GOOGLEDRIVE_CREATE_COMMENTTool to create a comment on a file in Google Drive. Returns a nested data object; extract data.id for the resulting comment identifier. Omit anchor and quoted_file_content_* for general file-level comments.Input Parameters
id field from GOOGLEDOCS_SEARCH_DOCUMENTS results can be used directly without conversion.Output
Create File or Folder
Create File or Folder
GOOGLEDRIVE_CREATE_FILECreates a new file or folder in Google Drive. Supports both metadata-only creation (for folders and empty documents) and file upload with content. When file_to_upload is provided, uploads the actual file bytes; otherwise creates an empty file. Native Google file types (Docs, Sheets, Forms, etc.) and folders are created as empty shells when no content is provided; content must be added manually afterward. Newly created files are private by default — set sharing permissions afterward for collaboration. For shared-drive folders, use this tool with the target folder ID in parents rather than GOOGLEDRIVE_CREATE_FOLDER.Input Parameters
Output
Create a File from Text
Create a File from Text
GOOGLEDRIVE_CREATE_FILE_FROM_TEXTCreates a Google Drive file from text, with support for Google Workspace formats and an optional parent folder. Returns file metadata at the top level; files can inherit parent permissions, and shared-drive targets are not supported in all cases.Input Parameters
text/plain for HTML) breaks Drive previews and downstream conversion.content, body, text) are accepted; undocumented keys like file_content cause an ‘Invalid request data’ error. Must be UTF-8 encoded.Output
Create a folder
Create a folder
GOOGLEDRIVE_CREATE_FOLDERCreates a Google Drive folder, optionally inside an existing parent specified by ID or exact name. If multiple folders match a parent name, it uses the first match; use a parent ID to avoid ambiguity.Input Parameters
Output
Create Permission
Create Permission
GOOGLEDRIVE_CREATE_PERMISSIONTool to create a permission for a file or shared drive. Use when you need to share a file or folder with users, groups, domains, or make it publicly accessible. Warning: Concurrent permissions operations on the same file are not supported; only the last update is applied.Input Parameters
Output
Create Permissions Batch
Create Permissions Batch
GOOGLEDRIVE_CREATE_PERMISSIONS_BATCHCreates multiple permissions for files or shared drives in a single batch request. Use this action when you need to share multiple files with users, or share a single file with multiple users or groups simultaneously. Each permission in the batch can target a different file and specify different access levels. Batch operations are more efficient than creating permissions individually, with a maximum of 100 permissions per batch.Input Parameters
Output
Create Reply
Create Reply
Create Shortcut to File/Folder
Create Shortcut to File/Folder
GOOGLEDRIVE_CREATE_SHORTCUT_TO_FILETool to create a shortcut to a file or folder in Google Drive. Use when you need to link to an existing Drive item from another location without duplicating it. The shortcut receives its own distinct file ID (capture from response). No parent folder parameter exists; use GOOGLEDRIVE_MOVE_FILE after creation to place the shortcut in the desired location.Input Parameters
Output
Create Team Drive (Deprecated)
Create Team Drive (Deprecated)
GOOGLEDRIVE_CREATE_TEAM_DRIVETool to create a Team Drive. Deprecated: Use drives.create instead. Use when you need to create a Team Drive for collaboration.Input Parameters
Output
Delete Child (v2)
Delete Child (v2)
GOOGLEDRIVE_DELETE_CHILDTool to remove a child from a folder using Google Drive API v2. Use when you need to remove a file from a specific folder.Input Parameters
Output
Delete Comment
Delete Comment
GOOGLEDRIVE_DELETE_COMMENTPermanently deletes a comment thread (and all its replies) from a Google Drive file — this action is irreversible. To remove only a single reply within a thread, use GOOGLEDRIVE_DELETE_REPLY instead. Verify the exact comment content and comment_id before calling.Input Parameters
Output
Delete file
Delete file
GOOGLEDRIVE_DELETE_FILEDEPRECATED: Use GOOGLEDRIVE_GOOGLE_DRIVE_DELETE_FOLDER_OR_FILE_ACTION instead. Tool to permanently delete a file owned by the user without moving it to trash. Use when permanent deletion is required. If the file belongs to a shared drive, the user must be an organizer on the parent folder.Input Parameters
Output
Delete Parent (v2)
Delete Parent (v2)
GOOGLEDRIVE_DELETE_PARENTTool to remove a parent from a file using Google Drive API v2. Use when you need to remove a file from a specific folder.Input Parameters
Output
Delete Permission
Delete Permission
GOOGLEDRIVE_DELETE_PERMISSIONDeletes a specified permission from a file or shared drive by permission ID; deleting other permissions does not remove an existing public-access permission. Check the returned success flag: an owner permission that cannot be removed returns success=false.Input Parameters
Output
Delete Property (v2 API)
Delete Property (v2 API)
GOOGLEDRIVE_DELETE_PROPERTYDelete a custom property from a Google Drive file using API v2. The property is selected by key and visibility; visibility defaults to private when omitted.Input Parameters
Output
Delete Reply
Delete Reply
GOOGLEDRIVE_DELETE_REPLYTool to delete a specific reply by reply ID. Deletion is irreversible; obtain explicit user confirmation before calling. Removes only the targeted reply, not the full comment thread — use GOOGLEDRIVE_DELETE_COMMENT to remove the entire thread.Input Parameters
Output
Delete Revision
Delete Revision
GOOGLEDRIVE_DELETE_REVISIONTool to permanently delete a file revision. Use when you need to remove a specific version of a binary file (images, videos, etc.). Cannot delete revisions for Google Docs/Sheets or the last remaining revision.Input Parameters
Output
Delete Team Drive (Deprecated)
Delete Team Drive (Deprecated)
Download a file from Google Drive
Download a file from Google Drive
GOOGLEDRIVE_DOWNLOAD_FILEDownloads a Drive file’s content and returns it in downloaded_file_content. For native blob files such as PDFs, images, videos, and Office files, it returns the original bytes without conversion; leave mime_type unset. For Google Workspace documents, it exports the content and mime_type optionally selects the export format.Input Parameters
Output
Download file content (Deprecated)
Download file content (Deprecated)
Download file via operation
Download file via operation
GOOGLEDRIVE_DOWNLOAD_FILE_OPERATIONStarts a long-running operation to download a Drive file, including Google Vids files, or export supported Google Workspace documents. Returns operation status and metadata; operations are valid for 24 hours from creation.Input Parameters
Output
Download File Revision
Download File Revision
GOOGLEDRIVE_DOWNLOAD_FILE_REVISIONDownload the stored bytes of one blob-file revision. This action does not export Google Docs, Sheets, Slides, or other Workspace revisions. Use GOOGLEDRIVE_GET_REVISION to retrieve a Workspace revision’s exportLinks, then download the selected export URL separately.Input Parameters
Output
Edit File
Edit File
GOOGLEDRIVE_EDIT_FILEReplaces the entire content of an existing Google Drive binary file with UTF-8 text while retaining its file ID. Google Docs, Sheets, Slides, and other checked Workspace file types are not supported.Input Parameters
Output
Empty Trash
Empty Trash
GOOGLEDRIVE_EMPTY_TRASHTool to permanently and irreversibly delete ALL trashed files in the user’s Google Drive or a specified shared drive. Recovery is impossible after execution — no Drive tool can restore items once trash is emptied. Affects every item in trash across the entire account or shared drive, not just files from the current workflow. Always obtain explicit user confirmation and clarify that recovery is impossible before executing. Provide driveId to target a specific shared drive’s trash; omit to empty the user’s root trash.Input Parameters
Output
Export Google Workspace file
Export Google Workspace file
GOOGLEDRIVE_EXPORT_GOOGLE_WORKSPACE_FILEExports a Google Workspace document to the requested MIME type and returns exported file content. Use when you need to export Google Docs, Sheets, Slides, Drawings, or Apps Script files to a specific format. Note: The exported content is limited to 10MB by Google Drive API.Input Parameters
Output
Find file
Find file
GOOGLEDRIVE_FIND_FILEThe comprehensive Google Drive search tool that handles all file and folder discovery needs. Use this for any file finding task - from simple name searches to complex queries with date filters, MIME types, permissions, custom properties, folder scoping, and more. Searches across My Drive and shared drives with full metadata support. Examples: - Find PDFs: q=“mimeType = ‘application/pdf’” - Find recent files: q=“modifiedTime > ‘2024-01-01T00:00:00’” - Search by name: q=“name contains ‘report’” - Files in folder: folderId=“abc123” or q=“‘FOLDER_ID’ in parents”Input Parameters
name - File name (exact match with = or partial match with contains) - fullText - File content search - mimeType - File type (e.g., ‘application/pdf’, ‘application/vnd.google-apps.folder’) - modifiedTime, createdTime - Dates (RFC 3339: ‘2024-01-01T00:00:00’) - parents - Folder IDs containing the file - owners, writers - User email addresses (MUST use ‘in’ operator, NOT colon syntax) - properties, appProperties - Custom metadata Boolean Filter Fields (sharedWithMe, trashed, starred): These fields require explicit = true or = false syntax: - sharedWithMe = true - Find files shared with you by others - sharedWithMe = false - Find files NOT shared with you (your own files) - trashed = true - Find files in trash - trashed = false - Exclude trashed files from results - starred = true - Find starred/favorited files - starred = false - Find non-starred files Combine with other conditions using ‘and’: - “sharedWithMe = true and name contains ‘report’” - Find shared files with ‘report’ in name - “sharedWithMe = true and mimeType = ‘application/pdf’” - Find shared PDF files - “starred = true and modifiedTime > ‘2024-01-01T00:00:00’” - Find recently modified starred files Query Complexity Limits: Queries with many OR clauses (typically >5-10) may fail with ‘The query is too complex’ error. Name Field Usage: Wildcards (*) are NOT supported. Use ‘contains’ operator for partial matching. User Email Searches: - CORRECT: “‘user@example.com’ in owners” or “‘user@example.com’ in writers” or “‘user@example.com’ in readers” - INCORRECT: “owner:user@example.com” (colon syntax is NOT supported and will cause errors) - Always use the ‘in’ operator with quoted email addresses for user-based searches Special Syntax: - Dates: RFC 3339 format (time zone defaults to UTC) - Apostrophes/quotes in values: Automatically escaped. You can write “name = ‘Jan’26’” or “name = ‘Valentine’s Day’” without manual escaping. - Grouping: Use parentheses for OR: “(mimeType contains ‘image/’ or mimeType contains ‘video/’)” - Custom properties: “properties has { key=‘department’ and value=‘sales’ }” IMPORTANT - Root Folder (‘My Drive’): ‘My Drive’ is NOT a searchable folder name. To work with the root folder, use the ‘root’ alias: folder_id=‘root’ or “‘root’ in parents” in your query.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)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.labelInfo part of the response for each file. Empty strings are automatically treated as omitted.Output
Find folder
Find folder
GOOGLEDRIVE_FIND_FOLDERFinds one page of Google Drive folders by name and optional parent. Use nextPageToken with page_token to retrieve additional pages.Input Parameters
Output
Generate File IDs
Generate File IDs
Get about
Get about
GOOGLEDRIVE_GET_ABOUTTool to retrieve information about the user, the user’s Drive, and system capabilities. Use when you need to check storage quotas, user details, or supported import/export formats. Note: storageQuota reflects My Drive (personal) storage only — it does not cover shared drives; use GOOGLEDRIVE_LIST_SHARED_DRIVES and GOOGLEDRIVE_GET_DRIVE for shared drive quotas. A successful response confirms base Drive read access only; write access and shared drive access must be verified separately.Input Parameters
* to include all fields. Supported fields in Drive API v3: kind, user, storageQuota, importFormats, exportFormats, maxImportSizes, maxUploadSize, appInstalled, canCreateDrives, canCreateTeamDrives (deprecated), driveThemes, teamDriveThemes (deprecated), folderColorPalette. Note: rootFolderId was removed in v3 and is not supported. Note: storageQuota sub-fields (limit, usage, usageInDrive, usageInDriveTrash) are returned as strings representing bytes — convert to numeric types before arithmetic.Output
Get App
Get App
Get Change (v2 - Deprecated)
Get Change (v2 - Deprecated)
GOOGLEDRIVE_GET_CHANGETool to get a specific change by ID from Google Drive v2 API. Deprecated: Use changes.getStartPageToken and changes.list to retrieve recent changes instead.Input Parameters
Output
Get Changes Start Page Token
Get Changes Start Page Token
GOOGLEDRIVE_GET_CHANGES_START_PAGE_TOKENTool to get the starting pageToken for listing future changes in Google Drive. Returns only a token — pass it to GOOGLEDRIVE_LIST_CHANGES to retrieve actual changes. Persist this token; losing it requires a full rescan. The token is forward-looking: GOOGLEDRIVE_LIST_CHANGES may return no results if no changes have occurred since issuance. For simple recent-file lookups, prefer GOOGLEDRIVE_FIND_FILE; use this tool only for incremental change-feed workflows.Input Parameters
Output
Get Child Reference (v2)
Get Child Reference (v2)
GOOGLEDRIVE_GET_CHILDTool to get a specific child reference for a folder using Drive API v2. Use when you need to verify a specific file exists as a child of a folder.Input Parameters
Output
Get Comment
Get Comment
Get Document
Get Document
GOOGLEDRIVE_GET_DOCUMENTRetrieve a native Google Docs document’s structured content and metadata by ID.Input Parameters
Output
Get File Metadata
Get File Metadata
GOOGLEDRIVE_GET_FILE_METADATAGets a Drive file’s metadata by ID, optionally returning only the metadata selected by fields. Use fields such as id,name,mimeType,parents,modifiedTime when a compact partial response is needed; omit it for Google’s default metadata. This does not download file content: use GOOGLEDRIVE_DOWNLOAD_FILE for native bytes or exported Workspace content.Input Parameters
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.Output
Get Property (v2)
Get Property (v2)
GOOGLEDRIVE_GET_FILE_PROPERTYTool to get a property by its key using Google Drive API v2. Use when you need to retrieve a specific custom property attached to a file.Input Parameters
Output
Get File (v2 API) (Deprecated)
Get File (v2 API) (Deprecated)
GOOGLEDRIVE_GET_FILE_V2Retrieves metadata for a Google Drive file by ID using the v2 API, optionally selecting fields for a partial response. DEPRECATED: Use GetFileMetadata instead. This action does not support returning file content as a media download.Input Parameters
Output
Get Google Form
Get Google Form
Get Parent Reference (v2)
Get Parent Reference (v2)
GOOGLEDRIVE_GET_PARENTTool to get a specific parent reference for a file using Drive API v2. Use when you need to retrieve information about a specific parent folder of a file.Input Parameters
Output
Get Permission
Get Permission
GOOGLEDRIVE_GET_PERMISSIONGets a permission by ID. Use this tool to retrieve a specific permission for a file or shared drive. Newly created or updated permissions on shared drives may have a brief propagation delay before appearing.Input Parameters
Output
Get Permission ID for Email
Get Permission ID for Email
GOOGLEDRIVE_GET_PERMISSION_ID_FOR_EMAILTool to get the permission ID for an email address using the Drive API v2. Use when you need to convert an email address to its corresponding permission ID.Input Parameters
Output
Get Google Slides Presentation
Get Google Slides Presentation
GOOGLEDRIVE_GET_PRESENTATIONRetrieves a Google Slides presentation by ID, including its page structures. An optional field selector can limit the returned data.Input Parameters
Output
Get Presentation Page Thumbnail
Get Presentation Page Thumbnail
GOOGLEDRIVE_GET_PRESENTATION_PAGE_THUMBNAILGenerate one short-lived page thumbnail URL using an expensive Slides quota read.Input Parameters
Output
Get Reply
Get Reply
Get Revision
Get Revision
GOOGLEDRIVE_GET_REVISIONTool to get a specific revision’s metadata (name, modifiedTime, keepForever, etc.) by revision ID. Returns metadata only — not file content. Use a separate download tool to retrieve file content or restore a revision.Input Parameters
Output
Get Spreadsheet
Get Spreadsheet
GOOGLEDRIVE_GET_SPREADSHEETRetrieve a Google Spreadsheet’s structure, metadata, and selected grid data.Input Parameters
Output
Get Spreadsheet Values
Get Spreadsheet Values
GOOGLEDRIVE_GET_SPREADSHEET_VALUESRead values from one range in a Google Spreadsheet.Input Parameters
Output
Get Team Drive (Deprecated)
Get Team Drive (Deprecated)
GOOGLEDRIVE_GET_TEAM_DRIVETool to get metadata about a Team Drive by ID. Deprecated: Use the drives.get endpoint instead.Input Parameters
Output
Delete folder or file
Delete folder or file
GOOGLEDRIVE_GOOGLE_DRIVE_DELETE_FOLDER_OR_FILE_ACTIONTool to delete a file or folder in Google Drive. Use when you need to permanently remove a specific file or folder using its ID. Note: This action is irreversible. Deleting a folder permanently removes all nested files and subfolders.Input Parameters
Output
Insert Child Into Folder (v2)
Insert Child Into Folder (v2)
GOOGLEDRIVE_INSERT_CHILDTool to insert a file into a folder using Drive API v2. Use when you need to add an existing file to a folder.Input Parameters
Output
List Access Proposals
List Access Proposals
List Approvals
List Approvals
GOOGLEDRIVE_LIST_APPROVALSLists a page of approvals associated with a Google Drive file, with pagination for browsing subsequent pages. Approval details are unavailable through this action.Input Parameters
Output
List Changes
List Changes
GOOGLEDRIVE_LIST_CHANGESLists a page of changes for a user or shared drive; without a page token, it obtains a current start token and lists subsequent changes rather than earlier activity. Follow nextPageToken to continue and save newStartPageToken for future monitoring.Input Parameters
Output
List Folder Children (v2)
List Folder Children (v2)
GOOGLEDRIVE_LIST_CHILDREN_V2Lists a page of child references for a folder using Google Drive API v2. Follow the returned nextPageToken to retrieve additional pages.Input Parameters
Output
List Comments
List Comments
GOOGLEDRIVE_LIST_COMMENTSLists comments on a Google Drive file, with pagination, an option to include deleted comments, and a minimum modification-time filter. Filter by author or content client-side.Input Parameters
* to include all fields. Prefer selective field masks (e.g., ‘comments(id,content,author)’) over ’*’ to reduce payload size and latency.Output
List File Labels
List File Labels
List Properties (v2 API)
List Properties (v2 API)
GOOGLEDRIVE_LIST_FILE_PROPERTIESTool to list a file’s properties in Google Drive API v2. Use when you need to retrieve custom properties (key-value pairs) attached to a file.Input Parameters
Output
List Files and Folders (Deprecated)
List Files and Folders (Deprecated)
GOOGLEDRIVE_LIST_FILESLists and searches Google Drive files and folders using filters such as a folder, search query, or drive selection. Results are paginated; a 404 response is returned as an empty list and does not establish that no files match. DEPRECATED: Use GOOGLEDRIVE_FIND_FILE instead.Input Parameters
labelInfo part of the response for each file.includeItemsFromAllDrives can be used to extend the search to all drives.corpora is ‘user’ or ‘domain’. Defaults to false.Output
List Google Form Responses
List Google Form Responses
GOOGLEDRIVE_LIST_FORM_RESPONSESReturn one page of submissions for a Google Form.Input Parameters
Output
List Label Definitions
List Label Definitions
GOOGLEDRIVE_LIST_LABEL_DEFINITIONSLists available Google Drive labels, returning each label’s ID and display name without requiring a file ID.Input Parameters
Output
List Permissions
List Permissions
GOOGLEDRIVE_LIST_PERMISSIONSLists a page of permissions for a file or shared drive. Use the returned next page token to retrieve further pages when present.Input Parameters
Output
List Replies to Comment
List Replies to Comment
GOOGLEDRIVE_LIST_REPLIESList a page of replies to a specific comment on a Google Drive file. Supports pagination and optionally including deleted replies.Input Parameters
Output
List File Revisions
List File Revisions
GOOGLEDRIVE_LIST_REVISIONSTool to list a file’s revision metadata (not content) in Google Drive. Drive may prune old revisions, so history may be incomplete for frequently edited files. Filter client-side for specific revisionIds; do not assume the last entry is the active version.Input Parameters
nextPageToken is absent; stopping early silently omits revisions.true for shared drive files; omitting it causes fileId resolution failures on shared drives.Output
List Team Drives (Deprecated)
List Team Drives (Deprecated)
GOOGLEDRIVE_LIST_TEAM_DRIVESTool to list Team Drives (deprecated, use List Shared Drives instead). Use when you need to retrieve Team Drives using the legacy endpoint.Input Parameters
Output
Modify File Labels
Modify File Labels
Move File
Move File
GOOGLEDRIVE_MOVE_FILEMoves a file to another Google Drive folder. At least one of add_parents or remove_parents is required; calls with neither are rejected. Supply add_parents with the destination folder ID; if remove_parents is omitted, the action checks and removes the current parent automatically before adding the destination. For My Drive files only, remove_parents without add_parents moves the file to My Drive root. For shared-drive items, set supports_all_drives=true and provide add_parents because the item must retain exactly one parent; membership, role, and domain policies can restrict moves, and the Drive API cannot move a folder from My Drive into a shared drive. Google Drive files have one parent, so use a shortcut for additional placements.Input Parameters
Output
Export or download a file
Export or download a file
GOOGLEDRIVE_PARSE_FILEDEPRECATED: Exports Google Workspace files (max 10MB) to a specified format using mime_type, or downloads other file types; use GOOGLEDRIVE_DOWNLOAD_FILE instead.Input Parameters
Output
Patch Permission
Patch Permission
GOOGLEDRIVE_PATCH_PERMISSIONTool to update a permission using patch semantics. Use when you need to modify specific fields of an existing permission without affecting other fields. Warning: Concurrent permissions operations on the same file are not supported; only the last update is applied.Input Parameters
Output
Patch Property (v2 API)
Patch Property (v2 API)
GOOGLEDRIVE_PATCH_PROPERTYTool to update a property on a file using PATCH semantics (v2 API). Use when you need to partially update custom key-value metadata attached to a Google Drive file.Input Parameters
Output
Read Spreadsheet Values
Read Spreadsheet Values
GOOGLEDRIVE_READ_SPREADSHEET_VALUESRead values from one or more ranges in a Google spreadsheet.Input Parameters
Output
Resumable Upload
Resumable Upload
GOOGLEDRIVE_RESUMABLE_UPLOADUpload a file to Google Drive using a resumable session, creating a new file or updating an existing file by ID. The upload is sent in chunks.Input Parameters
Output
Stop Watch Channel
Stop Watch Channel
GOOGLEDRIVE_STOP_WATCH_CHANNELTool to stop watching resources through a specified channel. Use this when you want to stop receiving notifications for a previously established watch. Both id and resourceId must be saved from the original watch response — they cannot be retrieved after the fact.Input Parameters
Output
Trash File
Trash File
GOOGLEDRIVE_TRASH_FILETool to move a file or folder to trash (soft delete). Use when you need to delete a file but want to allow recovery via UNTRASH_FILE. This action is distinct from permanent deletion and provides a safer cleanup workflow.Input Parameters
Output
Untrash File
Untrash File
Update Comment
Update Comment
GOOGLEDRIVE_UPDATE_COMMENTTool to update an existing comment on a Google Drive file. Use when you need to change the content of a comment. NOTE: The ‘resolved’ field is read-only in the Google Drive API. To resolve or reopen a comment, use CREATE_REPLY with action=‘resolve’ or action=‘reopen’.Input Parameters
Output
Update File Metadata (PATCH v2)
Update File Metadata (PATCH v2)
GOOGLEDRIVE_UPDATE_FILE_METADATA_PATCHTool to update file metadata using the Drive API v2 PATCH method. Use when you need to modify file properties like title, description, or labels using patch semantics.Input Parameters
Output
Update Property (v2 API)
Update Property (v2 API)
GOOGLEDRIVE_UPDATE_FILE_PROPERTYTool to update a property on a file using Google Drive API v2. Use when you need to modify an existing custom property attached to a file.Input Parameters
Output
Update File (Metadata)
Update File (Metadata)
GOOGLEDRIVE_UPDATE_FILE_PUTUpdates file metadata. Uses PATCH semantics (partial update) as per Google Drive API v3 — only explicitly provided fields are updated, so omit fields you do not intend to overwrite. Use this tool to modify attributes of an existing file like its name, description, or parent folders. To move a file, supply add_parents and remove_parents together; omitting remove_parents creates multiple parents, omitting add_parents can orphan the file. Bulk updates may trigger 429 Too Many Requests; apply exponential backoff. Note: supports metadata updates only; file content updates are not yet implemented.Input Parameters
Output
Update File Revision Metadata
Update File Revision Metadata
GOOGLEDRIVE_UPDATE_FILE_REVISION_METADATAUpdates ONLY the metadata properties of a specific file revision (keepForever, published, publishAuto, publishedOutsideDomain). IMPORTANT: This action does NOT update file content. To update file content, use EDIT_FILE or UPDATE_FILE_PUT instead. This action requires BOTH file_id AND revision_id parameters. Use LIST_REVISIONS to get available revision IDs for a file. Valid parameters: file_id (required), revision_id (required), keep_forever, published, publish_auto, published_outside_domain. Invalid parameters (use other actions): file_contents, mime_type, content, name - these are NOT supported by this action.Input Parameters
Output
Update Permission
Update Permission
GOOGLEDRIVE_UPDATE_PERMISSIONTool to update a permission with patch semantics. Use when you need to modify an existing permission for a file or shared drive. Inherited or domain-managed permissions may not be editable; verify editability with GOOGLEDRIVE_LIST_PERMISSIONS before updating.Input Parameters
permissionDetails instead.Output
Update Reply
Update Reply
Update Spreadsheet Values
Update Spreadsheet Values
GOOGLEDRIVE_UPDATE_SPREADSHEET_VALUESWrite values to one exact Google Sheets range.Input Parameters
Output
Update Team Drive (Deprecated)
Update Team Drive (Deprecated)
GOOGLEDRIVE_UPDATE_TEAM_DRIVETool to update a Team Drive’s metadata. Deprecated: Use the drives.update endpoint instead. Use when you need to modify Team Drive properties.Input Parameters
Output
Upload File
Upload File
GOOGLEDRIVE_UPLOAD_FILEUpload a new file to Google Drive, optionally placing it in a specified folder. If no folder ID is provided, it is uploaded to the Drive root.Input Parameters
application/pdf; incorrect values can cause Drive to convert or misrender the file.Output
Upload File from URL to Drive
Upload File from URL to Drive
GOOGLEDRIVE_UPLOAD_FROM_URLTool to fetch a file from a provided URL server-side and upload it into Google Drive. Use when you need to reliably persist externally hosted files into Drive without client-side downloads or temporary storage.Input Parameters
Output
Upload/Update File Content
Upload/Update File Content
GOOGLEDRIVE_UPLOAD_UPDATE_FILETool to update file content in Google Drive by uploading new binary content. Use when you need to replace the contents of an existing file with new file data.Input Parameters
Output
Watch Drive Changes
Watch Drive Changes
GOOGLEDRIVE_WATCH_CHANGESSubscribe to Google Drive changes for a user or shared drive and receive notifications at a webhook URL. Supply a start or continuation page token; notifications may cover multiple changes, so fetch changes since the last known token.Input Parameters
Output
Watch File for Changes
Watch File for Changes
GOOGLEDRIVE_WATCH_FILETool to subscribe to push notifications for changes to a specific file. Use when you need to monitor a file for modifications and receive real-time notifications at a webhook URL.Input Parameters
Output
Write Spreadsheet Values
Write Spreadsheet Values
GOOGLEDRIVE_WRITE_SPREADSHEET_VALUESReplace values in one range of a Google spreadsheet.Input Parameters
Output
Triggers
Comment Added (Docs/Sheets/Slides)
Comment Added (Docs/Sheets/Slides)
File Created
File Created
GOOGLEDRIVE_FILE_CREATED_TRIGGERType: pollTriggers when a new file is created in Google Drive.Configuration
'folder_id' in parents to the query.polling_interval on the trigger instance instead. Minutes between checks for new events.Payload
File Deleted or Trashed
File Deleted or Trashed
GOOGLEDRIVE_FILE_DELETED_OR_TRASHED_TRIGGERType: pollTriggers when a file is moved to trash or permanently deleted in Drive.Configuration
include_items_from_all_drives.polling_interval on the trigger instance instead. Minutes between checks for new events.Payload
File Updated
File Updated
GOOGLEDRIVE_FILE_UPDATED_TRIGGERType: pollTriggers when a file’s metadata or content changes in Google Drive.Configuration
headRevisionId, which Drive only exposes for binary files — Google-native docs (Docs/Sheets/Slides) do not carry headRevisionId and will not fire this trigger under content_only=true.include_items_from_all_drives.polling_interval on the trigger instance instead. Minutes between checks for new events.Payload
Google Drive Changes
Google Drive Changes
GOOGLEDRIVE_GOOGLE_DRIVE_CHANGESType: pollTriggers when changes are detected in a Google Drive.Configuration
include_items_from_all_drives.polling_interval on the trigger instance instead. Minutes between checks for new events.include_items_from_all_drives is true.New File Matching Query
New File Matching Query
GOOGLEDRIVE_NEW_FILE_MATCHING_QUERY_TRIGGERType: pollTriggers when a new Google Drive file matches a provided query.This is the legacy query-centric trigger: it preserves Drive API query config such as corpora / driveId aliases and emits the historical file_matching_query event type. FileCreatedTrigger covers the broader “new file” case and emits file_created.Configuration
polling_interval on the trigger instance instead. Minutes between checks for new events.createdTime >= <watermark> boundary plus ID dedup so the trigger only fires for newly created files.
GOOGLEDRIVE_COMMENT_ADDED_TRIGGERType: pollTriggers when a new comment is added to Google Docs, Sheets, or Slides.Configuration
polling_intervalon the trigger instance instead. Minutes between checks for new events.Payload