OneDrive

Also an agent tool

productivity

Microsoft OneDrive / OneDrive for Business via the Microsoft Graph API (v1.0). Drives (get a user's/group's/site's default drive, get a drive by id, list a user's drives), DriveItems — get by id or by path, list children, create folder, upload small file (PUT .../content), create resumable upload session (large files), download content, update/rename (PATCH), move, copy, delete, get by path, search, list/get/restore versions, thumbnails, preview, and recent/shared-with-me/special-folder navigation. Sharing & permissions: list/get/update/delete permissions, create sharing links, and invite people. Change tracking via delta (GET /drives/{drive-id}/root/delta) with an @odata.deltaLink token cursor for polling. Sites & Lists reads for SharePoint-backed drives. Subscription (change-notification) CRUD is exposed as actions for advanced use. Base URL is the static Graph host https://graph.microsoft.com/v1.0. Auth is OAuth2 client_credentials (Azure AD app-only): the runtime mints an app-only token from https://login.microsoftonline.com/{config.tenant_id}/oauth2/v2.0/token (grant_type=client_credentials) using client_id + client_secret with scope https://graph.microsoft.com/.default. App-only tokens have no signed-in user, so there is no /me — all file operations are addressed by drive-id, user-id, group-id, or site-id (onedrive-01). Microsoft Graph change notifications use a validationToken handshake + clientState (not an HMAC of the body), which is not one of the platform's registered signature handlers — the change-notification path is a delta polling trigger; subscription management is documented and exposed as actions (onedrive-02).

Provider API docs ↗

45 actions · 4 triggers

The OneDrive integration lets you connect OneDrive to your automations with 45 actions and 4 triggers — and every action is also a tool an AI agent can call. Examples: List Users, Get User Drive, List User Drives, Get Group Drive, Get Site Drive. No blank-canvas wiring — connect it and use it in your workflows.

Every action below is also a tool an AI agent can call — the same pack powers your workflows and your agents.

Triggers 4

Events in OneDrive that can start a workflow.

webhook

Drive Item Created

Fires on a Microsoft Graph change notification with `changeType: created`.

webhook

Drive Item Changed

Fires on a Microsoft Graph change notification with `changeType: updated`.

webhook

Drive Item Deleted

Fires on a Microsoft Graph change notification with `changeType: deleted`.

polling

New or changed OneDrive files (polled)

Polls GET /drives/{drive-id}/root/delta on a schedule. The first run enumerates the drive and stores the @odata.deltaLink token; each later run returns only items changed since. Requires a drive-id.

Actions 45

What Zervanor can do in OneDrive.

Drives32

GET

Get Drive

Get a drive by id (GET /drives/{drive-id}).

GET

Get Drive Root

Get the root DriveItem of a drive (GET /drives/{drive-id}/root).

GET

List Root Children

List the items in the root of a drive (GET /drives/{drive-id}/root/children).

GET

Get Item

Get a DriveItem's metadata by id (GET /drives/{drive-id}/items/{item-id}).

GET

Get Item By Path

Get a DriveItem's metadata by its path relative to the drive root (GET /drives/{drive-id}/root:/{item-path}). Note the ':' path addressing.

GET

List Children

List the children of a folder DriveItem (GET /drives/{drive-id}/items/{item-id}/children).

GET

List Children By Path

List the children of a folder addressed by path (GET /drives/{drive-id}/root:/{item-path}:/children).

POST

Create Folder

Create a folder under a parent DriveItem (POST /drives/{drive-id}/items/{parent-item-id}/children). Body must include name, an empty folder object, and a conflict behavior.

PUT

Upload Small File

Upload or replace the contents of a file up to 250 MB by path (PUT /drives/{drive-id}/root:/{item-path}:/content). Sends the raw file bytes as the request body.

PUT

Upload File To Folder

Upload a new small file into a folder by id and name (PUT /drives/{drive-id}/items/{parent-item-id}:/{filename}:/content).

POST

Create Upload Session

Create a resumable upload session for a large file (POST /drives/{drive-id}/root:/{item-path}:/createUploadSession). Returns an uploadUrl to PUT byte ranges to.

GET

Download Content

Download a file's contents (GET /drives/{drive-id}/items/{item-id}/content). Returns a 302 redirect to a short-lived pre-authenticated download URL.

PATCH

Update Item

Update a DriveItem's metadata, including renaming (PATCH /drives/{drive-id}/items/{item-id}). Set name to rename; set parentReference to move.

PATCH

Move Item

Move a DriveItem to a different folder (PATCH /drives/{drive-id}/items/{item-id}) by setting parentReference. Optionally rename during the move.

POST

Copy Item

Copy a DriveItem to a new parent and/or name (POST /drives/{drive-id}/items/{item-id}/copy). Asynchronous — returns 202 with a Location header to monitor progress.

