title	Delete webPart
description	Delete a webPart object.
author	sangle7
ms.localizationpriority	medium
ms.subservice	sharepoint
doc_type	apiPageType
ms.date	04/12/2024

Delete webPart

Namespace: microsoft.graph

[!INCLUDE beta-disclaimer]

Delete a webPart object.

[!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 /sites/{sitesId}/pages/{sitePageId}/microsoft.graph.sitePage/webParts/{webPartId}
DELETE /sites/{sitesId}/pages/{sitePageId}/microsoft.graph.sitePage/canvasLayout/verticalSection/webparts/{webPartIndex}
DELETE /sites/{sitesId}/pages/{sitePageId}/microsoft.graph.sitePage/canvasLayout/horizontalSections/{horizontalSectionId}/columns/{horizontalSectionColumnId}/webparts/{webPartIndex}

Request headers

Name	Value	Description
Authorization	Bearer {token}. Required. Learn more about authentication and authorization.	Required
if-match	etag	If this request header is included and the eTag provided doesn't match the current tag on the item, a `412 Precondition Failed` response is returned and the item won't be deleted.

Request body

Don't supply a request body with this method.

Response

If successful, this method returns a 204 No Content. It doesn't return anything in the response body.

Example

Request

HTTP

DELETE https://graph.microsoft.com/beta/sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202/microsoft.graph.sitePage/webParts/58ce69a6-bcb0-4f35-b6cd-d757d95f1a8e