Update file with the Google Drive API
Renames, describes, stars, moves or trashes a file or folder; only the fields sent change. To move it, pass the new folder in addParents and the current one, from the parents of Get file, in removeParents. A folder of My Drive cannot move into a shared drive.
- Identifier
- google_drive_update_file
The request
POST https://connect.reportei.com/api/tools/google_drive_update_file/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"fileId": "<fileId>"
}
}Your system sends your customer's connection id and the tool arguments. The headers are the same as the rest of the Connect API: your product's token and your customer's token.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| fileId | string | Yes | File or folder id from List files. |
| name | string | No | New name. |
| description | string | No | New short description. |
| starred | boolean | No | Stars or unstars the file for the account. |
| trashed | boolean | No | true moves the file to the trash, where it stays for 30 days, and false restores it. Only the owner can trash a file of My Drive. |
| addParents | string | No | Folder id from List files to move the file into, or several ids separated by commas. |
| removeParents | string | No | Folder id to take the file out of, usually its current parent from Get file, or several ids separated by commas. |
| supportsAllDrives | boolean | No | Set to true when the file can be in a shared drive. |
Supported connections
Your customer connects their Google Drive account once, with one of the modes below. The same connection serves every tool of the toolkit.
OAuth with your product's app
You register your product's OAuth app once, with POST /api/merchants/credentials/google_drive, and your customer authorizes the account on a consent screen. Connect renews the token when it is about to expire.
The response
On success, Connect preserves the app's response status and body. HTTP errors returned by the app use the {error, api_error} envelope; authentication or validation can fail before execution. The X-Toolkit-Execution-Id header identifies the recorded execution, available at GET /api/tools/executions/{uuid}.
Ready for AI agents
This tool's input is a JSON Schema, available at GET /api/tools/google_drive_update_file. It becomes your agent's tool definition with no conversion.
Other Google Drive tools
- List filesGETSearches the files and folders the account can see. Each file comes with only id, name and mimeType unless fields asks for more, such as webViewLink, modifiedTime and parents. To leave out the trash, add trashed = false to q. Pass nextPageToken as pageToken to read the next page.
- Get fileGETGets the metadata of a file or folder, not its content. webViewLink is the address that opens it in the browser, and parents has the id of the folder it is in.
- Create filePOSTCreates a file with metadata only, without content: a folder, or an empty Google Doc, Sheet or Slides presentation, chosen by mimeType. Returns id, name and mimeType, plus whatever fields asks for, such as webViewLink.
- Copy filePOSTCopies a file, such as a report template, and returns the new file. Without parents the copy stays in the same folder as the original. Folders cannot be copied.
- List shared drivesGETLists the shared drives the account is a member of, with id and name. The id goes in driveId of List files. Pass nextPageToken as pageToken to read the next page.
- List permissionsGETLists who has access to a file or folder. Without fields each permission has only basic fields, such as id, type and role: ask for emailAddress and displayName in fields to see who it is. Pass nextPageToken as pageToken to read the next page.
- Create permissionPOSTShares a file or folder and returns the new permission with its id. Google emails the users and groups it is shared with, unless sendNotificationEmail is false. emailAddress is required for type user or group, and domain for type domain.
- Update permissionPATCHChanges the role or the expiration of an access that already exists, and returns the permission.
Toolkits in the same category
See all 100 toolkitsSee Connect applied to your product.
Try it for 15 days with no card, or walk our team through your use case.
