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.

JSON representation

Here is a JSON representation of the sharedDriveItem resource.

The sharedDriveItem resource is derived from baseItem and inherits properties from that 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" },
  "permission": { "@odata.type": "microsoft.graph.permission" },
  "root": { "@odata.type": "microsoft.graph.driveItem" },
  "site": { "@odata.type": "microsoft.graph.site" }
}

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 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.
driveItem driveItem Used to access the underlying driveItem

Methods

Method REST Path
Get shared item GET /shares/{share-id}

Remarks

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