List Permissions

List the Permissions on an existing File or Folder in OneDrive.

Options

Field Definition Type Required
Result Set

Choose a method to filter search results:

  • First 200 Records: returns the first 200 matching records.
  • Stream Records: passes all matching records from your parent flow to a helper flow. A Streaming input section is added to the card from which you can select a helper flow for streaming and adding custom extensible fields.
Dropdown TRUE
Source

Choose a source:

  • My Drive: authenticated user's OneDrive.
  • Drive ID: a specified drive by the drive's unique ID.
  • Group ID: a specified group's document library for a group by the group's unique ID.
  • User ID: a specified user by the user's unique ID.
Dropdown TRUE

Input

Field Definition Type Required
Drive      
Drive ID

Unique ID for the drive requested.

Appears when Drive ID is selected from the Source option.

String TRUE
Group      
Group ID

Unique ID for the group which owns the document library.

Appears when Group ID is selected from the Source option.

String TRUE
User      
User ID

Unique ID for the user object who owns the drive item.

Appears when User ID is selected from the Source option.

String TRUE
Drive Item      
File or Folder ID Unique ID of the file or folder. String TRUE
Streaming      
Flow

Click Choose Flow to browse and select a helper flow where the search results will be streamed, then click Choose to confirm.

Optionally, click the empty field under Click or drop here to create and add custom extensible fields that pass data to the helper flow. These fields are added as key/value pairs under the State output object in the helper flow.

Appears when Stream Records is selected from the Result Set option.

Flow TRUE
List Criteria      
Record Limit

Specify the number of records to stream.

  • When the Limit field is set to 0, no records are returned.

  • When the Limit field is set to greater than 0, records greater than 0 and up the maximum number of records specified are returned.

  • When the Limit field is empty or not selected, all records are streamed.

  • Default value is 10 million.

  • Valid range is 0 to 10 million.

Appears when Stream Records is selected from the Result Set option.

String TRUE

Output

Field Definition Type
Permissions    
Permission ID Unique ID of the permission. String
Roles Type of user permission. List of Strings
Granted To Displays details of the users and applications for the user permission. Object
Granted To Identities Displays details of the users to whom permission was granted. List of Objects
Inherited From Provides a reference to the ancestor of the current permission, if it is inherited from an ancestor. Object
Invitation Details of any associated sharing invitation for this permission. Object
Link Provides the link details of the current permission, if it is a link type permissions. Object
Share ID Unique token that can be used to access this shared item via the shares API. String
Expiration Date Indicates the expiration time of the permission.
For example, yyyy-MM-ddTHH:mm:ssZ.
Date and Time
Has Password? True if the password is set for this permission, it's only showing in response; otherwise False. Boolean
Raw Data Raw JSON payload returned from the Microsoft Graph API for this particular action. Object
Records Streamed

Number of records streamed in a streaming flow.

Appears when Stream Records is selected from the Result Set option.

Number

Additional information

  • Users must be part of the group or have direct access to the file to read permissions of a file in that group.

  • Admins must be a member of the group.

Related topics

OneDrive connector

Elements of Workflows

Guidance for OneDrive connector

Microsoft Graph API documentation