Microsoft OneDrive
List files and folders, download files, upload files, and create or delete folders
Connect Microsoft OneDrive when a project needs bounded file access for a shared account or for each published app user.
Available operations
| Operation | What it does | Permission | Limit per minute |
|---|---|---|---|
list_items | Lists up to 50 files and folders | Read files | 30 |
get_item | Reads file or folder metadata | Read files | 30 |
download_file | Downloads one file up to 750 KiB | Read files | 10 |
upload_file | Uploads one file up to 750 KiB to the drive root | Manage files | 5 |
create_folder | Creates one folder | Manage files | 10 |
delete_item | Deletes one file or folder | Manage files | 10 |
Connect Microsoft OneDrive
An administrator first configures Microsoft OAuth application and enables Microsoft OneDrive under Admin > Settings > Integrations.
Tell the AI whether one workspace account owns the files or every published app user connects their own drive. Examples:
- “Upload generated receipts to our shared OneDrive.”
- “Let each signed-in user list and download files from their own OneDrive.”
Choose Connect new, select read or manage access, authorize Microsoft, then select Continue. For published app users, enter the final HTTPS app origin before authorizing.
Verify Microsoft OneDrive
- Create a folder named
Swarmz connector test. - Upload a small text file with a unique name.
- List the drive root and confirm the file.
- Download the file and compare its contents with the upload.
- Delete the file and test folder.
Uploads target the drive root. Moving an upload into another folder is not an available operation. Downloads and uploads larger than 750 KiB fail before provider data is returned or written. For larger files, use a direct Microsoft upload-session implementation in the generated app instead of this connector.
Disconnecting leaves OneDrive files unchanged. Keep gateway calls in authenticated server code and authorize every file result for the signed-in app user.