cancel
Showing results for 
Search instead for 
Did you mean: 
Reply

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

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

 
 

image.png

 

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

 

image.png

 

 

 

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:-

 

  1. Create/Generate Anyone link with password + View permission
  2. 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:-

image.png

 

  1. 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

    image.png

     

    Can anyone advice on this please? Thanks
3 REPLIES 3
Expiscornovus
Most Valuable Professional
Most Valuable Professional

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-...

 

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.

 



Happy to help out! 🙂

Interested in more #PowerAutomate #SharePointOnline or #MicrosoftCopilotStudio content?
Visit my blog, Subscribe to my YouTube channel or Follow me on Twitter


@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-... 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

 

johnjohn123_0-1684469049525.png

 

johnjohn123_1-1684469060396.png

 

2) Using "People you choose"

 

johnjohn123_2-1684469070913.png

johnjohn123_3-1684469079866.png

 

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:-

 

johnjohn123_0-1684507505765.png

 

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:-

  1. https://learn.microsoft.com/en-us/dotnet/api/microsoft.sharepoint.client.sharinglinkkind?view=sharep...
  2. https://learn.microsoft.com/en-us/dotnet/api/microsoft.sharepoint.client.sharing.role?view=sharepoin...

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.

Expiscornovus
Most Valuable Professional
Most Valuable Professional

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.



Happy to help out! 🙂

Interested in more #PowerAutomate #SharePointOnline or #MicrosoftCopilotStudio content?
Visit my blog, Subscribe to my YouTube channel or Follow me on Twitter


Helpful resources

Announcements

Community will be READ ONLY July 16th, 5p PDT -July 22nd

Dear Community Members,   We'd like to let you know of an upcoming change to the community platform: starting July 16th, the platform will transition to a READ ONLY mode until July 22nd.   During this period, members will not be able to Kudo, Comment, or Reply to any posts.   On July 22nd, please be on the lookout for a message sent to the email address registered on your community profile. This email is crucial as it will contain your unique code and link to register for the new platform encompassing all of the communities.   What to Expect in the New Community: A more unified experience where all products, including Power Apps, Power Automate, Copilot Studio, and Power Pages, will be accessible from one community.Community Blogs that you can syndicate and link to for automatic updates. We appreciate your understanding and cooperation during this transition. Stay tuned for the exciting new features and a seamless community experience ahead!

Summer of Solutions | Week 4 Results | Winners will be posted on July 24th

