Microsoft 365 Delete

Microsoft 365 Delete
Certified
Delete OneDrive/SharePoint item

Deletes a file or folder by ID; Graph moves it to the recycle bin unless retention prevents it. Requires Microsoft Graph permissions Files.ReadWrite.All and Sites.ReadWrite.All.

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

Examples

Delete a file from OneDrive

yaml
id: delete_onedrive_file
namespace: company.team

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

List and delete specific files

yaml
id: cleanup_old_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: "01TEMP_FOLDER"

  - id: delete_file
    type: io.kestra.plugin.microsoft365.oneshare.Delete
    tenantId: "{{ secret('TENANT_ID') }}"
    clientId: "{{ secret('CLIENT_ID') }}"
    clientSecret: "{{ secret('CLIENT_SECRET') }}"
    driveId: "b!abc123def456"
    itemId: "{{ outputs.list_files.files[0].id }}"

Properties

driveId *string

Drive ID

OneDrive or SharePoint drive identifier required for all OneShare tasks

itemId *string

Item ID

DriveItem ID of the file or folder to delete

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.

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.