Sharepointconnector v1.0

Version 1.0

Connector Overview: This page documents all 29 actions for the Sharepointconnector v1.0.

Download

GET Download Asset

x-oneteg-downloader-path-without-authorization

Downloads a file from a given URL, optionally specifying an asset name and retry/timeout settings. Use to fetch files from external sources into the connector.

Parameters

Parameter Name

Description

HTTP Method

The HTTP method to use for the download request, such as GET.

Download Url

The full URL of the file to download.

Asset Name

A custom name to assign to the downloaded asset.

Try Count

The number of times to attempt the download if it fails.

Read Timeout (seconds)

The maximum time in seconds to wait for data during the download.

Connection Timeout (seconds)

The maximum time in seconds to establish a connection before timing out.

Load File Content As Output

This toggle enables you to load file content as the step output. Supported formats include JSON, XML, YML/YAML, CSV, TXT, and other text-based file types. Note that images, PDF files, and other binary formats cannot be loaded. Additionally, there is a file size limit for this feature; please check the logs for details.

Follow Redirects

Enable or disable following URL redirects. If it is enabled, it will follow the URL redirects.

headers

Additional HTTP header name/value pairs to include in the request.

Misc (27)

POST Create Folder

/sites/{SiteID}/drives/{DriveID}/root:/{folderPath}:/children

Creates a new folder at the specified path within a SharePoint drive. Use to organize content under a given site and drive.

Parameters

Parameter Name

Description

Content Type

The content type of the request payload sent to the API (e.g. application/json).

headers

Additional HTTP header name/value pairs to include in the request.

Accept

The expected response content type, such as application/json.

Siteid

The unique identifier of the SharePoint site containing the drive.

Driveid

The unique identifier of the drive where the folder will be created.

Folderpath

The relative path from the drive root where the new folder should be placed.

Response Type

The response format expected from the API (e.g. application/json).

Options (2)

Option Name

Description

Name

The name of the folder.

Folder

An optional nested folder structure.

POST Create Folder in Root

/sites/{SiteID}/drives/{DriveId}/root/children

Creates a new folder directly in the root of a SharePoint drive. Use for simple folder creation without specifying a nested path.

Parameters

Parameter Name

Description

Content Type

The content type of the request payload sent to the API (e.g. application/json).

headers

Additional HTTP header name/value pairs to include in the request.

Siteid

Provide site id

Driveid

Provide drive id

Response Type

The response format expected from the API (e.g. application/json).

Options (2)

Option Name

Description

Name

The name of the folder to create.

Folder

Set to an object with a name property to indicate a folder (e.g., { "name": "folder" }).

POST Create List Item

/sites/{SiteID}/lists/{ListId}/items

Creates a new item in a SharePoint list. Use to add data to a list, such as tasks or custom entries.

Parameters

Parameter Name

Description

Content Type

The content type of the request payload sent to the API (e.g. application/json).

headers

Additional HTTP header name/value pairs to include in the request.

Siteid

The unique identifier of the SharePoint site that contains the list.

Listid

The unique identifier of the list where the new item will be added.

Response Type

The response format expected from the API (e.g. application/json).

POST Create Site Page

/sites/{SiteID}/pages

Creates a new page in a SharePoint site. Use to publish modern pages with configurable layout and display options.

Parameters

Parameter Name

Description

Content Type

The content type of the request payload sent to the API (e.g. application/json).

headers

Additional HTTP header name/value pairs to include in the request.

Siteid

Provide site id

Response Type

The response format expected from the API (e.g. application/json).

Options (6)

Option Name

Description

@odata.type

The OData type of the page, typically "SP.Publishing.SitePage".

Name

The file name of the page (without extension).

Title

The display title of the page.

Pagelayout

The layout template for the page, such as "Article" or "Home".

Showcomments

Whether to show the comments section on the page, set to true or false.

Showrecommendedpages