DELETE

Delete Item

Delete a DriveItem, moving it to the recycle bin (DELETE /drives/{drive-id}/items/{item-id}).

GET

Search Items

Search a drive for items matching a query (GET /drives/{drive-id}/root/search(q='{query}')).

GET

List Versions

List the versions of a DriveItem (GET /drives/{drive-id}/items/{item-id}/versions).

GET

Get Version Content

Download the contents of a specific version of a DriveItem (GET /drives/{drive-id}/items/{item-id}/versions/{version-id}/content).

POST

Restore Version

Restore a previous version of a DriveItem as the current version (POST /drives/{drive-id}/items/{item-id}/versions/{version-id}/restoreVersion).

GET

List Thumbnails

List thumbnail sets for a DriveItem (GET /drives/{drive-id}/items/{item-id}/thumbnails).

POST

Get Item Preview

Get a short-lived embeddable preview URL for a DriveItem (POST /drives/{drive-id}/items/{item-id}/preview).

GET

List Permissions

List the permissions on a DriveItem (GET /drives/{drive-id}/items/{item-id}/permissions).

GET

Get Permission

Get a single permission on a DriveItem (GET /drives/{drive-id}/items/{item-id}/permissions/{perm-id}).

PATCH

Update Permission

Update the roles of a permission on a DriveItem (PATCH /drives/{drive-id}/items/{item-id}/permissions/{perm-id}).

DELETE

Delete Permission

Remove a permission from a DriveItem (DELETE /drives/{drive-id}/items/{item-id}/permissions/{perm-id}).

POST

Create Sharing Link

Create a sharing link for a DriveItem (POST /drives/{drive-id}/items/{item-id}/createLink).

POST

Invite People

Send a sharing invitation for a DriveItem to one or more recipients (POST /drives/{drive-id}/items/{item-id}/invite).

GET

List Changes (Delta)

Track changes to items in a drive since the last sync (GET /drives/{drive-id}/root/delta). Returns changed items plus an @odata.deltaLink (token cursor); the first call with no token returns the full item set and the initial deltaLink. This is the polling trigger.

GET

List Recent Items

List files recently used by the drive's owner (GET /drives/{drive-id}/recent).

GET

List Shared With Me

List items that have been shared with the drive's owner (GET /drives/{drive-id}/sharedWithMe).

GET

Get Special Folder

Get a named special folder such as documents, photos, or approot (GET /drives/{drive-id}/special/{special-name}).

Sites5

GET

Get Site Drive

Get a SharePoint site's default document library drive (GET /sites/{site-id}/drive).

GET

Get Site

Get a SharePoint site by id (GET /sites/{site-id}).

GET

List Site Drives

List the document libraries (drives) of a SharePoint site (GET /sites/{site-id}/drives).

GET

List Site Lists

List the SharePoint lists in a site (GET /sites/{site-id}/lists).

GET

List List Items

List the items in a SharePoint list, expanding their fields (GET /sites/{site-id}/lists/{list-id}/items).

Subscriptions4

POST

Create Subscription

Create a Microsoft Graph change-notification subscription for a drive resource (POST /subscriptions). Advanced use — Graph validates the notificationUrl with a validationToken handshake; see webhooks docs.

GET

List Subscriptions

List the app's active change-notification subscriptions (GET /subscriptions).

PATCH

Renew Subscription

Renew (extend the expiry of) a change-notification subscription (PATCH /subscriptions/{subscription-id}).

DELETE

Delete Subscription

Delete a change-notification subscription (DELETE /subscriptions/{subscription-id}).

Users3

GET

List Users

List users in the tenant (GET /users). App-only connectivity + identity probe — confirms the app-only token and directory access.

GET

Get User Drive

Get a user's default OneDrive (GET /users/{user-id}/drive).

GET

List User Drives

List all drives available to a user (GET /users/{user-id}/drives).

Groups1

GET

Get Group Drive

Get a Microsoft 365 group's default document library drive (GET /groups/{group-id}/drive).

Automations using OneDrive

Build your own automation with OneDrive in the visual builder.

Frequently asked questions

What can I automate with OneDrive?

45 actions are available — for example: List Users, Get User Drive, List User Drives, Get Group Drive, Get Site Drive, and more.

Which OneDrive events can start a workflow?

4 triggers — for example: Drive Item Created, Drive Item Changed, Drive Item Deleted, New or changed OneDrive files (polled).

Can OneDrive be used as an AI agent tool?

Yes. Every OneDrive action automatically becomes a tool an AI agent can call — the same pack powers both your workflows and your agents.

How is the OneDrive integration modelled?

OneDrive is modelled as a versioned connector pack, and the steps that need reasoning fall to first-party agents hosted in the same runtime as the workflows.