Google Drive
Manage files and folders on Google Drive from the agent.
Google Drive
Lets the agent find, download, upload, move and delete files and folders on Google Drive. It requires a Google Drive connection configured in the workspace.
The available operations
When you add this tool, choose which operations the agent is allowed to perform.
Find files
Searches Drive for files and folders with a query.
| Parameter | Required | Default | What it is |
|---|---|---|---|
| Query | Yes | — | The search criteria, Drive-style (e.g. name contains 'report', mimeType='application/pdf', 'me' in owners) |
| Maximum results | No | 10 | How many items to return at most |
| Order by | No | modifiedTime desc | The sort order (e.g. modifiedTime desc, name asc) |
| Shared Drive ID | No | — | The ID of a Shared Drive to search. Omitted, it searches My Drive |
Get a file
Returns a file's or folder's full metadata by its ID.
| Parameter | Required | Default | What it is |
|---|---|---|---|
| File ID | Yes | — | The unique ID of the file or folder |
Download a file
Returns a Drive file's download URL. For Google Workspace files (Docs, Sheets, Slides) you can choose the export format.
| Parameter | Required | Default | What it is |
|---|---|---|---|
| File ID | Yes | — | The unique ID of the file to download |
| Export format | No | — | For Google Workspace files, the target format (e.g. application/pdf, text/csv, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet) |
Upload a file
Uploads a file to Drive. It can also create blank native Google Workspace files (Docs, Sheets, Slides).
| Parameter | Required | Default | What it is |
|---|---|---|---|
| Name | Yes | — | The file's name in Drive |
| Content (base64) | No | — | The file's content, base64-encoded. Omit it for native Google Workspace files |
| MIME type | No | application/octet-stream | The file's type (e.g. text/plain, application/pdf, application/vnd.google-apps.spreadsheet) |
| Destination folder ID | No | — | The folder to save it in. Omitted, it goes to My Drive's root |
| Description | No | — | The file's description |
Move a file
Moves or renames a file or folder in Drive.
| Parameter | Required | Default | What it is |
|---|---|---|---|
| File ID | Yes | — | The unique ID of the file or folder to move or rename |
| Destination folder ID | No | — | The destination folder. Omit it to rename only |
| New name | No | — | The file's or folder's new name. Omit it to move only |
| Source folder ID | No | — | The current folder (needed when moving between folders, to drop the previous reference) |
At least one of "Destination folder ID" or "New name" has to be given.
Delete a file
Removes a file or folder from Drive.
| Parameter | Required | Default | What it is |
|---|---|---|---|
| File ID | Yes | — | The unique ID of the file or folder to remove |
| Move to bin | No | true | With true, the item goes to the bin (recoverable). With false, it is deleted permanently |