OneDrive

Connect OneDrive so your agents can work in your OneDrive account. You choose an access level for each account, and Squad refuses any agent action outside that level.

Access levels

Each OneDrive account has an access level: Read-only, Read + write, and Full access. Squad refuses any agent action outside that level. You can also narrow or block single agents under Per-agent access.

Level	The connect window describes this level as	Actions agents can use
Read-only	”Read your OneDrive files only.”	46 of 83
Read + write (recommended)	“Read and upload/edit/delete files.”	79 of 83
Full access	”Also access shared files and SharePoint sites.”	83 of 83

Read + write is the recommended level. The connect window selects it for you, and you can choose another level. The OneDrive sign-in page asks you to approve full access to your account. This is expected. Squad does not narrow the sign-in. It checks every agent action against the level you chose, and it refuses actions outside that level.

What agents can do at each level

Each level opens with a short summary in plain tasks, then lists every action it adds, grouped by what the action works on. You do not need to name actions. Ask in plain words, and the agent searches for the matching action.

Find an action. Open a level and use your browser’s find (Ctrl+F, or Cmd+F on a Mac) with a word from the task or part of a slug. Or ask your agent in plain words, for example “What can you do in my OneDrive account?” The agent can search the OneDrive actions for you.

Each action shows its name, a one-line description where the OneDrive action catalog has one, and its slug. The slug is the ID that agents use when they call the action.

Read-only

Agents can use 46 of the 83 OneDrive actions at this level:

View and search files and folders
View change history
View drives
View and search files
View and search sites
View activities
View and search folders
View roles and permissions
View versions
View cells and ranges
View columns
View comments

All 46 actions at this level:

Activities (2)

Action	What it does	Slug
List activities	Retrieve recent activities on the authenticated user’s OneDrive.	`ONE_DRIVE_LIST_ACTIVITIES`
List item activities	List recent activities for a specific item in a OneDrive drive.	`ONE_DRIVE_LIST_ITEM_ACTIVITIES`

Cells and ranges (1)

Action	What it does	Slug
Read workbook range	Reads a range of cells from an Excel workbook worksheet stored in OneDrive or SharePoint using Microsoft Graph API.	`ONE_DRIVE_READ_WORKBOOK_RANGE`

Change history (3)

Action	What it does	Slug
List root drive changes	List changes in the root of the user’s primary drive using a delta token.	`ONE_DRIVE_LIST_ROOT_DRIVE_CHANGES`
List SharePoint list items delta	Track changes to items in a SharePoint list using a delta query.	`ONE_DRIVE_LIST_SHAREPOINT_LIST_ITEMS_DELTA`
List site items delta	Track changes to DriveItems in the default document library of a SharePoint site.	`ONE_DRIVE_LIST_SITE_ITEMS_DELTA`

Columns (1)

Action	What it does	Slug
List site columns	List all column definitions for a SharePoint site.	`ONE_DRIVE_LIST_SITE_COLUMNS`

Comments (1)

Action	What it does	Slug
Get document comments		`ONE_DRIVE_GET_DOCUMENT_COMMENTS`

Content (1)

Action	What it does	Slug
Get site page content	Gets the content of a modern SharePoint site page.	`ONE_DRIVE_GET_SITE_PAGE_CONTENT`

Drives (3)

Action	What it does	Slug
Get drive	Retrieves the properties and relationships of a Drive resource by its unique ID.	`ONE_DRIVE_GET_DRIVE`
Get group drive	Retrieve the document library (drive) for a Microsoft 365 group.	`ONE_DRIVE_GET_GROUP_DRIVE`
List drives	Retrieve a list of Drive resources available to the authenticated user, or for a specific user, group, or site.	`ONE_DRIVE_LIST_DRIVES`

Files (3)

Action	What it does	Slug
Download file	Downloads a file from a user’s OneDrive using its item ID, which must refer to a file and not a folder.	`ONE_DRIVE_DOWNLOAD_FILE`
Download file by path	Downloads the contents of a file from OneDrive by its path.	`ONE_DRIVE_DOWNLOAD_FILE_BY_PATH`
OneDrive find file	Non-recursively finds an item (file or folder) in a specified OneDrive folder.	`ONE_DRIVE_ONEDRIVE_FIND_FILE`

