Delete a sharing permission from a file or folder

• 09/10/2017
• 2 minutes to read
• • J
  • d
  • j
  • m
  • a
  • +3

Namespace: microsoft.graph

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}

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();

MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];

NSString *MSGraphBaseURL = @"https://graph.microsoft.com/beta/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/me/drive/root/items/{item-id}/permissions/{perm-id}"]]];
[urlRequest setHTTPMethod:@"DELETE"];

MSURLSessionDataTask *meDataTask = [httpClient dataTaskWithRequest:urlRequest 
	completionHandler: ^(NSData *data, NSURLResponse *response, NSError *nserror) {

		//Request Completed

}];

[meDataTask execute];

IGraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();

graphClient.me().drive().root().items().{item-id}().permissions().{perm-id}()
	.buildRequest()
	.delete();

Response

HTTP/1.1 204 No Content

Remarks

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