Team
Shared credential for production and unattended runs.
Connect Google Drive with Hookshot™ and your stack
Google Drive is a cloud storage solution for uploading, sharing, and collaborating on files across devices, with robust search and offline access
Tools and triggers
What Agents can do in Google Drive
Available tools and events after Google Drive is connected.
-
Copy File with Advanced Options
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.
-
Create a File From Text
This action creates a new file in Google Drive using the text content provided. It allows for various MIME types and can also create files in subfolders if specified. CRITICAL: The parent_id parameter requires a valid…
-
Create a Folder
This action creates a new folder in Google Drive. You can specify a name for the folder and an optional parent folder by its ID or name. Important: The parent folder must already exist - this action will not create…
-
Create Comment
This action creates a new comment on a specified file in Google Drive. It allows users to provide feedback or notes related to the document by adding plain text comments.
-
Create File or Folder
This action allows the user to create a new file or folder in a specified location. Users can provide metadata such as the name, MIME type, and parent folder IDs to specify the properties of the file being created.
-
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…
-
Create Permissions Batch
Creates multiple permissions for files or shared drives in a single batch request. Use this action when you need to share multiple files with users, or share a single file with multiple users or groups simultaneously…
-
Create Reply
This action allows users to create a reply to a comment on a specific file in Google Drive. It requires the file ID, comment ID, and the content of the reply.
-
Create Shared Drive
This action creates a new shared drive in Google Drive, allowing users to collaborate on files and organize content. Specify the name, ID, and settings for the drive, and ensure it meets the necessary criteria to avoid…
-
Create Shortcut to File/Folder
This action creates a shortcut to a specified file or folder in Google Drive. It allows users to access an existing Drive item from another location without making a copy of it.
-
Delete Child (v2)
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.
-
Delete Comment
This action allows you to delete a specific comment from a designated file on Google Drive. It requires the file ID and comment ID to identify which comment to remove.
-
Delete Folder or File
This action deletes a specified file or folder from Google Drive using its unique ID. It ensures that the item is permanently removed and cannot be recovered afterward.
-
Delete Parent (v2)
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.
-
Delete Permission
Deletes a specific permission from a file using the permission ID. IMPORTANT: You must first use the 'List Permissions' action to get the permission IDs for a file. Permission IDs are opaque identifiers assigned by…
-
Delete Property (v2 API)
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.
-
Delete Reply
This action deletes a specific reply associated with a comment on a file. It helps manage the comments by allowing the removal of unwanted replies.
-
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.
-
Delete Shared Drive
This action allows for the permanent deletion of a specified shared drive. It can optionally delete all items within the drive if the appropriate permissions are granted.
-
Download a File From Google Drive
This action allows users to download files from Google Drive using the file's unique identifier. It supports exporting Google Workspace files to different formats if specified.
-
Download File via 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…
-
Edit File
This action allows users to edit an existing Google Drive file by replacing its content with new text. Note: This only works with regular binary files (text, PDF, images), not Google Docs, Sheets, or Slides. For Google…
-
Empty Trash
Permanently deletes all files in the Google Drive trash. This action empties the entire trash, removing all deleted files permanently and freeing up storage space.
-
Export Google Workspace File
This action exports a Google Workspace file (Docs, Sheets, Slides, Drawings, or Apps Script) to a specified format. The user provides the file ID and desired export format.
-
Find File
This action allows you to search for files and folders in Google Drive. You can specify various query parameters to filter and sort the results, enabling you to quickly find the content you are looking for.
-
Find Folder
This action searches for one page of folders in Google Drive based on specified name criteria. Users can filter folders by exact name, substrings, content, and modification dates, then use nextPageToken to retrieve…
-
Generate File IDs
This action generates unique file IDs for use in create or copy requests. It helps in pre-allocating IDs for new files or copies in the specified drive space.
-
Get About
This action retrieves information about the current user and their Drive. It provides data on storage quotas, user details, and the supported import/export formats for files.
-
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.
-
Get Changes Start Page Token
This action retrieves the starting pageToken for monitoring subsequent changes to files and folders in Google Drive. It enables applications to effectively track updates in shared drives.
-
Get Child Reference (v2)
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.
-
Get Comment
This action retrieves a specific comment from a Google Drive file using the file ID and comment ID. It provides an option to include deleted comments if desired.
-
Get File Metadata
This action retrieves metadata for a specified file in Google Drive based on its unique file ID. It provides details about the file's properties, such as its name, MIME type, and permissions.
-
Get Parent Reference (v2)
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.
-
Get Permission
This action allows you to retrieve specific permission information tied to a file or shared drive by using its unique ID. It provides details on who has access to the file and their respective roles.
-
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.
-
Get Property (v2)
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.
-
Get Reply
This action retrieves a specific reply associated with a comment on a file. It provides details such as the reply's content, author, and timestamps.
-
Get Revision
This action retrieves metadata for a specific revision of a file by its revision ID. It's useful for obtaining details such as the modification time, size, and state of the revision.
-
Get Shared Drive
This action retrieves information about a specific shared drive using its ID. It allows users to access detailed metadata about the drive for administrative or informational purposes.
-
Hide Shared Drive
This action hides a specified shared drive from the user's default view in Google Drive, making it invisible without deleting it. It's useful for managing visibility without permanently removing access to the shared…
-
Insert Child Into Folder (v2)
Tool to insert a file into a folder using Drive API v2. Use when you need to add an existing file to a folder.
-
Insert File Parent (v2)
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.
-
Insert Property (v2 API)
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.
-
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.
-
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.
-
List Changes
This action retrieves a list of changes for a user or shared drive. It allows tracking modifications to files and folders, such as creations, deletions, or permission changes.
-
List Comments
Lists all comments for a given file in Google Drive, including options to filter for deleted comments and control the number of comments returned per request.
-
List File Labels
This action retrieves all labels associated with a specific file in Google Drive. It allows users to view the labels applied to a file, facilitating better organization and management of file metadata.
-
List File Revisions
This action retrieves the revision history of a specified file in Google Drive. It allows users to see all the changes made to the file over time.
-
List Folder 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.
-
List Permissions
This action retrieves the permissions associated with a specific file or shared drive. It helps in understanding who has access and what level of permissions they hold for the resource.
-
List Properties (v2 API)
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.
-
List Replies to Comment
This action retrieves all replies to a specific comment on a Google Drive file. It provides functionality to include deleted replies and paginate through the results if there are many replies.
-
List Shared Drives
This action retrieves a list of shared drives that the authenticated user has access to. It allows users to see and manage all shared drives within their domain, if they have the appropriate permissions.
-
Modify File Labels
This action modifies the labels assigned to a specific file in Google Drive. It allows users to add, update, or remove labels associated with the file.
-
Move File
This action moves a specified file in Google Drive from one folder to another. It allows the user to specify both the destination and source folders, making file organization easier.
-
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…
-
Patch Property (v2 API)
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.
-
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…
-
Stop Watch Channel
This action stops watching a previously established notification channel for a specified resource. It is used to cease future notifications regarding changes to that resource.
-
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.
-
Unhide Shared Drive
This action allows you to unhide a shared drive, making it visible in the default view. You can use this when the shared drive has been hidden and needs to be restored for visibility.
-
Untrash File
Restores a file from the trash, allowing users to recover deleted files. This action modifies the file’s metadata to indicate it is no longer trashed.
-
Update Comment
This action updates an existing comment on a Google Drive file. It allows you to modify the comment's text. Note: To resolve a comment, use the CREATE_REPLY action with action='resolve'.
-
Update File (Metadata)
This action allows you to update the metadata of an existing file in Google Drive. You can modify attributes such as the file's name, description, and parent folder associations.
-
Update File Metadata (PATCH V2)
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.
-
Update File Revision Metadata
Updates metadata properties of a specific file revision in Google Drive (NOT file content). Use this to mark a revision as 'keep forever' or to publish/unpublish a revision. Requires both file_id and revision_id. Does…
-
Update Permission
This action updates the permissions granted on a file or shared drive. It allows you to change roles, manage expiration dates, and transfer ownership of the file.
-
Update Property (v2 API)
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.
-
Update Reply
This action allows users to update an existing reply to a comment on a Google Drive file. It modifies the plain text content of the reply based on the provided identifiers.
-
Update Shared Drive
This action updates the metadata of a specified shared drive in Google Drive. It allows you to change the drive's name, color, theme, background image, and apply certain restrictions.
-
Upload File
This action uploads a specified file to Google Drive, with an option to place it in a specific folder if an ID is provided. If no folder ID is given, the file will be uploaded to the root directory of the Drive.
-
Upload File From URL to Drive
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.
-
Upload/Update File Content
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.
-
Watch Drive Changes
This action allows clients to subscribe to changes occurring in a specific user's Google Drive or a shared drive. The subscription sends notifications to a specified URL whenever a change is detected.
-
Watch File for Changes
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.
-
Comment Added (Docs/Sheets/Slides)
Triggers when a new comment is added to Google Docs, Sheets, or Slides.
-
File Created
Triggers when a new file is created in Google Drive.
-
File Deleted or Trashed
Triggers when a file is moved to trash or permanently deleted in Drive.
-
File Shared (Permissions Added)
Triggers when new sharing permissions are granted to a file or folder. Uses Drive's `changes.list` endpoint with inline `permissions` in the `fields` mask so each change carries the file's current permission set…
-
File Updated
Triggers when a file's metadata or content changes in Google Drive.
-
Google Drive Changes
Triggers when changes are detected in a Google Drive.
-
New File Matching Query
Triggers when a new Google Drive file matches a provided query. This is the legacy query-centric trigger: it preserves Drive API query config such as ``corpora`` / ``driveId`` aliases and emits the historical…
Setup
Connect Google Drive in Hookshot™
Pick a scope, then confirm what can start a Protege and what it can do.
Trigger Access
What can start a Protege from this app.
Tool Access
What a Protege can do after it starts.
Connection scope
Prefer team for production.
Personal
Tied to one user—only when the workflow needs their account.
Chat
Team-scoped for supported chat surfaces.
Build with us
See Hookshot™ in your stack.
Request early access or book a live walkthrough with the team.
