Skip to main content

DELETE (/users/xuid()/inbox/)

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 August 20, 2026