Whether to show the recommended pages section on the page, set to true or false.

POST Create Sub Folder

/sites/{SiteID}/drives/{DriveId}/root:/{ParentFolder}:/children

Creates a new folder inside an existing parent folder within a SharePoint drive. Use to organize content hierarchically.

Parameters

Parameter Name

Description

Content Type

The content type of the request payload sent to the API (e.g. application/json).

headers

Additional HTTP header name/value pairs to include in the request.

Siteid

Provide sharepoint site id

Driveid

Provide drive id

Parentfolder

Provide parent folder name

Response Type

The response format expected from the API (e.g. application/json).

Options (2)

Option Name

Description

Name

The name of the new subfolder.

Folder

Set to an object with a name property to indicate a folder (e.g., { "name": "folder" }).

DELETE Delete List Item

/sites/{SiteID}/lists/{ListId}/items/1

Permanently removes the first item from a SharePoint list. Use to delete a specific list entry by its default ID.

Parameters

Parameter Name

Description

headers

Additional HTTP header name/value pairs to include in the request.

Siteid

The unique identifier of the SharePoint site that contains the list.

Listid

The unique identifier of the list from which the item will be deleted.

Response Type

The response format expected from the API (e.g. application/json).

POST Get Access Token

/token

Obtains an OAuth 2.0 access token for authenticating subsequent SharePoint API calls. Use to authenticate with client credentials.

Parameters

Parameter Name

Description

Content Type

The content type of the request payload sent to the API (e.g. application/json).

headers

Additional HTTP header name/value pairs to include in the request.

Content-type

The content type of the request body, typically "application/x-www-form-urlencoded".

Response Type

The response format expected from the API (e.g. application/json).

Options (4)

Option Name

Description

Grant Type

The OAuth grant type, for example "client_credentials".

Client Id

The application's client ID registered in Azure AD.

Client Secret

The application's client secret associated with the client ID.

Scope

The required permission scopes, such as "https://graph.microsoft.com/.default".

GET Get Drive ID

/sites/{SiteID}/drives

Retrieves a list of document libraries (drives) available in a SharePoint site. Use to obtain the drive ID needed for subsequent file operations.

Parameters

Parameter Name

Description

headers

Additional HTTP header name/value pairs to include in the request.

Siteid

The unique identifier of the SharePoint site whose drives are to be listed.

Response Type

The response format expected from the API (e.g. application/json).

GET Get Drive/Folder Items

/drives/{DriveID}/root:/{folderName}:/children

Lists all items (files and folders) inside a specific folder within a SharePoint drive. Use to browse the contents of a folder.

Parameters

Parameter Name

Description

headers

Additional HTTP header name/value pairs to include in the request.

Driveid

The unique identifier of the drive containing the folder.

Foldername

The name of the folder whose children are to be retrieved.

Response Type

The response format expected from the API (e.g. application/json).

GET Get Folder

/drives/{DriveID}/root:/{folderPath}

Retrieves metadata about a specific folder in a SharePoint drive using its path. Use to get folder details like ID and properties.

Parameters

Parameter Name

Description

headers

Additional HTTP header name/value pairs to include in the request.

Accept

The expected response content type, such as application/json.

Driveid

The unique identifier of the drive containing the folder.

Folderpath

The relative path from the drive root to the target folder.

Response Type

The response format expected from the API (e.g. application/json).

GET Get Item By Id

/sites/{SiteId}/drives/{DriveId}/items/{ItemId}

Retrieves metadata about a specific file or folder in a SharePoint drive using its item ID. Use to get details of a known item.

Parameters

Parameter Name

Description

headers

Additional HTTP header name/value pairs to include in the request.

Siteid

The unique identifier of the SharePoint site containing the drive.

Driveid

The unique identifier of the drive containing the item.

Itemid

The unique identifier of the item (file or folder) to retrieve.

Response Type

The response format expected from the API (e.g. application/json).

