SharedDriveItem 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 sharedDriveItem resource is returned when using the shares API to access a shared driveItem.

The sharedDriveItem resource is derived from baseItem and inherits properties from that resource.

For more information about the facets on a DriveItem, see driveItem.

Methods

Method Return Type Description
Use sharing links sharedDriveItem Access a shared item or a collection of shared items by using a shareId or sharing URL.

Properties

Property Type Description
id String The unique identifier for the share being accessed.
name String The display name of the shared item.
owner identitySet Information about the owner of the shared item being referenced.

Relationships

Relationship name Type Description
driveItem driveItem Used to access the underlying driveItem
list list Used to access the underlying list
listItem listItem Used to access the underlying listItem
permission permission Used to access the permission representing the underlying sharing link
site site Used to access the underlying site

Alternatively, for driveItems shared from personal OneDrive accounts, the following relationships may also be used.

Relationship name Type Description
items driveItem collection All driveItems contained in the sharing root. This collection cannot be enumerated.

JSON representation

The following JSON representation shows the resource.

{
  "id": "string",
  "name": "string",
  "owner": { "@odata.type": "microsoft.graph.identitySet" },

  "driveItem": { "@odata.type": "microsoft.graph.driveItem" },
  "items": [ { "@odata.type": "microsoft.graph.driveItem" }],
  "list": { "@odata.type": "microsoft.graph.list" },
  "listItem": { "@odata.type": "microsoft.graph.listItem" },
  "root": { "@odata.type": "microsoft.graph.driveItem" },
  "site": { "@odata.type": "microsoft.graph.site" }
}