--- title: Microsoft OneDrive slug: connectors/microsoft-onedrive docTags: createdAt: 2026-06-09T16:29:50.839Z --- The OneDrive connector allows Swimlane to integrate with Microsoft Graph OneDrive enpoints. ## Prerequisites Ensure that you have administrator rights so that you can add permissions that will fully utilize all capabilities within this connector. ## Capabilities The Microsoft Graph API connector gives the ability to get and update security alerts, and modify user licenses and sessions. - Create Drive Folder - Create Group Folder - Create Site Folder - Create User Folder - Dowload Drive File - Upload Drive File ## Asset Setup Authentication uses Azure application OAuth2. You will need an admin account in Azure to create the application. Recommended Application Permissions (feel free use custom permissions if you only use certain actions): - User.ReadWrite.All - Directory.ReadWrite.All - Directory.AccessAsUser.All - SecurityEvents.Read.All - SecurityEvents.ReadWrite.All - Mail.ReadWrite - Mail.Send In order to set up the asset, you need the following: - Azure Application Client ID - Azure Application Client Secret - Azure Tenant ID Steps to create the Azure app: 1. Go to the [App Registration page](https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps/ApplicationsListBlade) in the Azure portal. 2. Click `New Registration`. ![](./doc_images/new_app.png) 3. Enter a name for your new application and choose `Accounts in this organizational directory only`, then click `Register` at the bottom. ![](./doc_images/application_form.png) 4. Navigate to the `API permissions` tab on the left navigation menu. ![](./doc_images/api_permissions.png) 5. Select `Add a permission`. ![](./doc_images/add_permission.png) 6. Select `Microsoft Graph`. ![](./doc_images/graph_permissions.png) 7. Select `Application permissions`, then mark all the permissions you need for the actions you are using (See suggested permissions at the top of the asset setup section). ![](./doc_images/app_permissions.png) 8. Click the `Add permissions` button at the bottom of the page. 9. Select `Grant admin consent` for your organization, then your permissions should look as below. 10. Navigate to the `Certificates & secrets` tab and select `New client secret`. ![](./doc_images/new_secret.png) 11. Fill out the description and expiration, then click the `Add` button at the bottom. 12. The `Value` of the secret you just created is the `Client Secret` needed for the Swimlane asset. ![](./doc_images/client_secret.png) 14\. Navigate to the `Overview` tab on the left menu. ![](./doc_images/overview_tap.png) 15\. The `Client ID` and `Tenant ID` needed in the asset are shown on this page. ![](./doc_images/client_id.png) The `Client ID`, `Tenant ID`, and `Client Secret` described in the steps above are the credentials you need for the asset. ## Notes - [An Introduction to Microsoft Graph API](https://social.technet.microsoft.com/wiki/contents/articles/33525.an-introduction-to-microsoft-graph-api.aspx) - [Microsoft Graph Security API Homepage](https://www.microsoft.com/en-us/security/intelligence-security-api) - [Microsoft Graph REST API v1.0 reference](https://docs.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0) - [Query Parameters Documentation - OData V4](https://docs.microsoft.com/en-us/graph/query-parameters) - [Microsoft Graph Security API v1.0 refrence](https://docs.microsoft.com/en-us/graph/api/resources/security-api-overview?view=graph-rest-beta) - [Azure AD OAuth2 flow](https://docs.microsoft.com/en-us/azure/active-directory/develop/v1-protocols-oauth-code) - [oauthlib Legacy Application client](https://requests-oauthlib.readthedocs.io/en/latest/oauth2_workflow.html#legacy-application-flow), this is sort of a hack to bypass manual login (typically required) - [Limiting application permissions to specific Exchange Online mailboxes](https://docs.microsoft.com/en-us/graph/auth-limit-mailbox-access) # Configurations ## Oauth 2.0 Client Credentials Authenticates using oauth 2.0 client credentials ### Configuration Parameters | **Parameter** | **Description** | **Type** | **Required** | | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ------------ | | url | A URL to the target host. | string | Required | | token\_url | Must start with [https://login.microsoftonline.com/](https://login.microsoftonline.com/) and then continue with the tenant\_id, and then be prepended with /oauth2/v2.0/token | string | Required | | client\_id | The client ID | string | Required | | client\_secret | The client secret. | string | Required | | scope | List of permission scopes for this action. | array | Required | | verify\_ssl | Verify SSL certificate | boolean | Optional | | http\_proxy | A proxy to route requests through. | string | Optional | # Actions ## Create Drive Upload Session OneDrive Create Drive Upload Session ### Endpoint - **URL:** `v1.0/drives/{{driveId}}/items/{{itemId}}/createUploadSession` - **Method:** `POST` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | ---------------------------------------- | -------- | ------------ | ----------------------------------------------------- | | `path_parameters.driveId` | string | Required | Parameters for the Create Drive Upload Session action | | `path_parameters.itemId` | string | Required | Parameters for the Create Drive Upload Session action | | `item` | object | Optional | Parameter for Create Drive Upload Session | | `item.@microsoft.graph.conflictBehavior` | string | Optional | Parameter for Create Drive Upload Session | | `deferCommit` | boolean | Optional | Parameter for Create Drive Upload Session | ### Input Example `{"json_body":{"item":{"@microsoft.graph.conflictBehavior":"rename"},"deferCommit":false},"path_parameters":{"driveId":"b!62Ee6kGZPk6BVV9MSE16_a28d8PIiIVIrKGudAgSj6pSXvivqLXmQpCPTbWEgqWH","itemId":"01CTNNUMZOIWP5D4B3VFBLK55CW42NJVMW"}}` ### Output | **Parameter** | **Type** | **Description** | | -------------------- | -------- | -------------------------------- | | `status_code` | number | HTTP status code of the response | | `reason` | string | Response reason phrase | | `@odata.context` | string | Response data | | `expirationDateTime` | string | Time value | | `nextExpectedRanges` | array | Output field: nextExpectedRanges | | `uploadUrl` | string | URL endpoint for the request | ### Output Example `{"status_code":200,"response_headers":{"Cache-Control":"no-store, no-cache","Transfer-Encoding":"chunked","Content-Type":"application/json;odata.metadata=minimal;odata.streaming=true;IEEE754Compatible=f...","Content-Encoding":"gzip","Location":"https://graph.microsoft.com","Vary":"Accept-Encoding","Strict-Transport-Security":"max-age=31536000","request-id":"61afa009-0a5c-46cc-876f-74dc0c9479c3","client-request-id":"61afa009-0a5c-46cc-876f-74dc0c9479c3","x-ms-ags-diagnostic":"{\"ServerInfo\":{\"D...` ## Create Group Upload Session OneDrive Create Group Upload Session ### Endpoint - **URL:** `v1.0/groups/{{groupId}}/drive/items/{{itemId}}/createUploadSession` - **Method:** `POST` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | ---------------------------------------- | -------- | ------------ | ----------------------------------------------------- | | `path_parameters.groupId` | string | Required | Parameters for the Create Group Upload Session action | | `path_parameters.itemId` | string | Required | Parameters for the Create Group Upload Session action | | `item` | object | Optional | Parameter for Create Group Upload Session | | `item.@microsoft.graph.conflictBehavior` | string | Optional | Parameter for Create Group Upload Session | | `deferCommit` | boolean | Optional | Parameter for Create Group Upload Session | ### Input Example `{"json_body":{"item":{"@microsoft.graph.conflictBehavior":"rename"},"deferCommit":false},"path_parameters":{"groupId":"2c435237-2587-4d26-a318-fc8537094d7b","itemId":"01HCHOCOEESKVBSUZDXJBZC24PYZY7BRFC"}}` ### Output | **Parameter** | **Type** | **Description** | | -------------------- | -------- | -------------------------------- | | `status_code` | number | HTTP status code of the response | | `reason` | string | Response reason phrase | | `@odata.context` | string | Response data | | `expirationDateTime` | string | Time value | | `nextExpectedRanges` | array | Output field: nextExpectedRanges | | `uploadUrl` | string | URL endpoint for the request | ### Output Example `{"status_code":200,"response_headers":{"Cache-Control":"no-store, no-cache","Transfer-Encoding":"chunked","Content-Type":"application/json;odata.metadata=minimal;odata.streaming=true;IEEE754Compatible=f...","Content-Encoding":"gzip","Location":"https://graph.microsoft.com","Vary":"Accept-Encoding","Strict-Transport-Security":"max-age=31536000","request-id":"15474ed8-4799-4652-a448-6d5defc8c245","client-request-id":"15474ed8-4799-4652-a448-6d5defc8c245","x-ms-ags-diagnostic":"{\"ServerInfo\":{\"D...` ## Create Site Upload Session OneDrive Create Site Upload Session ### Endpoint - **URL:** `v1.0/sites/{{siteId}}/drive/items/{{itemId}}/createUploadSession` - **Method:** `POST` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | ---------------------------------------- | -------- | ------------ | ---------------------------------------------------- | | `path_parameters.siteId` | string | Required | Parameters for the Create Site Upload Session action | | `path_parameters.itemId` | string | Required | Parameters for the Create Site Upload Session action | | `item` | object | Optional | Parameter for Create Site Upload Session | | `item.@microsoft.graph.conflictBehavior` | string | Optional | Parameter for Create Site Upload Session | | `deferCommit` | boolean | Optional | Parameter for Create Site Upload Session | ### Input Example `{"json_body":{"item":{"@microsoft.graph.conflictBehavior":"rename"},"deferCommit":false},"path_parameters":{"siteId":"f9454dfb-d96b-46d1-9186-5fb7fda501b4","itemId":"01JXUHNJTAFZ4PY67OABEJRO3GFBDXFI5D"}}` ### Output | **Parameter** | **Type** | **Description** | | -------------------- | -------- | -------------------------------- | | `status_code` | number | HTTP status code of the response | | `reason` | string | Response reason phrase | | `@odata.context` | string | Response data | | `expirationDateTime` | string | Time value | | `nextExpectedRanges` | array | Output field: nextExpectedRanges | | `uploadUrl` | string | URL endpoint for the request | ### Output Example `{"status_code":200,"response_headers":{"Cache-Control":"no-store, no-cache","Transfer-Encoding":"chunked","Content-Type":"application/json;odata.metadata=minimal;odata.streaming=true;IEEE754Compatible=f...","Content-Encoding":"gzip","Location":"https://graph.microsoft.com","Vary":"Accept-Encoding","Strict-Transport-Security":"max-age=31536000","request-id":"329c0044-1a0d-42e7-b7f0-ff3a7cb978d0","client-request-id":"329c0044-1a0d-42e7-b7f0-ff3a7cb978d0","x-ms-ags-diagnostic":"{\"ServerInfo\":{\"D...` ## Create User Upload Session OneDrive Create User Upload Session ### Endpoint - **URL:** `v1.0/users/{{userId}}/drive/items/{{itemId}}/createUploadSession` - **Method:** `POST` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | ---------------------------------------- | -------- | ------------ | ---------------------------------------------------- | | `path_parameters.userId` | string | Required | Parameters for the Create User Upload Session action | | `path_parameters.itemId` | string | Required | Parameters for the Create User Upload Session action | | `item` | object | Optional | Parameter for Create User Upload Session | | `item.@microsoft.graph.conflictBehavior` | string | Optional | Parameter for Create User Upload Session | | `deferCommit` | boolean | Optional | Parameter for Create User Upload Session | ### Input Example `{"json_body":{"item":{"@microsoft.graph.conflictBehavior":"rename"},"deferCommit":false},"path_parameters":{"userId":"2b77f477-3a9f-4823-a882-6fb6cae8c7f9","itemId":"01B3ZFAZBOAZKJYY3NQVBJPSZASEWLXZTJ"}}` ### Output | **Parameter** | **Type** | **Description** | | -------------------- | -------- | -------------------------------- | | `status_code` | number | HTTP status code of the response | | `reason` | string | Response reason phrase | | `@odata.context` | string | Response data | | `expirationDateTime` | string | Time value | | `nextExpectedRanges` | array | Output field: nextExpectedRanges | | `uploadUrl` | string | URL endpoint for the request | ### Output Example `{"status_code":200,"response_headers":{"Cache-Control":"no-store, no-cache","Transfer-Encoding":"chunked","Content-Type":"application/json;odata.metadata=minimal;odata.streaming=true;IEEE754Compatible=f...","Content-Encoding":"gzip","Location":"https://graph.microsoft.com","Vary":"Accept-Encoding","Strict-Transport-Security":"max-age=31536000","request-id":"777c3816-7968-49ac-a311-afcd86404d9f","client-request-id":"777c3816-7968-49ac-a311-afcd86404d9f","x-ms-ags-diagnostic":"{\"ServerInfo\":{\"D...` ## Download Group File OneDrive Download Group File ### Endpoint - **URL:** `v1.0/groups/{{group-id}}/drive/items/{{item-id}}/content` - **Method:** `GET` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | -------------------------- | -------- | ------------ | --------------------------------------------- | | `path_parameters.group-id` | string | Required | Parameters for the Download Group File action | | `path_parameters.item-id` | string | Required | Parameters for the Download Group File action | ### Input Example `{"path_parameters":{"group-id":"b!62Ee6kGZPk6BVV9MSE16_a28d8PIiIVIrKGudAgSj6pSXvivqLXmQpCPTbWEgqWH","item-id":"01CTNNUMZOIWP5D4B3VFBLK55CW42NJVMW"}}` ### Output | **Parameter** | **Type** | **Description** | | ---------------- | -------- | ----------------------- | | `file` | object | File | | `file.file_name` | string | Name of the resource | | `file.file` | string | Output field: file.file | ### Output Example `{"file":{"file_name":"Example Name","file":"string"}}` ## Download Site File OneDrive Download Site File ### Endpoint - **URL:** `v1.0/sites/{{site-id}}/drive/items/{{item-id}}/content` - **Method:** `GET` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | ------------------------- | -------- | ------------ | -------------------------------------------- | | `path_parameters.site-id` | string | Required | Parameters for the Download Site File action | | `path_parameters.item-id` | string | Required | Parameters for the Download Site File action | ### Input Example `{"path_parameters":{"site-id":"b!62Ee6kGZPk6BVV9MSE16_a28d8PIiIVIrKGudAgSj6pSXvivqLXmQpCPTbWEgqWH","item-id":"01CTNNUMZOIWP5D4B3VFBLK55CW42NJVMW"}}` ### Output | **Parameter** | **Type** | **Description** | | ---------------- | -------- | ----------------------- | | `file` | object | File | | `file.file_name` | string | Name of the resource | | `file.file` | string | Output field: file.file | ### Output Example `{"file":{"file_name":"Example Name","file":"string"}}` ## Download User File OneDrive Download User File ### Endpoint - **URL:** `v1.0/users/{{user-id}}/drive/items/{{item-id}}/content` - **Method:** `GET` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | ------------------------- | -------- | ------------ | -------------------------------------------- | | `path_parameters.user-id` | string | Required | Parameters for the Download User File action | | `path_parameters.item-id` | string | Required | Parameters for the Download User File action | ### Input Example `{"path_parameters":{"user-id":"b!62Ee6kGZPk6BVV9MSE16_a28d8PIiIVIrKGudAgSj6pSXvivqLXmQpCPTbWEgqWH","item-id":"01CTNNUMZOIWP5D4B3VFBLK55CW42NJVMW"}}` ### Output | **Parameter** | **Type** | **Description** | | ---------------- | -------- | ----------------------- | | `file` | object | File | | `file.file_name` | string | Name of the resource | | `file.file` | string | Output field: file.file | ### Output Example `{"file":{"file_name":"Example Name","file":"string"}}` ## Download Drive File Download the contents of the primary stream (file) of a driveItem ### Endpoint - **URL:** `v1.0/drives/{{drive-id}}/items/{{item-id}}/content` - **Method:** `GET` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | -------------------------- | -------- | ------------ | --------------------------------------------- | | `path_parameters.drive-id` | string | Required | Parameters for the Download Drive File action | | `path_parameters.item-id` | string | Required | Parameters for the Download Drive File action | ### Input Example `{"path_parameters":{"drive-id":"b!62Ee6kGZPk6BVV9MSE16_a28d8PIiIVIrKGudAgSj6pSXvivqLXmQpCPTbWEgqWH","item-id":"01CTNNUMZOIWP5D4B3VFBLK55CW42NJVMW"}}` ### Output | **Parameter** | **Type** | **Description** | | ---------------- | -------- | ----------------------- | | `file` | object | File | | `file.file_name` | string | Name of the resource | | `file.file` | string | Output field: file.file | ### Output Example `{"file":{"file_name":"Example Name","file":"string"}}` ## Upload Drive File Create an upload session to allow your app to upload files up to the maximum file size ### Endpoint - **URL:** `v1.0/drives/{{drive-id}}/items/{{parent-id}}:/{{filename}}:/content` - **Method:** `PUT` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | --------------------------- | -------- | ------------ | ------------------------------------------- | | `attachments` | array | Required | File to be uploaded | | `attachments.file` | string | Optional | Parameter for Upload Drive File | | `attachments.file_name` | string | Optional | Name of the resource | | `path_parameters.drive-id` | string | Required | Parameters for the Upload Drive File action | | `path_parameters.parent-id` | string | Required | Parameters for the Upload Drive File action | | `path_parameters.filename` | string | Required | Parameters for the Upload Drive File action | | `headers` | object | Required | HTTP headers for the request | | `headers.Content-Type` | string | Required | HTTP headers for the request | ### Input Example `{"path_parameters":{"drive-id":"b!62Ee6kGZPk6BVV9MSE16_a28d8PIiIVIrKGudAgSj6pSXvivqLXmQpCPTbWEgqWH","parent-id":"root","filename":"deleteme.png"},"headers":{"Content-Type":"text/plain"}}` ### Output | **Parameter** | **Type** | **Description** | | ---------------------------------------- | -------- | ---------------------------------------- | | `status_code` | number | HTTP status code of the response | | `reason` | string | Response reason phrase | | `@odata.context` | string | Response data | | `@microsoft.graph.downloadUrl` | string | URL endpoint for the request | | `createdDateTime` | string | Time value | | `eTag` | string | Output field: eTag | | `id` | string | Unique identifier | | `lastModifiedDateTime` | string | Time value | | `name` | string | Name of the resource | | `webUrl` | string | URL endpoint for the request | | `cTag` | string | Output field: cTag | | `size` | number | Output field: size | | `createdBy` | object | Output field: createdBy | | `createdBy.application` | object | Output field: createdBy.application | | `createdBy.application.id` | string | Unique identifier | | `createdBy.application.displayName` | string | Name of the resource | | `createdBy.user` | object | Output field: createdBy.user | | `createdBy.user.displayName` | string | Name of the resource | | `lastModifiedBy` | object | Output field: lastModifiedBy | | `lastModifiedBy.application` | object | Output field: lastModifiedBy.application | | `lastModifiedBy.application.id` | string | Unique identifier | | `lastModifiedBy.application.displayName` | string | Name of the resource | | `lastModifiedBy.user` | object | Output field: lastModifiedBy.user | | `lastModifiedBy.user.displayName` | string | Name of the resource | | `parentReference` | object | Output field: parentReference | ### Output Example `{"@odata.context":"string","@microsoft.graph.downloadUrl":"string","createdDateTime":"string","eTag":"string","id":"12345678-1234-1234-1234-123456789abc","lastModifiedDateTime":"string","name":"Example Name","webUrl":"string","cTag":"string","size":123,"createdBy":{"application":{"id":"12345678-1234-1234-1234-123456789abc","displayName":"Example Name"},"user":{"displayName":"Example Name"}},"lastModifiedBy":{"application":{"id":"12345678-1234-1234-1234-123456789abc","displayName":"Example Name"}...` ## Create Drive Folder Creates a new folder or DriveItem in a Drive with a specified parent item or path ### Endpoint - **URL:** `v1.0/drives/{{drive-id}}/items/{{parent-item-id}}/children` - **Method:** `POST` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | ----------------------------------- | -------- | ------------ | --------------------------------------------- | | `path_parameters.parent-item-id` | string | Required | Parameters for the Create Drive Folder action | | `path_parameters.drive-id` | string | Required | Parameters for the Create Drive Folder action | | `name` | string | Optional | Name of the resource | | `folder` | object | Optional | Parameter for Create Drive Folder | | `@microsoft.graph.conflictBehavior` | string | Optional | Parameter for Create Drive Folder | ### Input Example `{"json_body":{"name":"you_can_delete_this_folder","folder":{},"@microsoft.graph.conflictBehavior":"rename"},"path_parameters":{"parent-item-id":"root","drive-id":"b!62Ee6kGZPk6BVV9MSE16_a28d8PIiIVIrKGudAgSj6pSXvivqLXmQpCPTbWEgqWH"}}` ### Output | **Parameter** | **Type** | **Description** | | ---------------------------------------- | -------- | ---------------------------------------- | | `status_code` | number | HTTP status code of the response | | `reason` | string | Response reason phrase | | `@odata.context` | string | Response data | | `createdDateTime` | string | Time value | | `eTag` | string | Output field: eTag | | `id` | string | Unique identifier | | `lastModifiedDateTime` | string | Time value | | `name` | string | Name of the resource | | `webUrl` | string | URL endpoint for the request | | `cTag` | string | Output field: cTag | | `size` | number | Output field: size | | `createdBy` | object | Output field: createdBy | | `createdBy.application` | object | Output field: createdBy.application | | `createdBy.application.id` | string | Unique identifier | | `createdBy.application.displayName` | string | Name of the resource | | `createdBy.user` | object | Output field: createdBy.user | | `createdBy.user.displayName` | string | Name of the resource | | `lastModifiedBy` | object | Output field: lastModifiedBy | | `lastModifiedBy.application` | object | Output field: lastModifiedBy.application | | `lastModifiedBy.application.id` | string | Unique identifier | | `lastModifiedBy.application.displayName` | string | Name of the resource | | `lastModifiedBy.user` | object | Output field: lastModifiedBy.user | | `lastModifiedBy.user.displayName` | string | Name of the resource | | `parentReference` | object | Output field: parentReference | | `parentReference.driveType` | string | Type of the resource | ### Output Example `{"@odata.context":"string","createdDateTime":"string","eTag":"string","id":"12345678-1234-1234-1234-123456789abc","lastModifiedDateTime":"string","name":"Example Name","webUrl":"string","cTag":"string","size":123,"createdBy":{"application":{"id":"12345678-1234-1234-1234-123456789abc","displayName":"Example Name"},"user":{"displayName":"Example Name"}},"lastModifiedBy":{"application":{"id":"12345678-1234-1234-1234-123456789abc","displayName":"Example Name"},"user":{"displayName":"Example Name"}},...` ## Create Group Folder Creates a new folder or DriveItem in a Drive with a specified parent item or path ### Endpoint - **URL:** `v1.0/groups/{{group-id}}/drive/items/{{parent-item-id}}/children` - **Method:** `POST` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | ----------------------------------- | -------- | ------------ | --------------------------------------------- | | `path_parameters.parent-item-id` | string | Required | Parameters for the Create Group Folder action | | `path_parameters.group-id` | string | Required | Parameters for the Create Group Folder action | | `name` | string | Optional | Name of the resource | | `folder` | object | Optional | Parameter for Create Group Folder | | `@microsoft.graph.conflictBehavior` | string | Optional | Parameter for Create Group Folder | ### Input Example `{"json_body":{"name":"test_folder_name","folder":{},"@microsoft.graph.conflictBehavior":"rename"},"path_parameters":{"parent-item-id":"root","group-id":"swimlaneintegrations-my.sharepoint.com,f9454dfb-d96b-46d1-9186-5fb7fda501b4,93abcf70-857e-40a0-a57e-9d58a3ffed21"}}` ### Output | **Parameter** | **Type** | **Description** | | ---------------------------------------- | -------- | ---------------------------------------- | | `status_code` | number | HTTP status code of the response | | `reason` | string | Response reason phrase | | `@odata.context` | string | Response data | | `createdDateTime` | string | Time value | | `eTag` | string | Output field: eTag | | `id` | string | Unique identifier | | `lastModifiedDateTime` | string | Time value | | `name` | string | Name of the resource | | `webUrl` | string | URL endpoint for the request | | `cTag` | string | Output field: cTag | | `size` | number | Output field: size | | `createdBy` | object | Output field: createdBy | | `createdBy.application` | object | Output field: createdBy.application | | `createdBy.application.id` | string | Unique identifier | | `createdBy.application.displayName` | string | Name of the resource | | `createdBy.user` | object | Output field: createdBy.user | | `createdBy.user.displayName` | string | Name of the resource | | `lastModifiedBy` | object | Output field: lastModifiedBy | | `lastModifiedBy.application` | object | Output field: lastModifiedBy.application | | `lastModifiedBy.application.id` | string | Unique identifier | | `lastModifiedBy.application.displayName` | string | Name of the resource | | `lastModifiedBy.user` | object | Output field: lastModifiedBy.user | | `lastModifiedBy.user.displayName` | string | Name of the resource | | `parentReference` | object | Output field: parentReference | | `parentReference.driveType` | string | Type of the resource | ### Output Example `{"@odata.context":"string","createdDateTime":"string","eTag":"string","id":"12345678-1234-1234-1234-123456789abc","lastModifiedDateTime":"string","name":"Example Name","webUrl":"string","cTag":"string","size":123,"createdBy":{"application":{"id":"12345678-1234-1234-1234-123456789abc","displayName":"Example Name"},"user":{"displayName":"Example Name"}},"lastModifiedBy":{"application":{"id":"12345678-1234-1234-1234-123456789abc","displayName":"Example Name"},"user":{"displayName":"Example Name"}},...` ## Create Site Folder Creates a new folder or DriveItem in a Drive with a specified parent item or path ### Endpoint - **URL:** `v1.0/sites/{{site-id}}/drive/items/{{parent-item-id}}/children` - **Method:** `POST` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | ----------------------------------- | -------- | ------------ | -------------------------------------------- | | `path_parameters.parent-item-id` | string | Required | Parameters for the Create Site Folder action | | `path_parameters.site-id` | string | Required | Parameters for the Create Site Folder action | | `name` | string | Optional | Name of the resource | | `folder` | object | Optional | Parameter for Create Site Folder | | `@microsoft.graph.conflictBehavior` | string | Optional | Parameter for Create Site Folder | ### Input Example `{"json_body":{"name":"test_folder_name","folder":{},"@microsoft.graph.conflictBehavior":"rename"},"path_parameters":{"parent-item-id":"root","site-id":"swimlaneintegrations-my.sharepoint.com,f9454dfb-d96b-46d1-9186-5fb7fda501b4,93abcf70-857e-40a0-a57e-9d58a3ffed21"}}` ### Output | **Parameter** | **Type** | **Description** | | ---------------------------------------- | -------- | ---------------------------------------- | | `status_code` | number | HTTP status code of the response | | `reason` | string | Response reason phrase | | `@odata.context` | string | Response data | | `createdDateTime` | string | Time value | | `eTag` | string | Output field: eTag | | `id` | string | Unique identifier | | `lastModifiedDateTime` | string | Time value | | `name` | string | Name of the resource | | `webUrl` | string | URL endpoint for the request | | `cTag` | string | Output field: cTag | | `size` | number | Output field: size | | `createdBy` | object | Output field: createdBy | | `createdBy.application` | object | Output field: createdBy.application | | `createdBy.application.id` | string | Unique identifier | | `createdBy.application.displayName` | string | Name of the resource | | `createdBy.user` | object | Output field: createdBy.user | | `createdBy.user.displayName` | string | Name of the resource | | `lastModifiedBy` | object | Output field: lastModifiedBy | | `lastModifiedBy.application` | object | Output field: lastModifiedBy.application | | `lastModifiedBy.application.id` | string | Unique identifier | | `lastModifiedBy.application.displayName` | string | Name of the resource | | `lastModifiedBy.user` | object | Output field: lastModifiedBy.user | | `lastModifiedBy.user.displayName` | string | Name of the resource | | `parentReference` | object | Output field: parentReference | | `parentReference.driveType` | string | Type of the resource | ### Output Example `{"@odata.context":"string","createdDateTime":"string","eTag":"string","id":"12345678-1234-1234-1234-123456789abc","lastModifiedDateTime":"string","name":"Example Name","webUrl":"string","cTag":"string","size":123,"createdBy":{"application":{"id":"12345678-1234-1234-1234-123456789abc","displayName":"Example Name"},"user":{"displayName":"Example Name"}},"lastModifiedBy":{"application":{"id":"12345678-1234-1234-1234-123456789abc","displayName":"Example Name"},"user":{"displayName":"Example Name"}},...` ## Create User Folder Creates a new folder or DriveItem in a Drive with a specified parent item or path ### Endpoint - **URL:** `v1.0/users/{{user-id}}/drive/items/{{parent-item-id}}/children` - **Method:** `POST` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | ----------------------------------- | -------- | ------------ | -------------------------------------------- | | `path_parameters.parent-item-id` | string | Required | Parameters for the Create User Folder action | | `path_parameters.user-id` | string | Required | Parameters for the Create User Folder action | | `name` | string | Optional | Name of the resource | | `folder` | object | Optional | Parameter for Create User Folder | | `@microsoft.graph.conflictBehavior` | string | Optional | Parameter for Create User Folder | ### Input Example `{"json_body":{"name":"you_can_delete_this_folder","folder":{},"@microsoft.graph.conflictBehavior":"rename"},"path_parameters":{"parent-item-id":"root","user-id":"2b77f477-3a9f-4823-a882-6fb6cae8c7f9"}}` ### Output | **Parameter** | **Type** | **Description** | | ---------------------------------------- | -------- | ---------------------------------------- | | `status_code` | number | HTTP status code of the response | | `reason` | string | Response reason phrase | | `@odata.context` | string | Response data | | `createdDateTime` | string | Time value | | `eTag` | string | Output field: eTag | | `id` | string | Unique identifier | | `lastModifiedDateTime` | string | Time value | | `name` | string | Name of the resource | | `webUrl` | string | URL endpoint for the request | | `cTag` | string | Output field: cTag | | `size` | number | Output field: size | | `createdBy` | object | Output field: createdBy | | `createdBy.application` | object | Output field: createdBy.application | | `createdBy.application.id` | string | Unique identifier | | `createdBy.application.displayName` | string | Name of the resource | | `createdBy.user` | object | Output field: createdBy.user | | `createdBy.user.displayName` | string | Name of the resource | | `lastModifiedBy` | object | Output field: lastModifiedBy | | `lastModifiedBy.application` | object | Output field: lastModifiedBy.application | | `lastModifiedBy.application.id` | string | Unique identifier | | `lastModifiedBy.application.displayName` | string | Name of the resource | | `lastModifiedBy.user` | object | Output field: lastModifiedBy.user | | `lastModifiedBy.user.displayName` | string | Name of the resource | | `parentReference` | object | Output field: parentReference | | `parentReference.driveType` | string | Type of the resource | ### Output Example `{"@odata.context":"string","createdDateTime":"string","eTag":"string","id":"12345678-1234-1234-1234-123456789abc","lastModifiedDateTime":"string","name":"Example Name","webUrl":"string","cTag":"string","size":123,"createdBy":{"application":{"id":"12345678-1234-1234-1234-123456789abc","displayName":"Example Name"},"user":{"displayName":"Example Name"}},"lastModifiedBy":{"application":{"id":"12345678-1234-1234-1234-123456789abc","displayName":"Example Name"},"user":{"displayName":"Example Name"}},...` ## Upload File to Session OneDrive Upload File to Session ### Endpoint - **Method:** `PUT` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | ----------------------- | -------- | ------------ | ------------------------------------ | | `upload_url` | string | Required | URL endpoint for the request | | `attachments` | array | Required | File to be uploaded | | `attachments.file` | string | Optional | Parameter for Upload File to Session | | `attachments.file_name` | string | Optional | Name of the resource | ### Input Example `{"upload_url":"string","attachments":[{"file":"string","file_name":"Example Name"}]}` ### Output Example `{"@odata.context":"https://swimlaneintegrations.sharepoint.com/_api/v2.0/$metadata#oneDrive.uploadS...","expirationDateTime":"2023-01-26T01:27:48.703Z","nextExpectedRanges":["983040-3199999"]}` ## Upload Group File Onedrive Upload Group File ### Endpoint - **URL:** `v1.0/groups/{{group-id}}/drive/items/{{parent-id}}:/{{filename}}:/content` - **Method:** `PUT` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | --------------------------- | -------- | ------------ | ------------------------------------------- | | `attachments` | array | Required | File to be uploaded | | `attachments.file` | string | Optional | Parameter for Upload Group File | | `attachments.file_name` | string | Optional | Name of the resource | | `path_parameters.group-id` | string | Required | Parameters for the Upload Group File action | | `path_parameters.parent-id` | string | Required | Parameters for the Upload Group File action | | `path_parameters.filename` | string | Required | Parameters for the Upload Group File action | | `headers` | object | Required | HTTP headers for the request | | `headers.Content-Type` | string | Required | HTTP headers for the request | ### Input Example `{"path_parameters":{"group-id":"b!62Ee6kGZPk6BVV9MSE16_a28d8PIiIVIrKGudAgSj6pSXvivqLXmQpCPTbWEgqWH","parent-id":"root","filename":"deleteme.png"},"headers":{"Content-Type":"text/plain"}}` ### Output | **Parameter** | **Type** | **Description** | | ---------------------------------------- | -------- | ---------------------------------------- | | `status_code` | number | HTTP status code of the response | | `reason` | string | Response reason phrase | | `@odata.context` | string | Response data | | `@microsoft.graph.downloadUrl` | string | URL endpoint for the request | | `createdDateTime` | string | Time value | | `eTag` | string | Output field: eTag | | `id` | string | Unique identifier | | `lastModifiedDateTime` | string | Time value | | `name` | string | Name of the resource | | `webUrl` | string | URL endpoint for the request | | `cTag` | string | Output field: cTag | | `size` | number | Output field: size | | `createdBy` | object | Output field: createdBy | | `createdBy.application` | object | Output field: createdBy.application | | `createdBy.application.id` | string | Unique identifier | | `createdBy.application.displayName` | string | Name of the resource | | `createdBy.user` | object | Output field: createdBy.user | | `createdBy.user.displayName` | string | Name of the resource | | `lastModifiedBy` | object | Output field: lastModifiedBy | | `lastModifiedBy.application` | object | Output field: lastModifiedBy.application | | `lastModifiedBy.application.id` | string | Unique identifier | | `lastModifiedBy.application.displayName` | string | Name of the resource | | `lastModifiedBy.user` | object | Output field: lastModifiedBy.user | | `lastModifiedBy.user.displayName` | string | Name of the resource | | `parentReference` | object | Output field: parentReference | ### Output Example `{"status_code":201,"response_headers":{"Cache-Control":"no-store, no-cache","Transfer-Encoding":"chunked","Content-Type":"application/json;odata.metadata=minimal;odata.streaming=true;IEEE754Compatible=f...","Content-Encoding":"gzip","Vary":"Accept-Encoding","Strict-Transport-Security":"max-age=31536000","request-id":"5a55a006-67e1-429c-9d56-0c03064f9c4f","client-request-id":"5a55a006-67e1-429c-9d56-0c03064f9c4f","x-ms-ags-diagnostic":"{\"ServerInfo\":{\"DataCenter\":\"Brazil South\",\"Slice\":\"...` ## Upload Site File Onedrive Upload Site File ### Endpoint - **URL:** `v1.0/sites/{{site-id}}/drive/items/{{parent-id}}:/{{filename}}:/content` - **Method:** `PUT` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | --------------------------- | -------- | ------------ | ------------------------------------------ | | `attachments` | array | Required | File to be uploaded | | `attachments.file` | string | Optional | Parameter for Upload Site File | | `attachments.file_name` | string | Optional | Name of the resource | | `path_parameters.site-id` | string | Required | Parameters for the Upload Site File action | | `path_parameters.parent-id` | string | Required | Parameters for the Upload Site File action | | `path_parameters.filename` | string | Required | Parameters for the Upload Site File action | | `headers` | object | Required | HTTP headers for the request | | `headers.Content-Type` | string | Required | HTTP headers for the request | ### Input Example `{"path_parameters":{"site-id":"b!62Ee6kGZPk6BVV9MSE16_a28d8PIiIVIrKGudAgSj6pSXvivqLXmQpCPTbWEgqWH","parent-id":"root","filename":"deleteme.png"},"headers":{"Content-Type":"text/plain"}}` ### Output | **Parameter** | **Type** | **Description** | | ---------------------------------------- | -------- | ---------------------------------------- | | `status_code` | number | HTTP status code of the response | | `reason` | string | Response reason phrase | | `@odata.context` | string | Response data | | `@microsoft.graph.downloadUrl` | string | URL endpoint for the request | | `createdDateTime` | string | Time value | | `eTag` | string | Output field: eTag | | `id` | string | Unique identifier | | `lastModifiedDateTime` | string | Time value | | `name` | string | Name of the resource | | `webUrl` | string | URL endpoint for the request | | `cTag` | string | Output field: cTag | | `size` | number | Output field: size | | `createdBy` | object | Output field: createdBy | | `createdBy.application` | object | Output field: createdBy.application | | `createdBy.application.id` | string | Unique identifier | | `createdBy.application.displayName` | string | Name of the resource | | `createdBy.user` | object | Output field: createdBy.user | | `createdBy.user.displayName` | string | Name of the resource | | `lastModifiedBy` | object | Output field: lastModifiedBy | | `lastModifiedBy.application` | object | Output field: lastModifiedBy.application | | `lastModifiedBy.application.id` | string | Unique identifier | | `lastModifiedBy.application.displayName` | string | Name of the resource | | `lastModifiedBy.user` | object | Output field: lastModifiedBy.user | | `lastModifiedBy.user.displayName` | string | Name of the resource | | `parentReference` | object | Output field: parentReference | ### Output Example `{"status_code":201,"response_headers":{"Cache-Control":"no-store, no-cache","Transfer-Encoding":"chunked","Content-Type":"application/json;odata.metadata=minimal;odata.streaming=true;IEEE754Compatible=f...","Content-Encoding":"gzip","Vary":"Accept-Encoding","Strict-Transport-Security":"max-age=31536000","request-id":"dd6ae12c-92e5-4c2d-80ae-863fe306e180","client-request-id":"dd6ae12c-92e5-4c2d-80ae-863fe306e180","x-ms-ags-diagnostic":"{\"ServerInfo\":{\"DataCenter\":\"Brazil South\",\"Slice\":\"...` ## Upload User File Onedrive Upload User File ### Endpoint - **URL:** `v1.0/users/{{user-id}}/drive/items/{{parent-id}}:/{{filename}}:/content` - **Method:** `PUT` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | --------------------------- | -------- | ------------ | ------------------------------------------ | | `attachments` | array | Required | File to be uploaded | | `attachments.file` | string | Optional | Parameter for Upload User File | | `attachments.file_name` | string | Optional | Name of the resource | | `path_parameters.user-id` | string | Required | Parameters for the Upload User File action | | `path_parameters.parent-id` | string | Required | Parameters for the Upload User File action | | `path_parameters.filename` | string | Required | Parameters for the Upload User File action | | `headers` | object | Required | HTTP headers for the request | | `headers.Content-Type` | string | Required | HTTP headers for the request | ### Input Example `{"path_parameters":{"user-id":"b!62Ee6kGZPk6BVV9MSE16_a28d8PIiIVIrKGudAgSj6pSXvivqLXmQpCPTbWEgqWH","parent-id":"root","filename":"deleteme.png"},"headers":{"Content-Type":"text/plain"}}` ### Output | **Parameter** | **Type** | **Description** | | ---------------------------------------- | -------- | ---------------------------------------- | | `status_code` | number | HTTP status code of the response | | `reason` | string | Response reason phrase | | `@odata.context` | string | Response data | | `@microsoft.graph.downloadUrl` | string | URL endpoint for the request | | `createdDateTime` | string | Time value | | `eTag` | string | Output field: eTag | | `id` | string | Unique identifier | | `lastModifiedDateTime` | string | Time value | | `name` | string | Name of the resource | | `webUrl` | string | URL endpoint for the request | | `cTag` | string | Output field: cTag | | `size` | number | Output field: size | | `createdBy` | object | Output field: createdBy | | `createdBy.application` | object | Output field: createdBy.application | | `createdBy.application.id` | string | Unique identifier | | `createdBy.application.displayName` | string | Name of the resource | | `createdBy.user` | object | Output field: createdBy.user | | `createdBy.user.displayName` | string | Name of the resource | | `lastModifiedBy` | object | Output field: lastModifiedBy | | `lastModifiedBy.application` | object | Output field: lastModifiedBy.application | | `lastModifiedBy.application.id` | string | Unique identifier | | `lastModifiedBy.application.displayName` | string | Name of the resource | | `lastModifiedBy.user` | object | Output field: lastModifiedBy.user | | `lastModifiedBy.user.displayName` | string | Name of the resource | | `parentReference` | object | Output field: parentReference | ### Output Example `{"status_code":201,"response_headers":{"Cache-Control":"no-store, no-cache","Transfer-Encoding":"chunked","Content-Type":"application/json;odata.metadata=minimal;odata.streaming=true;IEEE754Compatible=f...","Content-Encoding":"gzip","Vary":"Accept-Encoding","Strict-Transport-Security":"max-age=31536000","request-id":"4d66220a-21cc-4de5-852a-0d82e19dddae","client-request-id":"4d66220a-21cc-4de5-852a-0d82e19dddae","x-ms-ags-diagnostic":"{\"ServerInfo\":{\"DataCenter\":\"Brazil South\",\"Slice\":\"...` # Response Headers | **Header** | **Description** | **Example** | | ------------------------------- | ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Cache-Control | Directives for caching mechanisms | no-store, no-cache | | client-request-id | HTTP response header: client-request-id | dd6ae12c-92e5-4c2d-80ae-863fe306e180 | | Content-Encoding | HTTP response header: Content-Encoding | gzip | | Content-Security-Policy | HTTP response header: Content-Security-Policy | frame-ancestors 'self' teams.microsoft.com \*.teams.microsoft.com \*.skype.com \*.teams.microsoft.us local.teams.office.com \*.powerapps.com \*.yammer.com \*.officeapps.live.com \*.office.com \*.stream.azure-test.net \*.microsoftstream.com \*.dynamics.com \*.microsoft.com securebroker.sharepointonline.com; | | Content-Type | The media type of the resource | application/json | | Date | The date and time at which the message was originated | Wed, 25 Jan 2023 23:24:43 GMT | | Expires | The date/time after which the response is considered stale | -1 | | Location | The URL to redirect a page to | [https://graph.microsoft.com](https://graph.microsoft.com) | | MicrosoftSharePointTeamServices | HTTP response header: MicrosoftSharePointTeamServices | 16.0.0.23304 | | MS-CV | HTTP response header: MS-CV | oI/c9CrgADA174oHUjLS8w\.0 | | OData-Version | HTTP response header: OData-Version | 4.0 | | P3P | HTTP response header: P3P | CP="ALL IND DSP COR ADM CONo CUR CUSo IVAo IVDo PSA PSD TAI TELo OUR SAMo CNT COM INT NAV ONL PHY PRE PUR UNI" | | Pragma | HTTP response header: Pragma | no-cache | | request-id | HTTP response header: request-id | 329c0044-1a0d-42e7-b7f0-ff3a7cb978d0 | | SPClientServiceRequestDuration | HTTP response header: SPClientServiceRequestDuration | 1217 | | SPRequestGuid | HTTP response header: SPRequestGuid | f4dc8fa0-e02a-3000-35ef-8a075232d2f3 | | Strict-Transport-Security | HTTP response header: Strict-Transport-Security | max-age=31536000 | | Transfer-Encoding | HTTP response header: Transfer-Encoding | chunked | | Vary | HTTP response header: Vary | Accept-Encoding | | X-1DSCollectorUrl | HTTP response header: X-1DSCollectorUrl | [https://mobile.events.data.microsoft.com/OneCollector/1.0/](https://mobile.events.data.microsoft.com/OneCollector/1.0/) | | X-AriaCollectorURL | HTTP response header: X-AriaCollectorURL | [https://browser.pipe.aria.microsoft.com/Collector/3.0/](https://browser.pipe.aria.microsoft.com/Collector/3.0/) | | X-AspNet-Version | HTTP response header: X-AspNet-Version | 4.0.30319 | | X-Cache | HTTP response header: X-Cache | CONFIG\_NOCACHE | | X-Content-Type-Options | HTTP response header: X-Content-Type-Options | nosniff | | X-DataBoundary | HTTP response header: X-DataBoundary | NONE | | X-FRAME-OPTIONS | HTTP response header: X-FRAME-OPTIONS | SAMEORIGIN | | x-ms-ags-diagnostic | HTTP response header: x-ms-ags-diagnostic | \{"ServerInfo":\{"DataCenter":"Brazil South","Slice":"E","Ring":"3","ScaleUnit":"002","RoleInstance":"CP1PEPF00001D09"}} | | X-MS-InvokeApp | HTTP response header: X-MS-InvokeApp | 1; RequireReadOnly | | X-MSEdge-Ref | HTTP response header: X-MSEdge-Ref | Ref A: A572F0FBA87443C5A1CB23842FF954B9 Ref B: RIO01EDGE0617 Ref C: 2023-01-26T01:12:47Z | | X-NetworkStatistics | HTTP response header: X-NetworkStatistics | 0,525568,0,0,340,0,24489 | | X-Powered-By | HTTP response header: X-Powered-By | ASP.NET | | X-SharePointHealthScore | HTTP response header: X-SharePointHealthScore | 0 | | X-SP-SERVERSTATE | HTTP response header: X-SP-SERVERSTATE | ReadOnly=0 |