GET Get Item by Path

/{ItemPath}

Retrieves metadata about a file or folder using its full relative path from the site root. Use to get item details when the path is known.

Parameters

Parameter Name

Description

headers

Additional HTTP header name/value pairs to include in the request.

Itempath

Sharepoint drive also supports path-based addressing. This allows you to use a friendly URL syntax to address items relative to the hierarchy of items visible in drive

Response Type

The response format expected from the API (e.g. application/json).

GET Get List Items for SiteId/ListId

/sites/{SiteID}/lists/{ListID}/items

Retrieves all items from a SharePoint list, optionally filtered using OData $filter syntax. Use to read list data programmatically.

Parameters

Parameter Name

Description

headers

Additional HTTP header name/value pairs to include in the request.

Siteid

The unique identifier of the SharePoint site that contains the list.

Listid

The unique identifier of the list whose items are to be retrieved.

$filter

An OData filter expression to narrow the returned items, for example "fields/Title eq 'Example'".

Response Type

The response format expected from the API (e.g. application/json).

GET Get Lists by SiteID

/sites/{SiteID}/lists

Retrieve all lists for a specified SharePoint site using its site ID.

Parameters

Parameter Name

Description

headers

Additional HTTP header name/value pairs to include in the request.

Siteid

The unique identifier of the SharePoint site that contains the list.

Response Type

The response format expected from the API (e.g. application/json).

GET Get Site ID

/sites/{TenantName}.sharepoint.com:/sites/{SiteName}

Obtain the unique identifier of a SharePoint site by providing the tenant name and site name.

Parameters

Parameter Name

Description

headers

Additional HTTP header name/value pairs to include in the request.

Tenantname

The name of your SharePoint tenant (e.g., 'contoso') that appears before '.sharepoint.com'.

Sitename

The relative path or name of the site whose ID you want to retrieve.

Response Type

The response format expected from the API (e.g. application/json).

GET Get list columns

/sites/root/lists/{ListId}/columns

Retrieve the columns (fields) defined in a specific list within the root site collection.

Parameters

Parameter Name

Description

headers

Additional HTTP header name/value pairs to include in the request.

Content-type

The content type of the request body, typically "application/x-www-form-urlencoded".

Listid

The unique identifier of the list from which the item will be deleted.

Response Type

The response format expected from the API (e.g. application/json).

GET Get list content types

/sites/root/lists/{ListId}/contentTypes

Retrieve the content types associated with a specific list in the root site collection.

Parameters

Parameter Name

Description

headers

Additional HTTP header name/value pairs to include in the request.

Content-type

The content type of the request body, typically "application/x-www-form-urlencoded".

Listid

The unique identifier of the list from which the item will be deleted.

Response Type

The response format expected from the API (e.g. application/json).

GET Get my organization's default site collection

/sites/root

Retrieve details about the default (root) site collection for your organization.

Parameters

Parameter Name

Description

headers

Additional HTTP header name/value pairs to include in the request.

Content-type

The content type of the request body, typically "application/x-www-form-urlencoded".

Response Type

The response format expected from the API (e.g. application/json).

GET Get site columns

/sites/root/columns

Retrieve all site-level columns available across the root site collection.

Parameters

Parameter Name

Description

headers

Additional HTTP header name/value pairs to include in the request.

Content-type

The content type of the request body, typically "application/x-www-form-urlencoded".

Response Type

The response format expected from the API (e.g. application/json).

GET Get site content types

/sites/root/contentTypes

Retrieve all content types defined at the site level in the root site collection.

Parameters

Parameter Name

Description

headers

Additional HTTP header name/value pairs to include in the request.

Content-type

The content type of the request body, typically "application/x-www-form-urlencoded".

Response Type

The response format expected from the API (e.g. application/json).

GET Get site lists

/sites/root/lists

Retrieve all lists and libraries in the root site collection.

Parameters

Parameter Name

