SharedDriveItem resource type

Article
09/29/2021

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" },
  "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 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
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.
root	driveItem	Used to access the underlying driveItem. Deprecated -- use `driveItem` instead.

Methods

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

Remarks

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

Share via