itemReference resource type

Namespace: microsoft.graph

The itemReference resource provides information necessary to address a driveItem or a listItem via the API.

Properties

Property	Type	Description
driveId	String	Unique identifier of the drive instance that contains the driveItem. Only returned if the item is located in a drive. Read-only.
driveType	String	Identifies the type of drive. Only returned if the item is located in a drive. See drive resource for values.
id	String	Unique identifier of the driveItem in the drive or a listItem in a list. 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 or the parent list of the listItem 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.

JSON representation

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

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.