Microsoft OneDrive

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:

Go to the App Registration page in the Azure portal.

Click New Registration.

Enter a name for your new application and choose Accounts in this organizational directory only, then click Register at the bottom.

Navigate to the API permissions tab on the left navigation menu.

Select Add a permission.

Select Microsoft Graph.

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).

Click the Add permissions button at the bottom of the page.

Select Grant admin consent for your organization, then your permissions should look as below.

Navigate to the Certificates & secrets tab and select New client secret.

Fill out the description and expiration, then click the Add button at the bottom.

The Value of the secret you just created is the Client Secret needed for the Swimlane asset.

14. Navigate to the Overview tab on the left menu.

15. The Client ID and Tenant ID needed in the asset are shown on this page.

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

Microsoft Graph Security API Homepage

Microsoft Graph REST API v1.0 reference

Query Parameters Documentation - OData V4

Microsoft Graph Security API v1.0 refrence

Azure AD OAuth2 flow

oauthlib Legacy Application client, this is sort of a hack to bypass manual login (typically required)

Limiting application permissions to specific Exchange Online mailboxes

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/ 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
[email protected]	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
[email protected]	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
[email protected]	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
[email protected]	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

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

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

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

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
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/
X-AriaCollectorURL	HTTP response header: X-AriaCollectorURL	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