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

Indicates that a drive item was shared with others and includes information about how the item is shared.

If a driveItem has a non-null shared facet, the item was shared.

Properties

Property	Type	Description
owner	IdentitySet	The identity of the owner of the shared item. Read-only.
sharedBy	identitySet	The identity of the user who shared the item. Read-only.
sharedDateTime	DateTimeOffset	The UTC date and time when the item was shared. Read-only.
scope (deprecated)	String	Indicates the scope of how the item is shared. The possible values are: anonymous, organization, or users. Read-only.

Caution

The scope property of the shared facet is deprecated and will be removed from the service in the future. Instead, use the /permissions endpoint on sites, lists, list items, or drive items to better understand the shared status for a given resource.

scope property values

Value	Description
anonymous	The item is shared by using a link that works for anyone with the link.
organization	The item is shared by using a link that works for anyone in the owner's organization.
users	The item is shared with specific users only.

JSON representation

{
  "owner": { "@odata.type": "microsoft.graph.identitySet" },
  "scope": "anonymous | organization | users",
  "sharedBy": { "@odata.type": "microsoft.graph.identitySet" },
  "sharedDateTime": "datetime"
}