sharingLink resource type

Namespace: microsoft.graph

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

The sharingLink resource groups link-related data items into a single structure.

If a permission resource has a non-null sharingLink facet, the permission represents a sharing link (as opposed to permissions granted to a person or group).

JSON representation

The following JSON representation shows the resource type.

{
  "application": { "@odata.type": "microsoft.graph.identity" },
  "preventsDownload": false,
  "type": "view | edit | embed",
  "scope": "anonymous | organization",
  "webHtml": "string",
  "webUrl": "url"
}

Properties

Property Type Description
application identity The app the link is associated with.
type String The type of the link created.
scope String The scope of the link represented by this permission. Value anonymous indicates the link is usable by anyone, organization indicates the link is only usable for users signed into the same tenant.
preventsDownload Boolean If true then the user can only use this link to view the item on the web, and cannot use it to download the contents of the item. Only for OneDrive for Business and SharePoint.
webHtml String For embed links, this property contains the HTML code for an <iframe> element that will embed the item in a webpage.
webUrl String A URL that opens the item in the browser on the OneDrive website.

Type options

The following table defines the possible values for the type property.

Value Role Description
view read A view-only sharing link, allowing read-only access.
edit write An edit sharing link, allowing read-write access.
embed read A view-only sharing link that can be used to embed content into a host webpage. Embed links are not available for OneDrive for Business or SharePoint.

Scope options

The following table defines the possible values for the scope property.

Value Description
anonymous Anyone with the link has access, without needing to sign in. This may include people outside of your organization.
organization Anyone signed into your organization (tenant) can use the link to get access. Only available in OneDrive for Business and SharePoint.
existingAccess Only people who have already been granted access to the item through other means can access the item using this link. Only available in OneDrive for Business and SharePoint.
users The link grants access only to a specific list of people. Only available in OneDrive for Business and SharePoint.