From where i can find the full official documentation about the SharePoint REST API end point for creating sharing links, as the built-in Share actions do not achieve our requirements

(0) Share

Report

Posted on by johnjohn123

3,514

Inside any SharePoint Online site , we have the following four sharing options:-

Now I am building four custom REST API calls using the built-in "Send http request to SharePoint" action

which should generates the above four sharing options..so from where i can find a full documentation from Microsoft about the related rest service api endpoint and the available options? mainly i want the following 2 scenarios:-

Create/Generate Anyone link with password + View permission
Create/Generate "People you choose" + View permission + specifying the list of emails (internal & external) + Without sending invitation email (only generating the link)..

The built-in actions provided by the Power Automate, will not achieve our needs for the following reasons:-

1. The built-in "Create sharing link for a file or folder", allow us to create Anyone sharing links >> but there is not any option to specify a password, as follow:-

also we have the option to Grant specific users access to a item or folder using "Grant access to an item or a folder" built-in action. but this have inconsistent behavior , where if the external user specified already have a guest account inside the tenant, the user will be added directly to the document permission instead of creating a sharing link + this built-in action does not produce the generated link as an output. as in our case we want to get all the sharing links to build an HTML table which contain all the sharing links

Can anyone advice on this please? Thanks

Categories:

Building flows

I have the same question (0)

All responses (3)

Answers (0)

Expiscornovus 33,755 Most Valuable Professional on at

Like (1)

Report
Copy link

Link copied!

Hi @johnjohn123,

There is not a lot of documentation about this. Only ones I have found so far are the Open Specification ones:

https://learn.microsoft.com/en-us/openspecs/sharepoint_protocols/ms-csomspt/4443c933-6fdb-452b-be9a-d881551de8a8

That being said, you can reflect a lot via the Developer Toolbar Network tab. That's what I typically do to see how these sharing settings work.

Was this reply helpful? Yes No
johnjohn123 3,514 on at

Like (0)

Report
Copy link

Link copied!
@Expiscornovus Thanks a lot for the reply.

But inside this link https://learn.microsoft.com/en-us/openspecs/sharepoint_protocols/ms-csomspt/4443c933-6fdb-452b-be9a-d881551de8a8 i did not find any documentation about the parameters we can send when using the ShareLink end point, those parameters include; LinkKind, Role , Password, etc ?

Second Question:- Also i have used the browser developer tool's network tab and i have inspected the parameters , such as :-

1) Using Anyone link

2) Using "People you choose"

but i am not sure if i can rely on this, and can i be sure that those parameters will not get changed in the future or their behavior will not get changed ? since those parameters are not documented any where..

For example, in my case, when i send this request using the "People you choose" and the UI will send these parameters:-

where i will get a sharing link with View permission + and email will be send to the emails inside "peoplPickerInput".. but inside my custom rest api >> i removed the "emailDate" parameter (since i do not want to send direct invitation email) >> and the sharing link was created correctly without sending an invitation email -which is exactly what i am looking for-, then i captured this sharing link and send it on a custom email.. so my concern is if I can guarantee this outcomes always and in the future?

Also currently sending "role:1" will give the sharing link View permission, could this be changed in the future by Microsoft, so for example sending "role:1" might give Edit permission beside View?

Third question. i found those documentations regarding some parameters:-

https://learn.microsoft.com/en-us/dotnet/api/microsoft.sharepoint.client.sharinglinkkind?view=sharepoint-csom

https://learn.microsoft.com/en-us/dotnet/api/microsoft.sharepoint.client.sharing.role?view=sharepoint-csom

but see the message where it says :-

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

so is Microsoft trying to say this info is not final and that it can be changed?

Thanks again for your help.

Was this reply helpful? Yes No
Expiscornovus 33,755 Most Valuable Professional on at

Like (0)

Report
Copy link

Link copied!

Hi @johnjohn123,

Besides the OpenSpecs link I shared and a couple of CSOM links there is not much more official documentation. So, yes it is pretty limited from a documentation point of view.

From a community point of view I found this blog from Paul Matthews which I found very useful:

https://cann0nf0dder.wordpress.com/2018/04/04/externally-sharing-getsharinginformation-rest-api/

About the possibility of features changing. I would suggest to always keep an eye the roadmap and the Microsoft 365 Admin Centre. With the introduction of new features of changes Microsoft will highlight what impact it has on existing stuff as well. So, generally speaking I am not worried about these kind of changes. Also this sharing feature has been around 4-5 years now. But I do agree it could use a bit more official documentation though. Just my 2 cents.

Was this reply helpful? Yes No