Files and folders (13)

Action	What it does	Slug
Download item as format	Download the contents of a driveItem converted to a specific format (e.g., PDF or HTML).	`ONE_DRIVE_DOWNLOAD_ITEM_AS_FORMAT`
Get drive item by sharing URL	Resolve a OneDrive/SharePoint sharing URL (or shareId) to a DriveItem with driveId and itemId.	`ONE_DRIVE_GET_DRIVE_ITEM_BY_SHARING_URL`
Get followed item	Retrieve a specific followed driveItem from a drive.	`ONE_DRIVE_GET_FOLLOWED_ITEM`
Get item	Retrieves the metadata of a DriveItem by its unique ID.	`ONE_DRIVE_GET_ITEM`
Get recent items	Get files and folders recently accessed by the user.	`ONE_DRIVE_GET_RECENT_ITEMS`
Get shared items	Retrieve items shared with the authenticated user (not items the user has shared with others).	`ONE_DRIVE_GET_SHARED_ITEMS`
Get SharePoint list items	Get the items (list items) within a specific SharePoint list on a site.	`ONE_DRIVE_GET_SHAREPOINT_LIST_ITEMS`
List all drive items	Recursively lists all files and folders in a OneDrive drive by traversing the entire folder hierarchy.	`ONE_DRIVE_LIST_ALL_DRIVE_ITEMS`
List OneDrive shared items		`ONE_DRIVE_LIST_ONEDRIVE_SHARED_ITEMS`
OneDrive list items	Retrieves all files and folders as driveItem resources from the root of a specified user’s OneDrive, automatically handling pagination.	`ONE_DRIVE_ONEDRIVE_LIST_ITEMS`
Preview drive item	Generates or retrieves a short-lived, permission-bound embeddable URL for a preview of a specific item.	`ONE_DRIVE_PREVIEW_DRIVE_ITEM`
Search drive items		`ONE_DRIVE_SEARCH_DRIVE_ITEMS`
Search items	Search OneDrive for files and folders by keyword.	`ONE_DRIVE_SEARCH_ITEMS`

Folders (3)

Action	What it does	Slug
Get special folder	Retrieve a special folder in OneDrive by name.	`ONE_DRIVE_GET_SPECIAL_FOLDER`
List folder children	List the direct children (files/folders) of a OneDrive/SharePoint folder by DriveItem ID or path.	`ONE_DRIVE_LIST_FOLDER_CHILDREN`
OneDrive find folder	Finds folders by name within an accessible parent folder in OneDrive, or lists all its direct child folders if no name is specified.	`ONE_DRIVE_ONEDRIVE_FIND_FOLDER`

Lists (1)

Action	What it does	Slug
List site lists	List all lists under a specific SharePoint site.	`ONE_DRIVE_LIST_SITE_LISTS`

Roles and permissions (2)

Action	What it does	Slug
Get item permissions	Retrieves the permissions of a DriveItem by its unique ID within a specific Drive.	`ONE_DRIVE_GET_ITEM_PERMISSIONS`
List share permissions	Retrieve permission details for a shared OneDrive or SharePoint item using a share ID.	`ONE_DRIVE_LIST_SHARE_PERMISSIONS`

Sites (3)

Action	What it does	Slug
Get site	Retrieves metadata for a specific SharePoint site by its ID.	`ONE_DRIVE_GET_SITE`
List site subsites	List all subsites of a SharePoint site.	`ONE_DRIVE_LIST_SITE_SUBSITES`
Search SharePoint sites		`ONE_DRIVE_SEARCH_SHAREPOINT_SITES`

Subscriptions (1)

Action	What it does	Slug
List subscriptions	List the current subscriptions for the authenticated user or app.	`ONE_DRIVE_LIST_SUBSCRIPTIONS`

Tables (1)

Action	What it does	Slug
Inspect workbook table		`ONE_DRIVE_INSPECT_WORKBOOK_TABLE`

Thumbnails (1)

Action	What it does	Slug
Get item thumbnails	Retrieve the thumbnails associated with a DriveItem.	`ONE_DRIVE_GET_ITEM_THUMBNAILS`

