Delete a sharing permission from a file or folder

• 09/10/2017
• 2 minutes to read
• Contributors
  • 
  • 
  • 
  • 
  • 
  • all

Remove access to a DriveItem.

Only sharing permissions that are not inherited can be deleted. The inheritedFrom property must be null.

Permissions

One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

HTTP request

DELETE /drives/{drive-id}/items/{item-id}/permissions/{perm-id}
DELETE /groups/{group-id}/drive/items/{item-id}/permissions/{perm-id}
DELETE /me/drive/items/{item-id}/permissions/{perm-id}
DELETE /sites/{site-id}/drive/items/{item-id}/permissions/{perm-id}
DELETE /users/{user-id}/drive/items/{item-id}/permissions/{perm-id}

Optional request headers

Response

If successful, this method returns 204 No Content response code.

Example

This example removes the permission identified as {perm-id} from the item {item-id} in the current user's OneDrive.

DELETE https://graph.microsoft.com/beta/me/drive/root/items/{item-id}/permissions/{perm-id}

Response

HTTP/1.1 204 No Content

SDK sample code

GraphServiceClient graphClient = new GraphServiceClient( authProvider );

await graphClient.Me.Drive.Root.Items.{item-id}.Permissions.{perm-id}
	.Request()
	.DeleteAsync();

const options = {
	authProvider,
};

const client = Client.init(options);

let res = await client.api('/me/drive/root/items/{item-id}/permissions/{perm-id}')
	.version('beta')
	.delete();

Read the SDK documentation for details on how to add the SDK to your project and create an authProvider instance.

Remarks

• Drives with a driveType of personal (OneDrive Personal) cannot create or modify permissions on the root DriveItem.