We are excited to announce the Summer of Solutions Challenge!    This challenge is kicking off on Monday, June 17th and will run for (4) weeks.  The challenge is open to all Power Platform (Power Apps, Power Automate, Copilot Studio & Power Pages) community members. We invite you to participate in a quest to provide solutions to as many questions as you can. Answers can be provided in all the communities.    Entry Period: This Challenge will consist of four weekly Entry Periods as follows (each an “Entry Period”)   - 12:00 a.m. PT on June 17, 2024 – 11:59 p.m. PT on June 23, 2024 - 12:00 a.m. PT on June 24, 2024 – 11:59 p.m. PT on June 30, 2024 - 12:00 a.m. PT on July 1, 2024 – 11:59 p.m. PT on July 7, 2024 - 12:00 a.m. PT on July 8, 2024 – 11:59 p.m. PT on July 14, 2024   Entries will be eligible for the Entry Period in which they are received and will not carryover to subsequent weekly entry periods.  You must enter into each weekly Entry Period separately.   How to Enter: We invite you to participate in a quest to provide "Accepted Solutions" to as many questions as you can. Answers can be provided in all the communities. Users must provide a solution which can be an “Accepted Solution” in the Forums in all of the communities and there are no limits to the number of “Accepted Solutions” that a member can provide for entries in this challenge, but each entry must be substantially unique and different.    Winner Selection and Prizes: At the end of each week, we will list the top ten (10) Community users which will consist of: 5 Community Members & 5 Super Users and they will advance to the final drawing. We will post each week in the News & Announcements the top 10 Solution providers.  At the end of the challenge, we will add all of the top 10 weekly names and enter them into a random drawing.  Then we will randomly select ten (10) winners (5 Community Members & 5 Super Users) from among all eligible entrants received across all weekly Entry Periods to receive the prize listed below. If a winner declines, we will draw again at random for the next winner.  A user will only be able to win once overall. If they are drawn multiple times, another user will be drawn at random.  Individuals will be contacted before the announcement with the opportunity to claim or deny the prize.  Once all of the winners have been notified, we will post in the News & Announcements of each community with the list of winners.   Each winner will receive one (1) Pass to the Power Platform Conference in Las Vegas, Sep. 18-20, 2024 ($1800 value). NOTE: Prize is for conference attendance only and any other costs such as airfare, lodging, transportation, and food are the sole responsibility of the winner. Tickets are not transferable to any other party or to next year’s event.   ** PLEASE SEE THE ATTACHED RULES for this CHALLENGE**   Week 1 Results: Congratulations to the Week 1 qualifiers, you are being entered in the random drawing that will take place at the end of the challenge.   Community MembersNumber SolutionsSuper UsersNumber Solutions Deenuji 9 @NathanAlvares24  17 @Anil_g  7 @ManishSolanki  13 @eetuRobo  5 @David_MA  10 @VishnuReddy1997  5 @SpongYe  9JhonatanOB19932 (tie) @Nived_Nambiar  8 @maltie  2 (tie)   @PA-Noob  2 (tie)   @LukeMcG  2 (tie)   @tgut03  2 (tie)       Week 2 Results: Congratulations to the Week 2 qualifiers, you are being entered in the random drawing that will take place at the end of the challenge. Week 2: Community MembersSolutionsSuper UsersSolutionsPower Automate  @Deenuji  12@ManishSolanki 19 @Anil_g  10 @NathanAlvares24  17 @VishnuReddy1997  6 @Expiscornovus  10 @Tjan  5 @Nived_Nambiar  10 @eetuRobo  3 @SudeepGhatakNZ 8     Week 3 Results: Congratulations to the Week 3 qualifiers, you are being entered in the random drawing that will take place at the end of the challenge. Week 3:Community MembersSolutionsSuper UsersSolutionsPower Automate Deenuji32ManishSolanki55VishnuReddy199724NathanAlvares2444Anil_g22SudeepGhatakNZ40eetuRobo18Nived_Nambiar28Tjan8David_MA22   Week 4 Results: Congratulations to the Week 4 qualifiers, you are being entered in the random drawing that will take place at the end of the challenge. Week 4:Community MembersSolutionsSuper UsersSolutionsPower Automate Deenuji11FLMike31Sayan11ManishSolanki16VishnuReddy199710creativeopinion14Akshansh-Sharma3SudeepGhatakNZ7claudiovc2CFernandes5 misc2Nived_Nambiar5 Usernametwice232rzaneti5 eetuRobo2   Anil_g2   SharonS2  

Check Out | 2024 Release Wave 2 Plans for Microsoft Dynamics 365 and Microsoft Power Platform

On July 16, 2024, we published the 2024 release wave 2 plans for Microsoft Dynamics 365 and Microsoft Power Platform. These plans are a compilation of the new capabilities planned to be released between October 2024 to March 2025. This release introduces a wealth of new features designed to enhance customer understanding and improve overall user experience, showcasing our dedication to driving digital transformation for our customers and partners.    The upcoming wave is centered around utilizing advanced AI and Microsoft Copilot technologies to enhance user productivity and streamline operations across diverse business applications. These enhancements include intelligent automation, AI-powered insights, and immersive user experiences that are designed to break down barriers between data, insights, and individuals. Watch a summary of the release highlights.    Discover the latest features that empower organizations to operate more efficiently and adaptively. From AI-driven sales insights and customer service enhancements to predictive analytics in supply chain management and autonomous financial processes, the new capabilities enable businesses to proactively address challenges and capitalize on opportunities.    

Updates to Transitions in the Power Platform Communities

We're embarking on a journey to enhance your experience by transitioning to a new community platform. Our team has been diligently working to create a fresh community site, leveraging the very Dynamics 365 and Power Platform tools our community advocates for.  We started this journey with transitioning Copilot Studio forums and blogs in June. The move marks the beginning of a new chapter, and we're eager for you to be a part of it. The rest of the Power Platform product sites will be moving over this summer.   Stay tuned for more updates as we get closer to the launch. We can't wait to welcome you to our new community space, designed with you in mind. Let's connect, learn, and grow together.   Here's to new beginnings and endless possibilities!   If you have any questions, observations or concerns throughout this process please go to https://aka.ms/PPCommSupport.   To stay up to date on the latest details of this migration and other important Community updates subscribe to our News and Announcements forums: Copilot Studio, Power Apps, Power Automate, Power Pages

Users online (3,687)