AIMicrosoft 365
OneDrive
Manage OneDrive files and folders from the agent.
OneDrive
Lets the agent find, download, upload, move and delete files and folders on OneDrive. It requires a Microsoft 365 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 OneDrive for files and folders by text.
| Parameter | Required | Default | What it is |
|---|---|---|---|
| Query | Yes | — | The text to search for in the files and folders |
| Maximum results | No | 10 | How many items to return at most |
| Order by | No | lastModifiedDateTime | The sort field: name, size or lastModifiedDateTime |
Get a file
Returns one file's or folder's metadata by its ID.
| Parameter | Required | Default | What it is |
|---|---|---|---|
| Item ID | Yes | — | The unique ID of the file or folder |
Download a file
Returns a OneDrive file's download URL.
| Parameter | Required | Default | What it is |
|---|---|---|---|
| Item ID | Yes | — | The unique ID of the file to download |
Upload a file
Uploads a file to OneDrive. It handles files up to 4 MB.
| Parameter | Required | Default | What it is |
|---|---|---|---|
| File name | Yes | — | The file's name in OneDrive (e.g. report.pdf) |
| Destination folder | No | / | The destination folder's path in OneDrive (e.g. /Documents). Default: the root |
| Content (base64) | No | — | The file's content, base64-encoded. Omit it to create an empty file |
| MIME type | No | application/octet-stream | The file's type (e.g. text/plain, application/pdf) |
| On conflict | No | rename | What happens when a file of the same name exists: rename, replace or fail |
Move a file
Moves or renames a file or folder in OneDrive.
| Parameter | Required | Default | What it is |
|---|---|---|---|
| Item ID | Yes | — | The unique ID of the file or folder to move or rename |
| Destination folder ID | No | — | The destination folder's ID. Omit it to rename only |
| New name | No | — | The file's or folder's new name. Omit it to move only |
At least one of "Destination folder ID" or "New name" has to be given.
Delete a file
Removes a file or folder from OneDrive.
| Parameter | Required | Default | What it is |
|---|---|---|---|
| Item ID | Yes | — | The unique ID of the file or folder to delete |