> ## 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})

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

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

<a id="ID4EV" />

## 備註

刪除作業具有等冪性。

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

<a id="ID4ECB" />

## URI 參數

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

<a id="ID4EPB" />

## 授權

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

<a id="ID4E1B" />

## 要求本文

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

<a id="ID4EHC" />

## HTTP 狀態碼

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

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

<a id="ID4EAE" />

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

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

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

<a id="ID4EYF" />

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

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

<a id="ID4EDG" />

## 另請參閱

<a id="ID4EFG" />

##### 上層

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

<a id="ID4ETG" />

##### 參考  [標準 HTTP 狀態碼](/zh-TW/reference/live/rest/additional/httpstatuscodes)


## Related topics

- [XblAchievementsGetAchievementsForTitleIdAsync](/reference/live/xsapi-c/achievements_c/functions/xblachievementsgetachievementsfortitleidasync.md)
- [XblAchievementsUpdateAchievementForTitleIdAsync](/reference/live/xsapi-c/achievements_c/functions/xblachievementsupdateachievementfortitleidasync.md)
