Skip to content


The ability to manage drives and drive items in Onedrive is a capability introduced in version 1.2.4 of @pnp/graph. Through the methods described you can manage drives and drive items in Onedrive.

Get the default drive

Using the drive() you can get the default drive from Onedrive

import { graph } from "@pnp/graph";

const drives = await graph.users.getById('').drives.get();

const drives = await;

Get all of the drives

Using the drives() you can get the users available drives from Onedrive

import { graph } from "@pnp/graph";

const drives = await graph.users.getById('').drives.get();

const drives = await;

Get drive by Id

Using the drives.getById() you can get one of the available drives in Outlook

import { graph } from "@pnp/graph";

const drive = await graph.users.getById('').drives.getById('driveId');

const drive = await'driveId');

Get the associated list of a drive

Using the list() you get the associated list

import { graph } from "@pnp/graph";

const list = await graph.users.getById('').drives.getById('driveId').list.get();

const list = await'driveId').list.get();

Get the recent files

Using the recent() you get the recent files

import { graph } from "@pnp/graph";

const files = await graph.users.getById('').drives.getById('driveId').recent.get();

const files = await'driveId').recent.get();

Get the files shared with me

Using the sharedWithMe() you get the files shared with the user

import { graph } from "@pnp/graph";

const shared = await graph.users.getById('').drives.getById('driveId').sharedWithMe.get();

const shared = await'driveId').sharedWithMe.get();

Get the Root folder

Using the root() you get the root folder

import { graph } from "@pnp/graph";

const root = await graph.users.getById('').drives.getById('driveId').root.get();

const root = await'driveId').root.get();

Get the Children

Using the children() you get the children

import { graph } from "@pnp/graph";

const rootChildren = await graph.users.getById('').drives.getById('driveId').root.children.get();

const rootChildren = await'driveId').root.children.get();

const itemChildren = await graph.users.getById('').drives.getById('driveId').items.getById('itemId').children.get();

const itemChildren = await'driveId').root.items.getById('itemId').children.get();

Add folder or item

Using the add you can add a folder or an item

import { graph } from "@pnp/graph";
import { DriveItem as IDriveItem } from "@microsoft/microsoft-graph-types";

const addFolder = await graph.users.getById('').drives.getById('driveId').root.children.add('New Folder', <IDriveItem>{folder: {}});

const addFolder = await'driveId').root.children.add('New Folder', <IDriveItem>{folder: {}});

Search items

Using the search() you can search for items, and optionally select properties

import { graph } from "@pnp/graph";

const search = await graph.users.getById('').drives.getById('driveId')'queryText').get();

const search = await'driveId')'queryText').get();

Get specific item in drive

Using the items.getById() you can get a specific item from the current drive

import { graph } from "@pnp/graph";

const item = await graph.users.getById('').drives.getById('driveId').items.getById('itemId');

const item = await'driveId').items.getById('itemId');

Get thumbnails

Using the thumbnails() you get the thumbnails

import { graph } from "@pnp/graph";

const thumbs = await graph.users.getById('').drives.getById('driveId').items.getById('itemId').thumbnails.get();

const thumbs = await'driveId').items.getById('itemId').thumbnails.get();

Delete drive item

Using the delete() you delete the current item

import { graph } from "@pnp/graph";

const thumbs = await graph.users.getById('').drives.getById('driveId').items.getById('itemId').delete();

const thumbs = await'driveId').items.getById('itemId').delete();

Update drive item

Using the update() you update the current item

import { graph } from "@pnp/graph";

const update = await graph.users.getById('').drives.getById('driveId').items.getById('itemId').update({name: "New Name"});

const update = await'driveId').items.getById('itemId').update({name: "New Name"});

Move drive item

Using the move() you move the current item, and optionally update it

import { graph } from "@pnp/graph";

// Requires a parentReference to the new folder location
const move = await graph.users.getById('').drives.getById('driveId').items.getById('itemId').move({ parentReference: { id: 'itemId'}}, {name: "New Name"});

const move = await'driveId').items.getById('itemId').move({ parentReference: { id: 'itemId'}}, {name: "New Name"});