shared resource type

  • Article

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"
}