> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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})

刪除使用者收件匣中的使用者訊息。
這些 URI 的網域為 `msg.xboxlive.com`。

* [備註](#ID4EV)
* [URI 參數](#ID4ECB)
* [授權](#ID4EPB)
* [要求本文](#ID4E1B)
* [HTTP 狀態碼](#ID4EHC)
* [JavaScript 物件標記法 (JSON) 回應](#ID4EAE)
* [隱私權設定對資源的影響](#ID4EYF)

## 備註

刪除作業具有等冪性。

此 API 唯一支援的內容類型為 "application/json"，每次呼叫的 HTTP 標頭中都必須包含此內容類型。

## URI 參數

| 參數 | 類型 | 描述 |
| - | - | - |
| xuid | 不帶正負號的 64 位元整數 | 提出要求之玩家的 XBOX 使用者識別碼 (XUID)。 |
| messageId | string\[50] | 要擷取或刪除之訊息的識別碼。 |

## 授權

您必須擁有自己的使用者宣告，才能刪除使用者訊息。

## 要求本文

此要求的本文中不會傳送任何物件。

## HTTP 狀態碼

服務會傳回本節中的其中一個狀態碼，以回應在此資源上使用此方法所提出的要求。如需搭配 XBOX Live 服務使用的標準 HTTP 狀態碼完整清單，請參閱[標準 HTTP 狀態碼](https://docs.xbox.com/zh-TW/reference/live/rest/additional/httpstatuscodes.md)。

\| 代碼| 描述|
\| --- | --- | --- | --- | --- |
\| 204| 成功。|
\| 403| 無法轉換 XUID，或找不到有效的 XUID 宣告。|
\| 404| 無法剖析 URI 中的訊息識別碼，或 URI 中缺少 XUID。|
\| 500| 一般伺服器端錯誤。|

## JavaScript 物件標記法 (JSON) 回應

發生錯誤時，服務可能會傳回 errorResponse 物件，其中可能包含來自服務環境的值。

\| 屬性| 類型| 描述|
\| --- | --- | --- | --- | --- | --- | --- | --- |
\| errorSource| string| 錯誤來源的指示。|
\| errorCode| int| 與錯誤相關聯的數值代碼 (可以是 null)。|
\| errorMessage| string| 如果設定為顯示詳細資料，則為錯誤的詳細資料。|

## 隱私權設定對資源的影響

只有您可以刪除您自己的使用者訊息。

## 另請參閱

##### 上層

[/users/xuid({xuid})/inbox](https://docs.xbox.com/zh-TW/reference/live/rest/uri/users/uri-usersxuidinbox.md)

##### 參考  [標準 HTTP 狀態碼](https://docs.xbox.com/zh-TW/reference/live/rest/additional/httpstatuscodes.md)


## Related topics

- [GET (/users/xuid({xuid})/inbox/{messageId})](https://docs.xbox.com/zh-TW/reference/live/rest/uri/users/uri-usersxuidinboxmessageidget.md)
- [DELETE /titles/{titleId}/users/{xuid}/activities](https://docs.xbox.com/zh-TW/reference/live/rest/uri/multiplayeractivity/swagger-uris/uri-DeleteActivity.md)
- [/users/xuid({xuid})/inbox](https://docs.xbox.com/zh-TW/reference/live/rest/uri/users/uri-usersxuidinbox.md)
- [GET (/users/xuid({xuid})/inbox)](https://docs.xbox.com/zh-TW/reference/live/rest/uri/users/uri-usersxuidinboxget.md)
- [DELETE (/users/xuid({xuid})/devices/current/titles/current)](https://docs.xbox.com/zh-TW/reference/live/rest/uri/presence/uri-usersxuiddevicescurrenttitlescurrentdelete.md)
