Delete open extension

Delete an open extension (openTypeExtension object) from the specified instance of a resource.

Permissions

One of the following permissions is required to call this API, depending on the resource you're deleting the extension from. To learn more, including how to choose permissions, see Permissions.

Supported resource Permission Supported resource Permission
device Device.ReadWrite.All event Calendars.ReadWrite
group Group.ReadWrite.All group event Group.ReadWrite.All
group post Group.ReadWrite.All message Mail.ReadWrite
organization Directory.AccessAsUser.All personal contact Contacts.ReadWrite
user Directory.AccessAsUser.All

HTTP request

In the request, identify the resource instance, use the extensions navigation property of that instance to identify the extension, and do a DELETE on that extension instance.

DELETE /devices/{Id}/extensions/{extensionId}
DELETE /users/{id|userPrincipalName}/events/{id}/extensions/{extensionId}
DELETE /groups/{id}/extensions/{extensionId}
DELETE /groups/{id}/events/{id}/extensions/{extensionId}
DELETE /groups/{id}/threads/{id}/posts/{id}/extensions/{extensionId}
DELETE /users/{id|userPrincipalName}/messages/{id}/extensions/{extensionId}
DELETE /organization/{Id}/extensions/{extensionId}
DELETE /users/{id|userPrincipalName}/contacts/{id}/extensions/{extensionId}
DELETE /users/{id|userPrincipalName}/extensions/{extensionId}

Note: The above syntax shows some common ways to identify a resource instance, in order to delete an extension from it. All other syntax that allows you to identify these resource instances supports deleting open extensions from them in a similar way.

Parameters

Parameter Type Description
URL parameters    
id string A unique identifier for an instance in the corresponding collection. Required.
extensionId string This can be an extension name which is a unique text identifier for the extension, or a fully qualified name which concatenates the extension type and unique text identifier. The fully qualified name is returned in the id property when you create the extension. Required.

Request headers

Name Value
Authorization Bearer {token}. Required.

Request body

Do not supply a request body for this method.

Response

If successful, this method returns 204, No Content response code. It does not return anything in the response body.

Example

Request

The first example references an extension by its name and deletes the extension in the specified message.

DELETE https://graph.microsoft.com/v1.0/me/messages('AAMkAGE1M2IyNGNmLTI5MTktNDUyZi1iOTVl===')/extensions('Com.Contoso.Referral')

The second example deletes an extension in the specified group event.

DELETE https://graph.microsoft.com/v1.0/groups('f5480dfd-7d77-4d0b-ba2e-3391953cc74a')/events('AAMkADVlN17IsAAA=')/extensions('Com.Contoso.Referral')
Response

Here is an example of the response.

HTTP/1.1 204 No Content