Skip to content

Commit b417be5

Browse files
Merge pull request SharePoint#8625 from omarelanis/patch-4
Update wording
2 parents c694f48 + 100a706 commit b417be5

File tree

1 file changed

+16
-2
lines changed

1 file changed

+16
-2
lines changed

docs/business-apps/power-automate/guidance/manage-list-item-file-permissions.md

Lines changed: 16 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,22 +1,26 @@
11
---
22
title: Manage list item and file permissions with Power Automate
33
description: "SharePoint connector in Power Automate lets you grant access, create sharing links, or rescind access for items or folders."
4-
ms.date: 06/28/2022
4+
ms.date: 12/01/2022
55
search.app:
66
- Flow
77
search.appverid: met150
88
---
99

1010
# Manage list item and file permissions with Power Automate flows
11+
1112
SharePoint connector in Power Automate provides the following actions to manage permissions of an individual list item in a list or a file in a document library.
13+
1214
- Grant access to an item or a folder
1315
- Create sharing link for a file or folder
1416
- Stop sharing an item or a file
1517

1618
All of the above actions let you customize permissions for the item or a file to allow the right users to access that item or the file. To grant access or stop sharing, you will need to be a list owner of that list or library. That means, in your flow for these actions, you must connect to the list or library using a list owner user account.
1719

1820
## Grant access to an item or a folder
21+
1922
The 'Grant access to an item or a folder' action requires the following inputs:
23+
2024
- SharePoint site URL
2125
- List or library name or identifier
2226
- The item or the file identifier for which to grant access
@@ -31,28 +35,34 @@ In the flow action, you can also include a message and choose to notify the reci
3135
> 'Grant access to an item or a folder' does not support granting access to external users.
3236
3337
### Choosing a permission role to grant access
38+
3439
Depending on the user, you may want to grant them either access to edit or read. You can choose the right access in the Roles property.
3540

3641
![Choose the right role to grant access to an item or a file](../../../images/grant-access-item-file-roles-flow.png)
3742

3843
The permission roles map to [simplified standard SharePoint permission groups](/sharepoint/modern-experience-sharing-permissions):
44+
3945
- Members
40-
- Owners
46+
- Visitors
4147

4248
### Using custom-defined roles to grant access
49+
4350
In advanced scenarios where you need to specify a custom-defined permission role, you can do so in the flow action by entering a custom value for the *Roles* property in the following format:
51+
4452
```
4553
role:<role-id>
4654
```
4755

4856
![Use a custom role to grant access to an item or a file](../../../images/grant-access-item-file-custom-role-flow.png)
4957

5058
If you want to get the role id for the custom-defined role permission, you can do so by navigating to the SharePoint URL in your web browser and then search for that role.
59+
5160
```
5261
https://<your-sharepoint-site>/_api/web/roledefinitions
5362
```
5463

5564
For example:
65+
5666
```
5767
https://contoso.microsoft.com/teams/itweb/_api/web/roledefinitions
5868
```
@@ -62,6 +72,7 @@ You can find the role Id in the *category* property of an role item.
6272
![SharePoint site role definitions](../../../images/sp-web-roledefinitions.png)
6373

6474
## Grant access using sharing links
75+
6576
Instead of granting users access to files directly, you can provide access to a specific file using [shareable links](/sharepoint/modern-experience-sharing-permissions#sharable-links).
6677

6778
You can use the '[Create sharing link for a file or folder](/sharepoint/dev/business-apps/power-automate/sharepoint-connector-actions-triggers#create-sharing-link-for-a-file-or-folder)' action to create shareable links for a given file.
@@ -72,13 +83,16 @@ You can use the '[Create sharing link for a file or folder](/sharepoint/dev/busi
7283
![Create sharing link for a file or folder flow action](../../../images/create-sharing-link-file-action-flow.png)
7384

7485
When creating a shareable link using the action, you can specify:
86+
7587
- Link type
7688
- Type of sharing link - view and edit or view only
7789
- Link scope
7890
- Who gets access to the link - anyone with the link, including anonymous or people in your organization
7991

8092
## Stop sharing an item or a file
93+
8194
The 'Stop sharing an item or a file' action requires the following inputs:
95+
8296
- SharePoint site address
8397
- List or library name or identifier
8498
- The item or the file identifier for which to stop sharing

0 commit comments

Comments
 (0)