> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# DELETE (/users/xuid({xuid})/inbox/{messageId})

> DELETE (/users/xuid({xuid})/inbox/{messageId})

# DELETE (/users/xuid({xuid})/inbox/{messageId})

Deletes a user message in the user's inbox.
The domain for these URIs is `msg.xboxlive.com`.

* [Remarks](#ID4EV)
* [URI parameters](#ID4ECB)
* [Authorization](#ID4EPB)
* [Request body](#ID4E1B)
* [HTTP status codes](#ID4EHC)
* [JavaScript Object Notation (JSON) Response](#ID4EAE)
* [Effect of privacy settings on resource](#ID4EYF)

<a id="ID4EV" />

## Remarks

The delete operation is idempotent.

The only content type this API supports is "application/json", which is required in the HTTP headers of each call.

<a id="ID4ECB" />

## URI parameters

| Parameter | Type                    | Description                                                      |
| --------- | ----------------------- | ---------------------------------------------------------------- |
| xuid      | unsigned 64-bit integer | The XBOX User ID (XUID) of the player who is making the request. |
| messageId | string\[50]             | ID of the message being retrieved or deleted.                    |

<a id="ID4EPB" />

## Authorization

You must have your own user claim to delete a user message.

<a id="ID4E1B" />

## Request body

No objects are sent in the body of this request.

<a id="ID4EHC" />

## HTTP status codes

The service returns one of the status codes in this section in response to a request made with this method on this resource. For a complete list of standard HTTP status codes used with XBOX Live Services, see [Standard HTTP status codes](/reference/live/rest/additional/httpstatuscodes).

\| Code| Description|
\| --- | --- | --- | --- | --- |
\| 204| Success.|
\| 403| The XUID cannot be converted or a valid XUID claim cannot be found.|
\| 404| Message ID in the URI cannot be parsed or an XUID is missing in the URI.|
\| 500| General server-side error.|

<a id="ID4EAE" />

## JavaScript Object Notation (JSON) Response

In case of error, the service may return an errorResponse object, which may contain values from the environment of the service.

\| Property| Type| Description|
\| --- | --- | --- | --- | --- | --- | --- | --- |
\| errorSource| string| An indication of where the error originated.|
\| errorCode| int| Numeric code associated with the error (can be null).|
\| errorMessage| string| Details of the error if configured to show details.|

<a id="ID4EYF" />

## Effect of privacy settings on resource

Only you can delete your own user messages.

<a id="ID4EDG" />

## See also

<a id="ID4EFG" />

##### Parent

[/users/xuid({xuid})/inbox](/reference/live/rest/uri/users/uri-usersxuidinbox)

<a id="ID4ETG" />

##### Reference  [Standard HTTP status codes](/reference/live/rest/additional/httpstatuscodes)