> ## Documentation Index
> Fetch the complete documentation index at: https://squad.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# OneDrive
> What agents can do in OneDrive at each access level, and how to connect, limit, and disconnect 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.
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:
| 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` |
| 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` |
| 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` |
| Action | What it does | Slug |
| ----------------- | -------------------------------------------------- | ----------------------------- |
| List site columns | List all column definitions for a SharePoint site. | `ONE_DRIVE_LIST_SITE_COLUMNS` |
| Action | What it does | Slug |
| --------------------- | ------------ | --------------------------------- |
| Get document comments | | `ONE_DRIVE_GET_DOCUMENT_COMMENTS` |
| Action | What it does | Slug |
| --------------------- | -------------------------------------------------- | --------------------------------- |
| Get site page content | Gets the content of a modern SharePoint site page. | `ONE_DRIVE_GET_SITE_PAGE_CONTENT` |
| 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` |
| 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` |
| 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` |
| 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` |
| Action | What it does | Slug |
| --------------- | ------------------------------------------------ | --------------------------- |
| List site lists | List all lists under a specific SharePoint site. | `ONE_DRIVE_LIST_SITE_LISTS` |
| 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` |
| 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` |
| Action | What it does | Slug |
| ------------------ | ----------------------------------------------------------------- | ------------------------------ |
| List subscriptions | List the current subscriptions for the authenticated user or app. | `ONE_DRIVE_LIST_SUBSCRIPTIONS` |
| Action | What it does | Slug |
| ---------------------- | ------------ | ---------------------------------- |
| Inspect workbook table | | `ONE_DRIVE_INSPECT_WORKBOOK_TABLE` |
| Action | What it does | Slug |
| ------------------- | ---------------------------------------------------- | ------------------------------- |
| Get item thumbnails | Retrieve the thumbnails associated with a DriveItem. | `ONE_DRIVE_GET_ITEM_THUMBNAILS` |
| 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` |
| 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` |
| 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` |
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**:
| 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` |
| Action | What it does | Slug |
| ------------------- | ---------------------------------------------- | ------------------------------- |
| Update file content | Update an existing file's content in OneDrive. | `ONE_DRIVE_UPDATE_FILE_CONTENT` |
| 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` |
| 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` |
| 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` |
| 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` |
| 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` |
| Action | What it does | Slug |
| ----------------------- | ------------ | ----------------------------------- |
| Close workbook session | | `ONE_DRIVE_CLOSE_WORKBOOK_SESSION` |
| Create workbook session | | `ONE_DRIVE_CREATE_WORKBOOK_SESSION` |
| 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` |
| Action | What it does | Slug |
| -------------------- | ------------ | -------------------------------- |
| Restore item version | | `ONE_DRIVE_RESTORE_ITEM_VERSION` |
| 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` |
| 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` |
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 **Settings** > **Integrations**.
On the **Connected apps** tab, click **+ Add integration**.
Find **OneDrive** in the catalog and click it. You can type the name in **Search the catalog…**.
Under **Default scope**, choose an access level. This level applies to every agent.
Click **Connect OneDrive**. The OneDrive sign-in page opens in a new tab.
Sign in to OneDrive and approve the request.
Check that it works: OneDrive shows under **YOUR CONNECTIONS**, with a row for the account and its access level.
## Change the access level
1. Under **YOUR CONNECTIONS**, find the OneDrive account.
2. Open the account menu (⋯) and click **Manage scope**.
3. Under **Default scope**, choose the new level.
4. 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.
1. Under **YOUR CONNECTIONS**, open the account menu (⋯) on the OneDrive account.
2. Click **Manage scope**.
3. Under **Per-agent access**, find the agent.
4. Choose the **Default** option to follow the account's level, choose a lower level, or choose **No access**.
5. 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:
1. Open the account menu (⋯) and click **Reconnect**.
2. Click **Reauthorize on OneDrive**.
3. 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](/docs/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](/docs/billing).
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
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**.
Click **+ Account** on the OneDrive card to connect another account. Agents use the primary account unless they are asked to use a specific one.
Open the account menu (⋯) on the OneDrive account and click **Disconnect**. Agents lose access to that account at once.
## Related pages
Use this when an action you need is not in this app.