Drive resource type

The drive resource is the top level object representing a user's OneDrive or a document library in SharePoint.

OneDrive users will always have a tleast one drive available, their default drive. Users without a OneDrive license may not have a default drive available.

JSON representation

Here is a JSON representation of the resource.

{
  "id": "string (identifier)",
  "driveType": "string",
  "owner": {"@odata.type": "microsoft.graph.identitySet"},
  "quota": {"@odata.type": "microsoft.graph.quota"},
  "root": {"@odata.type": "microsoft.graph.driveItem" },
  "items": [ {"@odata.type": "microsoft.graph.driveItem" }],
  "special": [ {"@odata.type": "microsoft.graph.driveItem" }]
}

Properties

Property Type Description
id String The unique identifier of the drive. Read-only.
driveType String Describes the type of drive represented by this resource. OneDrive personal drives will return personal. OneDrive for Business will return business. SharePoint document libraries will return documentLibrary. Read-only.
owner identitySet Optional. The user account that owns the drive.
quota quota Optional. Information about the drive's storage space quota.

Relationships

Relationship Type Description
items driveitem collection All items contained in the drive. Read-only. Nullable.
root driveitem The root folder of the drive. Read-only.
special driveitem collection Collection of common folders available in OneDrive. Read-only. Nullable.

Methods

The following methods are available for drive resources.

Method REST Path
Get user's default drive GET /me/drive
Get another user's drive GET /users/{user-id}/drive
Get root folder for a drive GET /drives/{drive-id}/root
List items in a drive GET /me/drive/root/children
List changes in a drive GET /me/drive/root/delta
Search items in a drive GET /me/drive/search(q='text')