Delete a sharing permission from a file or folder
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.
Permission type | Permissions (from least to most privileged) |
---|---|
Delegated (work or school account) | Files.ReadWrite, Files.ReadWrite.All, Sites.ReadWrite.All |
Delegated (personal Microsoft account) | Files.ReadWrite, Files.ReadWrite.All |
Application | Files.ReadWrite.All, Sites.ReadWrite.All |
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
Name | Type | Description |
---|---|---|
if-match | string | If this request header is included and the eTag (or cTag) provided does not match the current tag on the item, a 412 Precondition Failed response is returned and the item will not be deleted. |
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 /me/drive/items/{item-id}/permissions/{perm-id}
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.