OneDrive
Comprehensive OneDrive connector for managing files, folders, sharing, and metadata operations via Microsoft Graph API.
What you can ask
- Find files in
/Sales/Proposalsmodified in the last 7 days. - Share the
Q2 Onboardingfolder with view-only access to onboarding@acme.com. - Move files older than 1 year from
/Activeto/Archive.
Set up
OneDrive needs an OAuth application from your organization before anyone can connect. An organization admin completes these steps once.
- Go to Organization > Connectors and find OneDrive. Click Enable, and choose which tools to allow.
- Create an OAuth application in the Microsoft Entra admin center.
- Add the Redirect URI shown in the connector settings to the application.
- Copy the application's Client ID and Client Secret into the connector, then save it.
- Each member connects their own account the first time they use it.
⚠️ Warning: Do not enter your Devs.ai or OneDrive login email or password in the OAuth application fields.
To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.
OAuth scopes used by these tools (2)
Grant the scopes for the tools you plan to allow.
Files.Read.AllFiles.ReadWrite.All
Tools
OneDrive offers 42 tools. Admins choose which ones agents can use. See Tool permission groups.
Read (30)
View and search information without changing it.
| Tool | What it does |
|---|---|
access_shared_item | Access a shared item using sharing URL |
check_item_sharing_status | Check sharing status of an item |
check_thumbnail_availability | Check if thumbnails are available for an item |
compare_item_versions | Compare two versions of a file |
download_item | Download a file's raw bytes from OneDrive as base64. |
get_drive | Get information about a specific drive by ID |
get_drive_owner | Get owner information for a drive |
get_drive_usage | Get storage usage information for a drive |
get_file_activity | Get activity history for files and folders. |
get_item | Get a drive item by ID or path |
get_item_version | Get details of a specific version |
get_my_drive | Get the user's default OneDrive |
get_permission | Get a specific permission by ID |
get_preview | Generate a preview link for an item |
get_root_folder | Get the root folder of a drive |
get_sharing_link | Get sharing link information for an item |
get_special_folder | Get a special folder (Documents, Photos, etc.) |
get_thumbnail | Get a specific thumbnail size for an item |
get_thumbnail_urls | Get thumbnail URLs for an item |
get_thumbnails | Get all available thumbnails for an item |
get_version_download_url | Get download URL for a specific version of a file |
list_deleted_items | List items in the recycle bin. |
list_item_versions | List all versions of a file |
list_items | List children of a folder. |
list_my_drives | List all drives available to the user |
list_permissions | List permissions for an item |
read_item_text | Read a OneDrive file's contents as text, by item_id (from list_items or search_items) or path. |
search_items | Simple free-text search for items in OneDrive by name/content. |
search_items_advanced | Search OneDrive with filters: file types, content category, modified/created, date ranges, size range, modified-by-me, and folder scoping. |
validate_credential | Validate OneDrive credentials. |
Write (6)
Create or send data.
| Tool | What it does |
|---|---|
copy_item | Copy an item to a different location |
create_folder | Create a new folder |
create_sharing_link | Create a sharing link for an item |
grant_permission | Grant permissions to recipients for an item |
restore_deleted_item | Restore an item from the recycle bin |
upload_file | Upload a file to OneDrive. |
Delete or overwrite (6)
Remove or replace existing data.
| Tool | What it does |
|---|---|
delete_item | Delete an item from OneDrive |
delete_permission | Remove a permission from an item |
move_item | Move an item to a different folder |
restore_item_version | Restore a previous version of a file |
update_item | Update item metadata |
update_permission | Update roles for a user/group permission |