| author | spgraph-docs-team |
|---|---|
| ms.date | 09/10/2017 |
| title | Remove access to an item |
| ms.localizationpriority | medium |
| description | Remove access to a DriveItem. |
| ms.subservice | onedrive |
| doc_type | apiPageType |
Namespace: microsoft.graph
Remove access to a driveItem.
Only sharing permissions that aren't inherited can be deleted.
The inheritedFrom property must be null.
Important
In SharePoint Embedded, permissions added to a fileStorageContainer can't be removed from its driveItem objects, which means that users and groups with container permissions have access to all items in that container.
[!INCLUDE national-cloud-support]
Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions only if your app requires it. For details about delegated and application permissions, see Permission types. To learn more about these permissions, see the permissions reference.
[!INCLUDE permissions-table]
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}| Name | Description |
|---|---|
| Authorization | Bearer {token}. Required. Learn more about authentication and authorization. |
| Content-Type | application/json. Required. |
| if-match | String. If this request header is included and the eTag (or cTag) provided doesn't match the current tag on the item, a 412 Precondition Failed response is returned and the item isn't deleted. |
If successful, this method returns 204 No Content response code.
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/v1.0/me/drive/items/{item-id}/permissions/{perm-id}[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
HTTP/1.1 204 No Content- Drives with a driveType of
personal(OneDrive Personal) can't create or modify permissions on the root driveItem.