Microsoft 365 List

Microsoft 365 List
Certified
List OneDrive/SharePoint folder items

Lists children of a folder (defaults to drive root) and follows Graph pagination until all items are collected. Requires Microsoft Graph permissions Files.Read.All and Sites.Read.All.

yaml
type: io.kestra.plugin.microsoft365.oneshare.List

Examples

List files in OneDrive folder

yaml
id: list_onedrive_files
namespace: company.team

tasks:
  - id: list_files
    type: io.kestra.plugin.microsoft365.oneshare.List
    tenantId: "{{ secret('TENANT_ID') }}"
    clientId: "{{ secret('CLIENT_ID') }}"
    clientSecret: "{{ secret('CLIENT_SECRET') }}"
    driveId: "b!abc123def456"
    itemId: "root"

List files in specific folder

yaml
id: list_folder_contents
namespace: company.team

tasks:
  - id: list_folder_files
    type: io.kestra.plugin.microsoft365.oneshare.List
    tenantId: "{{ secret('TENANT_ID') }}"
    clientId: "{{ secret('CLIENT_ID') }}"
    clientSecret: "{{ secret('CLIENT_SECRET') }}"
    driveId: "b!abc123def456"
    itemId: "01FOLDER123456789"

Properties

driveId *string

Drive ID

OneDrive or SharePoint drive identifier required for all OneShare tasks

clientId string

Client ID

Client ID of the Azure service principal. If you don't have a service principal, refer to create a service principal with Azure CLI.

clientSecret string

Client Secret

Service principal client secret. Use this for Client Secret authentication. Provide clientId, tenantId, and clientSecret. Either clientSecret OR pemCertificate must be provided, not both.

itemId string

Folder ID

DriveItem ID of the folder to list; defaults to root

pemCertificate string

PEM Certificate

Alternative authentication method using certificate-based authentication.
Use this for Client Certificate authentication. Provide clientId, tenantId, and pemCertificate.
Either clientSecret OR pemCertificate must be provided, not both.

pluginDefaultsRef string

Reference (ref) of the pluginDefaults to apply to this task.

tenantId string

Tenant ID

Outputs

count integer

Default0

Number of files

files array

List of files

Definitions

io.kestra.plugin.microsoft365.oneshare.models.OneShareFile

createdDateTimestring

Formatdate-time

idstring

isFolderboolean

lastModifiedDateTimestring

Formatdate-time

mimeTypestring

namestring

sizeinteger

webUrlstring

Stripe

Tasks that interact with Stripe customers, payments, balances, and webhooks.

Business

Klaviyo

Tasks that interact with Klaviyo campaign APIs.

AIBusiness

Microsoft 365 ListCertifiedList OneDrive/SharePoint folder items

Microsoft 365 List

More Plugins in this Category

Stripe

Klaviyo

Microsoft 365 List
Certified
List OneDrive/SharePoint folder items