Skip to main content

OneDrive

Comprehensive OneDrive connector for managing files, folders, sharing, and metadata operations via Microsoft Graph API.

What you can ask​

  • Find files in /Sales/Proposals modified in the last 7 days.
  • Share the Q2 Onboarding folder with view-only access to onboarding@acme.com.
  • Move files older than 1 year from /Active to /Archive.

Set up​

OneDrive needs an OAuth application from your organization before anyone can connect. An organization admin completes these steps once.

  1. Go to Organization > Connectors and find OneDrive. Click Enable, and choose which tools to allow.
  2. Create an OAuth application in the Microsoft Entra admin center.
  3. Add the Redirect URI shown in the connector settings to the application.
  4. Copy the application's Client ID and Client Secret into the connector, then save it.
  5. 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.All
  • Files.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.

ToolWhat it does
access_shared_itemAccess a shared item using sharing URL
check_item_sharing_statusCheck sharing status of an item
check_thumbnail_availabilityCheck if thumbnails are available for an item
compare_item_versionsCompare two versions of a file
download_itemDownload a file's raw bytes from OneDrive as base64.
get_driveGet information about a specific drive by ID
get_drive_ownerGet owner information for a drive
get_drive_usageGet storage usage information for a drive
get_file_activityGet activity history for files and folders.
get_itemGet a drive item by ID or path
get_item_versionGet details of a specific version
get_my_driveGet the user's default OneDrive
get_permissionGet a specific permission by ID
get_previewGenerate a preview link for an item
get_root_folderGet the root folder of a drive
get_sharing_linkGet sharing link information for an item
get_special_folderGet a special folder (Documents, Photos, etc.)
get_thumbnailGet a specific thumbnail size for an item
get_thumbnail_urlsGet thumbnail URLs for an item
get_thumbnailsGet all available thumbnails for an item
get_version_download_urlGet download URL for a specific version of a file
list_deleted_itemsList items in the recycle bin.
list_item_versionsList all versions of a file
list_itemsList children of a folder.
list_my_drivesList all drives available to the user
list_permissionsList permissions for an item
read_item_textRead a OneDrive file's contents as text, by item_id (from list_items or search_items) or path.
search_itemsSimple free-text search for items in OneDrive by name/content.
search_items_advancedSearch OneDrive with filters: file types, content category, modified/created, date ranges, size range, modified-by-me, and folder scoping.
validate_credentialValidate OneDrive credentials.

Write (6)​

Create or send data.

ToolWhat it does
copy_itemCopy an item to a different location
create_folderCreate a new folder
create_sharing_linkCreate a sharing link for an item
grant_permissionGrant permissions to recipients for an item
restore_deleted_itemRestore an item from the recycle bin
upload_fileUpload a file to OneDrive.

Delete or overwrite (6)​

Remove or replace existing data.

ToolWhat it does
delete_itemDelete an item from OneDrive
delete_permissionRemove a permission from an item
move_itemMove an item to a different folder
restore_item_versionRestore a previous version of a file
update_itemUpdate item metadata
update_permissionUpdate roles for a user/group permission
⌘J