Versions (2)

Action	What it does	Slug
Download item version	Download the contents of a specific previous version of a drive item (file).	`ONE_DRIVE_DOWNLOAD_ITEM_VERSION`
Get item versions	Retrieve the version history of a DriveItem by its unique ID.	`ONE_DRIVE_GET_ITEM_VERSIONS`

Worksheets (1)

Action	What it does	Slug
List workbook worksheets	Retrieves a list of all worksheets in an Excel workbook stored in OneDrive or SharePoint.	`ONE_DRIVE_LIST_WORKBOOK_WORKSHEETS`

Other actions (3)

Action	What it does	Slug
Get root	Retrieve metadata for the root folder of the signed-in user’s OneDrive.	`ONE_DRIVE_GET_ROOT`
Get share	Access a shared DriveItem or collection of shared items using a shareId or encoded sharing URL.	`ONE_DRIVE_GET_SHARE`
List bundles	Retrieve a list of bundle resources from a specified drive.	`ONE_DRIVE_LIST_BUNDLES`

Read + write (recommended)

Agents can use 79 of the 83 OneDrive actions at this level: everything in Read-only, plus:

Create, update, and delete files and folders
Update and delete cells and ranges
Create and update roles and permissions
Create, update, and delete worksheets
Create files
Create and update sessions
View and create users
Update content
Create folders
Create links
Update versions

The 33 actions that this level adds to Read-only:

Cells and ranges (6)

Action	What it does	Slug
Clear workbook range		`ONE_DRIVE_CLEAR_WORKBOOK_RANGE`
Delete workbook range	Deletes a range of cells from a worksheet in an Excel workbook stored in OneDrive.	`ONE_DRIVE_DELETE_WORKBOOK_RANGE`
Format workbook range		`ONE_DRIVE_FORMAT_WORKBOOK_RANGE`
Get workbook used range		`ONE_DRIVE_GET_WORKBOOK_USED_RANGE`
Update workbook range	Updates a range in a workbook worksheet using Microsoft Graph API.	`ONE_DRIVE_UPDATE_WORKBOOK_RANGE`
Write workbook cell	Updates the value, formula, or format of a specific cell in an Excel workbook stored in OneDrive.	`ONE_DRIVE_WRITE_WORKBOOK_CELL`

Content (1)

Action	What it does	Slug
Update file content	Update an existing file’s content in OneDrive.	`ONE_DRIVE_UPDATE_FILE_CONTENT`

Files (2)

Action	What it does	Slug
OneDrive create text file	Creates a new plain-text file with specified content in the authenticated user’s personal OneDrive, using either the folder’s unique ID or its absolute path relative to the user’s OneDrive root (paths are automatically resolved to IDs).	`ONE_DRIVE_ONEDRIVE_CREATE_TEXT_FILE`
OneDrive upload file	Uploads a file to a specified OneDrive folder, automatically creating the destination folder if it doesn’t exist, renaming on conflict, and supporting large files via chunking.	`ONE_DRIVE_ONEDRIVE_UPLOAD_FILE`

Files and folders (9)

Action	What it does	Slug
Checkin item	Check in a checked out driveItem resource, making the version of the document available to others.	`ONE_DRIVE_CHECKIN_ITEM`
Checkout item	Check out a driveItem to prevent others from editing it and make your changes invisible until checked in.	`ONE_DRIVE_CHECKOUT_ITEM`
Copy item	Copy a DriveItem (file or folder) to a new location asynchronously.	`ONE_DRIVE_COPY_ITEM`
Delete item	Delete a DriveItem (file or folder) by its unique ID from the authenticated user’s OneDrive.	`ONE_DRIVE_DELETE_ITEM`
Follow item	Follow a driveItem (file or folder) in OneDrive or SharePoint.	`ONE_DRIVE_FOLLOW_ITEM`
Move item	Move a file or folder to a new parent folder in OneDrive.	`ONE_DRIVE_MOVE_ITEM`
Restore drive item	Restore a deleted OneDrive driveItem (file or folder) from the recycle bin.	`ONE_DRIVE_RESTORE_DRIVE_ITEM`
Unfollow item	Unfollow a driveItem by removing it from the user’s followed items collection.	`ONE_DRIVE_UNFOLLOW_ITEM`
Update drive item metadata	Update the metadata of a specific item (file or folder) in OneDrive.	`ONE_DRIVE_UPDATE_DRIVE_ITEM_METADATA`