Description

headers

Additional HTTP header name/value pairs to include in the request.

Content-type

The content type of the request body, typically "application/x-www-form-urlencoded".

Response Type

The response format expected from the API (e.g. application/json).

GET Get subsites of site

/sites/root/sites

Retrieve all subsites (child sites) under the root site collection.

Parameters

Parameter Name

Description

headers

Additional HTTP header name/value pairs to include in the request.

Content-type

The content type of the request body, typically "application/x-www-form-urlencoded".

Response Type

The response format expected from the API (e.g. application/json).

GET Get the doc libs in root site

/sites/root/drives

Retrieve all document libraries (drives) in the root site collection.

Parameters

Parameter Name

Description

headers

Additional HTTP header name/value pairs to include in the request.

Content-type

The content type of the request body, typically "application/x-www-form-urlencoded".

Response Type

The response format expected from the API (e.g. application/json).

GET Search for site by name

/sites

Search for SharePoint sites by name across the tenant.

Parameters

Parameter Name

Description

headers

Additional HTTP header name/value pairs to include in the request.

Search

The search query string used to find sites by name or title.

Content-type

The content type of the request body, typically "application/x-www-form-urlencoded".

Response Type

The response format expected from the API (e.g. application/json).

PATCH Update Item Metadata

/sites/{SiteID}/lists/{ListId}/items/{ItemId}

Update the metadata (field values) of a specific list item by providing the site ID, list ID, and item ID.

Parameters

Parameter Name

Description

Content Type

The content type of the request payload sent to the API (e.g. application/json).

headers

Additional HTTP header name/value pairs to include in the request.

Siteid

The unique identifier of the SharePoint site that contains the list.

Listid

The unique identifier of the list from which the item will be deleted.

Itemid

The unique identifier of the item (file or folder) to retrieve.

Response Type

The response format expected from the API (e.g. application/json).

PATCH Update List Item

/sites/{SiteID}/lists/{ListId}/items/1

Update the first item in a specific list using the site ID and list ID.

Parameters

Parameter Name

Description

Content Type

The content type of the request payload sent to the API (e.g. application/json).

headers

Additional HTTP header name/value pairs to include in the request.

Siteid

The unique identifier of the SharePoint site that contains the list.

Listid

The unique identifier of the list from which the item will be deleted.

Response Type

The response format expected from the API (e.g. application/json).

PUT Upload Drive Item

/drives/{DriveID}/root:/{folderName}/{fileName}:/content

Upload a file to a specified folder in a SharePoint document library (drive).

Parameters

Parameter Name

Description

Content Type

The content type of the request payload sent to the API (e.g. application/json).

headers

Additional HTTP header name/value pairs to include in the request.

Driveid

The unique identifier of the drive containing the folder.

Foldername

The name of the folder whose children are to be retrieved.

Filename

The name of the file to be uploaded, including its extension.

Response Type

The response format expected from the API (e.g. application/json).

Options (1)

Option Name

Description

File

The file content or binary data to upload to the specified location.

Subscription

POST Subscriptions

/subscriptions

Create a new webhook subscription to receive change notifications for SharePoint resources.

Parameters

Parameter Name

Description

Content Type

The content type of the request payload sent to the API (e.g. application/json).

headers

Additional HTTP header name/value pairs to include in the request.

Response Type

The response format expected from the API (e.g. application/json).

Options (6)

Option Name

Description

Changetype

The type of change that triggers the notification, such as 'created', 'updated', or 'deleted'.

Notificationurl

The URL where SharePoint sends the notification payload when the subscribed resource changes.

Resource

The resource path (e.g., a site or list) to monitor for changes.

Expirationdatetime

The date and time when the subscription expires, after which no more notifications are sent.

Clientstate

An opaque string that is included in each notification to help verify the notification origin.

Latestsupportedtlsversion

The latest TLS version supported by the notification endpoint, used for security negotiation.