ItemReference resource type

Namespace: microsoft.graph

The ItemReference resource provides information necessary to address a DriveItem via the API.

JSON representation

Here is a JSON representation of the resource

{
  "driveId": "string",
  "driveType": "personal | business | documentLibrary",
  "id": "string",
  "name": "string",
  "path": "string",
  "shareId": "string",
  "sharepointIds": { "@odata.type": "microsoft.graph.sharepointIds" },
  "siteId": "string"
}

Properties

Property	Type	Description
driveId	String	Unique identifier of the drive instance that contains the item. Read-only.
driveType	String	Identifies the type of drive. See drive resource for values.
id	String	Unique identifier of the item in the drive. Read-only.
name	String	The name of the item being referenced. Read-only.
path	String	Path that can be used to navigate to the item. Read-only.
shareId	String	A unique identifier for a shared resource that can be accessed via the Shares API.
sharepointIds	sharepointIds	Returns identifiers useful for SharePoint REST compatibility. Read-only.
siteId	String	For OneDrive for Business and SharePoint, this property represents the ID of the site that contains the parent document library of the driveItem resource. The value is the same as the id property of that site resource. It is an opaque string that consists of three identifiers of the site. For OneDrive, this property is not populated.

Remarks

To address a driveItem from an itemReference resource, construct a URL of the format:

GET https://graph.microsoft.com/v1.0/drives/{driveId}/items/{id}

The path value is an API path relative to the target drive, for example: /drive/root:/Documents/myfile.docx.

To retrieve the human-readable path for a breadcrumb, you can safely ignore everything up to the first : in the path string.