Folders (1)

Action	What it does	Slug
OneDrive create folder	Creates a new folder in the user’s OneDrive with configurable conflict behavior, optionally within a specified parent_folder (by ID or full path from root) which, if not the root, must exist and be accessible.	`ONE_DRIVE_ONEDRIVE_CREATE_FOLDER`

Links (1)

Action	What it does	Slug
Create link	Create a sharing link for a DriveItem (file or folder) by its unique ID.	`ONE_DRIVE_CREATE_LINK`

Roles and permissions (3)

Action	What it does	Slug
Create item permission	Create a new permission on a OneDrive drive item.	`ONE_DRIVE_CREATE_ITEM_PERMISSION`
Grant share permission	Grant users access to a link represented by a permission using an encoded sharing URL.	`ONE_DRIVE_GRANT_SHARE_PERMISSION`
Update drive items permissions	Update the roles of an existing permission on a OneDrive drive item.	`ONE_DRIVE_UPDATE_DRIVE_ITEMS_PERMISSIONS`

Sessions (2)

Action	What it does	Slug
Close workbook session		`ONE_DRIVE_CLOSE_WORKBOOK_SESSION`
Create workbook session		`ONE_DRIVE_CREATE_WORKBOOK_SESSION`

Users (2)

Action	What it does	Slug
Get user	Retrieves the properties and profile information for a specific Microsoft user by their user ID or user principal name.	`ONE_DRIVE_GET_USER`
Invite user to item	Invite users or grant permissions to a specific item in a OneDrive drive.	`ONE_DRIVE_INVITE_USER_TO_ITEM`

Versions (1)

Action	What it does	Slug
Restore item version		`ONE_DRIVE_RESTORE_ITEM_VERSION`

Worksheets (4)

Action	What it does	Slug
Add workbook worksheet	Adds a new worksheet to an existing Excel workbook in OneDrive or SharePoint.	`ONE_DRIVE_ADD_WORKBOOK_WORKSHEET`
Delete workbook worksheet	Deletes a worksheet from a workbook in OneDrive by its ID or name.	`ONE_DRIVE_DELETE_WORKBOOK_WORKSHEET`
Get workbook worksheet	Retrieves a specific worksheet from an Excel workbook stored in OneDrive or SharePoint using Microsoft Graph API.	`ONE_DRIVE_GET_WORKBOOK_WORKSHEET`
Update workbook worksheet	Updates properties of a worksheet in an Excel workbook stored in OneDrive.	`ONE_DRIVE_UPDATE_WORKBOOK_WORKSHEET`

Other actions (1)

Action	What it does	Slug
Discard checkout	Discard the checkout of a driveItem, releasing it and discarding any changes made while checked out.	`ONE_DRIVE_DISCARD_CHECKOUT`

Full access

Agents can use 83 of the 83 OneDrive actions at this level: everything in Read + write, plus:

Delete roles and permissions

The 4 actions that this level adds to Read + write:

Works on	Action	What it does	Slug
Files and folders	Delete item permanently	Permanently delete a driveItem by its ID without moving it to the recycle bin.	`ONE_DRIVE_DELETE_ITEM_PERMANENTLY`
Roles and permissions	Delete item permission	Delete a permission from a drive item.	`ONE_DRIVE_DELETE_ITEM_PERMISSION`
	Delete share permission	Delete the permission navigation property for a shared drive item.	`ONE_DRIVE_DELETE_SHARE_PERMISSION`
	Delete SharePoint item permission		`ONE_DRIVE_DELETE_SHAREPOINT_ITEM_PERMISSION`

Connect OneDrive

Before you start:

You need an OneDrive account that you can sign in to.
Your Squad subscription must be active. Squad does not connect apps while the subscription is not active.

Open Integrations

Open Settings > Integrations.

Add an integration

On the Connected apps tab, click + Add integration.

Find OneDrive

