OneDrive

OneDrive is Microsoft’s cloud storage and file synchronization service that allows users to securely store, access, and share files across devices. Integrated deeply into the Microsoft 365 ecosystem, OneDrive supports seamless collaboration, version control, and real-time access to content across teams and organizations.

Learn how to integrate the OneDrive tool in Sim to automatically pull, manage, and organize your cloud files within your workflows. This tutorial walks you through connecting OneDrive, setting up file access, and using stored content to power automation. Ideal for syncing essential documents and media with your agents in real time.

With OneDrive, you can:

  • Store files securely in the cloud: Upload and access documents, images, and other files from any device
  • Organize your content: Create structured folders and manage file versions with ease
  • Collaborate in real time: Share files, edit them simultaneously with others, and track changes
  • Access across devices: Use OneDrive from desktop, mobile, and web platforms
  • Integrate with Microsoft 365: Work seamlessly with Word, Excel, PowerPoint, and Teams
  • Control permissions: Share files and folders with custom access settings and expiration controls

In Sim, the OneDrive integration enables your agents to directly interact with your cloud storage. Agents can upload new files to specific folders, retrieve and read existing files, and list folder contents to dynamically organize and access information. This integration allows your agents to incorporate file operations into intelligent workflows — automating document intake, content analysis, and structured storage management. By connecting Sim with OneDrive, you empower your agents to manage and use cloud documents programmatically, eliminating manual steps and enhancing automation with secure, real-time file access.

Usage Instructions

Integrate OneDrive into the workflow. Can create text and Excel files, upload files, download files, list and search files, move or rename files, copy files, create sharing links, and delete files or folders.

Actions

onedrive_upload

Upload a file to OneDrive

Input

ParameterTypeRequiredDescription
fileNamestringYesThe name of the file to upload (e.g., "report.pdf", "data.xlsx")
filefileNoThe file to upload (binary)
contentstringNoThe text content to upload (if no file is provided)
mimeTypestringNoThe MIME type of the file to create (e.g., text/plain for .txt, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet for .xlsx)
folderIdstringNoFolder ID to upload the file to (e.g., "01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36M")

Output

ParameterTypeDescription
successbooleanWhether the file was uploaded successfully
fileobjectThe uploaded file object with metadata including id, name, webViewLink, webContentLink, and timestamps

onedrive_create_folder

Create a new folder in OneDrive

Input

ParameterTypeRequiredDescription
folderNamestringYesName of the folder to create (e.g., "My Documents", "Project Files")
folderIdstringNoParent folder ID to create the folder in (e.g., "01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36M")

Output

ParameterTypeDescription
successbooleanWhether the folder was created successfully
fileobjectThe created folder object with metadata including id, name, webViewLink, and timestamps

onedrive_download

Download a file from OneDrive

Input

ParameterTypeRequiredDescription
fileIdstringYesThe ID of the file to download (e.g., "01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36M")
fileNamestringNoOptional filename override (e.g., "report.pdf", "data.xlsx")

Output

ParameterTypeDescription
filefileDownloaded file stored in execution files

onedrive_list

List files and folders in OneDrive

Input

ParameterTypeRequiredDescription
folderIdstringNoFolder ID to list files from (e.g., "01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36M")
querystringNoFilter files by name prefix (e.g., "report", "invoice_2024")
pageSizenumberNoMaximum number of files to return (e.g., 10, 50, 100)
pageTokenstringNoContinuation URL from a previous response's nextPageToken, used to fetch the next page

Output

ParameterTypeDescription
successbooleanWhether files were listed successfully
filesarrayArray of file and folder objects with metadata
nextPageTokenstringToken for retrieving the next page of results (optional)

Search for files and folders across OneDrive by name, metadata, or content (recursive)

Input

ParameterTypeRequiredDescription
querystringNoSearch text matched against file name, metadata, and content. Not required when paginating with pageToken
pageSizenumberNoMaximum number of results to return (e.g., 10, 50, 100)
pageTokenstringNoContinuation URL from a previous response's nextPageToken, used to fetch the next page

Output

ParameterTypeDescription
successbooleanWhether the search completed successfully
filesarrayArray of file and folder objects matching the search query
nextPageTokenstringToken for retrieving the next page of results (optional)

onedrive_get_item

Get metadata for a specific OneDrive file or folder by ID, or the drive root

Input

ParameterTypeRequiredDescription
fileIdstringNoThe ID of the file or folder to retrieve (e.g., "01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36M"). Leave empty to get the drive root folder

Output

ParameterTypeDescription
successbooleanWhether the item metadata was retrieved
fileobjectThe file or folder metadata, including id, name, webViewLink, size, and timestamps

onedrive_get_drive_info

Get information about the OneDrive drive, including storage quota

Input

ParameterTypeRequiredDescription

Output

ParameterTypeDescription
successbooleanWhether the drive info was retrieved
driveIdstringThe ID of the drive
driveTypestringThe type of drive (e.g., "personal", "business")
webUrlstringURL to the drive in the browser
ownerstringDisplay name of the drive owner
quotaobjectStorage quota information in bytes (total, used, remaining, deleted, state)

onedrive_move

Move a file or folder to a new parent folder, rename it, or both

Input

ParameterTypeRequiredDescription
fileIdstringYesThe ID of the file or folder to move or rename
destinationFolderIdstringNoThe ID of the destination parent folder (omit to only rename in place)
newNamestringNoThe new name for the file or folder (omit to only move)

Output

ParameterTypeDescription
successbooleanWhether the move or rename was successful
fileobjectThe updated file object with its new name and/or parent folder

onedrive_copy

Copy a file or folder to another location within OneDrive

Input

ParameterTypeRequiredDescription
fileIdstringYesThe ID of the file or folder to copy
destinationFolderIdstringYesThe ID of the destination parent folder
destinationFileNamestringNoOptional new name for the copy (defaults to the original name)

Output

ParameterTypeDescription
successbooleanWhether the copy request was accepted
sourceFileIdstringThe ID of the file or folder that was copied
namestringThe requested name for the copy, if provided
monitorUrlstringURL to poll for the status of the asynchronous copy operation (copy completes in the background)

Create a view or edit sharing link for a OneDrive file or folder

Input

ParameterTypeRequiredDescription
fileIdstringYesThe ID of the file or folder to share
linkTypestringNoType of link to create: "view" (read-only), "edit" (read-write), or "embed"
linkScopestringNoWho can use the link: "anonymous" (anyone), "organization" (tenant members), or "users" (specific people)

Output

ParameterTypeDescription
successbooleanWhether the sharing link was created successfully
linkobjectThe created sharing link, including its type, scope, and URL

onedrive_delete

Delete a file or folder from OneDrive

Input

ParameterTypeRequiredDescription
fileIdstringYesThe ID of the file or folder to delete (e.g., "01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36M")

Output

ParameterTypeDescription
successbooleanWhether the file was deleted successfully
deletedbooleanConfirmation that the file was deleted
fileIdstringThe ID of the deleted file

On this page