Skip to content

driveitem-delete.md

Latest commit

 

History

History
118 lines (83 loc) · 4.42 KB

driveitem-delete.md

File metadata and controls

118 lines (83 loc) · 4.42 KB
author spgraph-docs-team
ms.date 06/18/2025
title Delete a file or folder
ms.localizationpriority medium
ms.subservice sharepoint
description Delete a DriveItem by using its ID or path.
doc_type 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]

[!INCLUDE app-permissions]

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. Optional. 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.
prefer String. Optional. A value of bypass-shared-lock bypasses any shared locks on the driveItem (for example, from a coauthoring session). A value of bypass-checked-out bypasses the checkout condition on the driveItem. Multiple comma-separated values are allowed.

Example

Request

The following example shows 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]

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.