Delete message

Important: APIs under the /beta version in Microsoft Graph are in preview and are subject to change. Use of these APIs in production applications is not supported.

Delete a message in the specified user's mailbox, or delete a relationship of the message.

For example, you can delete a specific mention of the current user's in the message.


One of the following scopes is required to execute this API: Mail.ReadWrite

HTTP request

To delete the specified message:

DELETE /me/messages/{id}
DELETE /users/{id | userPrincipalName}/messages/{id}
DELETE /me/mailFolders/{id}/messages/{id}
DELETE /users/{id | userPrincipalName}/mailFolders/{id}/messages/{id}

To delete a specific mention in a message:

DELETE /me/messages/{id}/mentions/{id}
DELETE /users/{id | userPrincipalName}/messages/{id}/mentions/{id}
DELETE /me/mailFolders/{id}/messages/{id}/mentions/{id}
DELETE /users/{id | userPrincipalName}/mailFolders/{id}/messages/{id}/mentions/{id}

Request headers

Name Type Description
Authorization string Bearer {token}. Required.

Request body

Do not supply a request body for this method.


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


Request 1

The first example deletes the specified message.

Response 1

Here is an example of the response.

HTTP/1.1 204 No Content
Request 2

The next example deletes a certain mention in the specified message.

Response 2

Here is an example of the response.

HTTP/1.1 204 No Content