Find OneDrive in the catalog and click it. You can type the name in Search the catalog….

Choose an access level

Under Default scope, choose an access level. This level applies to every agent.

Click Connect OneDrive

Click Connect OneDrive. The OneDrive sign-in page opens in a new tab.

Check that it works: OneDrive shows under YOUR CONNECTIONS, with a row for the account and its access level.

Change the access level

Under YOUR CONNECTIONS, find the OneDrive account.
Open the account menu (⋯) and click Manage scope.
Under Default scope, choose the new level.
Click Save access.

The change does not need a new sign-in. Agents get the new level from their next call.

Set access for one agent

Every agent uses the account’s level unless you set something else for it. You can narrow one agent to a lower level, or block it.

Under YOUR CONNECTIONS, open the account menu (⋯) on the OneDrive account.
Click Manage scope.
Under Per-agent access, find the agent.
Choose the Default option to follow the account’s level, choose a lower level, or choose No access.
Click Save access.

An agent never gets more than the account’s level, even if you choose a higher level for it. Changes apply from the agent’s next call. An agent with No access does not see the account.

Use more than one OneDrive account

Click + Account on the OneDrive card to connect another account. Agents use the primary account unless they are asked to use a specific one.

After you click + Account, follow the connect steps above.
Each account has its own access level.
The first account you connect becomes the primary account. It shows ★ PRIMARY.
To change the primary account, open the account menu (⋯) and click Make primary.
To tell accounts apart, open the account menu (⋯) and click Rename.

Reconnect or disconnect

Reconnect when the connection has expired, or when you need to change what the account can reach on the OneDrive side:

Open the account menu (⋯) and click Reconnect.
Click Reauthorize on OneDrive.
Sign in to OneDrive and approve the request.

Reconnect signs in to the same account again. It does not add a second connection. Open the account menu (⋯) on the OneDrive account and click Disconnect. Agents lose access to that account at once.

Disconnect acts at once, with no confirmation step. If it was the primary account, another connected OneDrive account becomes primary.

Costs

OneDrive actions do not use Squad credits. Connected apps never use credits. For what does use credits, see What Squad costs.

Troubleshooting

An agent reports that an action is not allowed on this account.

Cause: the action is outside the account’s access level, or outside the level you set for that agent.
Fix: choose a higher level in Manage scope, or change the agent’s row under Per-agent access.

An agent says it has no access to OneDrive, or it does not see the account.

Cause: the agent is set to No access under Per-agent access, or the account is not connected.
Fix: open Manage scope and change the agent’s row. If the account is missing, connect it again.

Connecting or saving fails with “Your subscription isn’t active.”

Cause: your Squad subscription is not active.
Fix: resubscribe. See Manage your subscription.

An agent says the OneDrive connection has expired.

Cause: the sign-in for that account is no longer valid.
Fix: use Reconnect on the account.

Common questions

Can I limit what agents can do in OneDrive?

Can I connect more than one OneDrive account?

Click + Account on the OneDrive card to connect another account. Agents use the primary account unless they are asked to use a specific one.

How do I disconnect OneDrive?

Open the account menu (⋯) on the OneDrive account and click Disconnect. Agents lose access to that account at once.

Connect apps

Add an MCP server or an API key

Use this when an action you need is not in this app.

Recommended

Analytics

Communication

CRM & Support

Dev & Project Management

E-commerce & Payments

Email & Productivity

File Storage

Finance & Time

Marketing & Social

Scheduling & Meetings

Access levels

What agents can do at each level

Connect OneDrive

Change the access level

Set access for one agent

Use more than one OneDrive account

Reconnect or disconnect

Costs

Troubleshooting

Common questions

Connect apps

Add an MCP server or an API key

​Access levels

​What agents can do at each level

​Connect OneDrive

​Change the access level

​Set access for one agent

​Use more than one OneDrive account

​Reconnect or disconnect

​Costs

​Troubleshooting

​Common questions

​Related pages

Connect apps

Add an MCP server or an API key

Access levels

What agents can do at each level

Connect OneDrive

Change the access level

Set access for one agent

Use more than one OneDrive account

Reconnect or disconnect

Costs

Troubleshooting

Common questions

Related pages