driveitem-delete.md

author	ms.date	title	ms.localizationpriority	ms.subservice	description	doc_type
spgraph-docs-team	09/10/2017	Delete a file or folder	medium	sharepoint	Delete a DriveItem by using its ID or path.	apiPageType

Delete a DriveItem

Namespace: microsoft.graph

Delete a DriveItem by using its ID or path. Deleting items using this method moves the items to the recycle bin instead of permanently deleting the item.

[!INCLUDE national-cloud-support]

Permissions

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]

HTTP request

DELETE /drives/{drive-id}/items/{item-id}
DELETE /groups/{group-id}/drive/items/{item-id}
DELETE /me/drive/items/{item-id}
DELETE /sites/{siteId}/drive/items/{itemId}
DELETE /users/{userId}/drive/items/{itemId}

Request headers

Name	Description
Authorization	Bearer {token}. Required. Learn more about authentication and authorization.
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 won't be deleted.

Example

Here's an example of how to call this API.

HTTP

DELETE https://graph.microsoft.com/v1.0/me/drive/items/{item-id}

C#

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

CLI

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Go

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Java

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

JavaScript

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

PHP

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

PowerShell

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Python

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

---

Response

If successful, this call returns a 204 No Content response to indicate that resource was deleted and there was nothing to return.

HTTP/1.1 204 No Content

Error responses

See Error Responses for more info about how errors are returned.