Skip to main content
Deletes a user message in the user’s inbox. The domain for these URIs is msg.xboxlive.com.

​
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.

​
URI parameters

​
Authorization

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

​
Request body

No objects are sent in the body of this request.

​
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. | 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.|

​
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.|

​
Effect of privacy settings on resource

Only you can delete your own user messages.

​
See also

Parent
/users/xuid()/inbox
Reference Standard HTTP status codes
Last modified on October 29, 2026