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

# POST /users/xuid(xuid)/lists/PINS/{listname}/RemoveItems

> POST /users/xuid(xuid)/lists/PINS/{listname}/RemoveItems

# POST /users/xuid(xuid)/lists/PINS/{listname}/RemoveItems

itemId を指定してリストから項目を削除します。
これらの URI のドメインは `eplists.xboxlive.com` です。

* [注釈](#ID4EV)
* [URI パラメーター](#ID4EFB)
* [クエリ文字列パラメーター](#ID4EOC)
* [リクエスト本文](#ID4EZC)
* [HTTP ステータス コード](#ID4EED)
* [必須リクエスト ヘッダー](#ID4E1AAC)
* [応答本文](#ID4EQCAC)

## 注釈

インデックスではなく項目 ID を指定してリストから項目を削除します。1 回の呼び出しで削除できる項目は 100 件までです。**項目を渡さなかった場合は、リスト全体が削除されます (リストは残りますが空になり、バージョン番号は引き続き増分されます)。** 項目が削除されると、リストは「コンパクト化」され、インデックスの並びに欠落が生じないようになります。

"If-Match:versionNumber" ヘッダーはこの呼び出しでは省略可能です。含まれている場合は検証されます。versionNumber はファイルの現在のバージョン番号です。含まれていて現在のリスト バージョン番号と一致しない場合は、HTTP 412 - precondition failed ステータス コードが返され、応答本文には現在のバージョン番号を含む、リストの最新メタデータが含まれます。これは、異なるクライアントからの更新が互いに上書きし合うことを防ぐためのものです。

## URI パラメーター

| パラメーター | 種類 | 説明 |
| - | - | - |
| XUID | string | ユーザーの XUID。 |
| listname | string | 操作対象のリスト名。 |

## クエリ文字列パラメーター

クエリ パラメーターはサポートされません。

## リクエスト本文

```cpp theme={null}
{
   "Items":
   [{"ItemId":  "ed591a0c-dde3-563f-99af-530278a3c402",
      "ProviderId":  null,
      "Provider":  null
   }]
}

    
```

## HTTP ステータス コード

サービスは、このリソースに対してこのメソッドで行われたリクエストに応じて、このセクションのステータス コードのいずれかを返します。XBOX Live サービスで使用される標準の HTTP ステータス コードの完全な一覧については、「[標準 HTTP ステータス コード](https://docs.xbox.com/ja-jp/reference/live/rest/additional/httpstatuscodes.md)」を参照してください。

\| コード| 理由フレーズ| 説明|
\| --- | --- | --- | --- | --- | --- |
\| 200| OK | リクエストは正常に完了しました。応答本文には要求されたリソースが含まれるはずです (GET の場合)。POST および PUT リクエストは、最新のリスト メタデータ (リスト バージョン、件数など) を受け取ります。|
\| 201| Created | 新しいリストが作成されました。これはリストへの最初の挿入時に返されます。応答にはリストの最新のメタデータが含まれ、location ヘッダーにはリストの URI が含まれます。|
\| 304| Not Modified| GET で返されます。クライアントが最新バージョンのリストを持っていることを示します。サービスは **If-Match** ヘッダーの値をリスト バージョンと比較します。等しい場合は、データなしで 304 が返されます。 |
\| 400| Bad Request | リクエストの形式が不正です。URI またはクエリ文字列パラメーターの値または型が無効である可能性があります。また、必須のパラメーターまたはデータ値が欠落している、あるいはリクエストが API のバージョンが欠落しているか無効であることを示している場合の結果である可能性もあります。**X-XBL-Contract-Version** ヘッダーを参照してください。 |
\| 401| Unauthorized | リクエストにユーザー認証が必要です。|
\| 403| Forbidden | このリクエストはユーザーまたはサービスに対して許可されていません。|
\| 404| Not Found | 呼び出し元にリソースへのアクセス権がありません。これは、そのようなリストが作成されていないことを示します。|
\| 412| Precondition Failed | リストのバージョンが変更されたため、変更リクエストが失敗したことを示します。変更リクエストとは、挿入、更新、または削除のことです。サービスは **If-Match** ヘッダーでリスト バージョンをチェックします。リストの現在のバージョンと一致しない場合、操作は失敗し、これが現在のリスト メタデータ (現在のバージョンを含む) と共に返されます。 |
\| 500| Internal Server Error | サーバー側のエラーにより、サービスはリクエストを拒否しています。|
\| 501| Not Implemented | 呼び出し元がサーバー上で実装されていない URI を要求しました。(現時点では、許可リストにないリスト名に対してリクエストが行われた場合にのみ使用されます。)|
\| 503| Service Unavailable | 通常は過剰な負荷のため、サーバーがリクエストを拒否しています。遅延の後 (**Retry-after** ヘッダーを参照)、リクエストを再試行できます。 |

## 必須リクエスト ヘッダー

\| ヘッダー| 説明|
\| --- | --- | --- | --- | --- | --- | --- | --- |
\| Authorization| リクエストの認証と承認に使用される STS トークンが含まれます。XSTS サービスからのトークンで、要求の 1 つとして XUID を含んでいる必要があります。 |
\| X-XBL-Contract-Version| 要求されている API バージョンを指定します (正の整数)。Pins はバージョン 2 をサポートしています。このヘッダーが欠落しているか、値がサポートされていない場合、サービスはステータスの説明に "Unsupported or missing contract version header" を含む 400 - Bad request を返します。 |
\| Content-Type| リクエスト/応答本文のコンテンツが json または xml のどちらであるかを指定します。サポートされている値は "application/json" と "application/xml" です。|
\| If-Match| このヘッダーは、変更リクエストを行うときにリストの現在のバージョン番号を含んでいる必要があります。変更リクエストは PUT、POST、または DELETE 動詞を使用します。"If-Match" ヘッダーのバージョンがリストの現在のバージョンと一致しない場合、リクエストは HTTP 412 - precondition failed の戻りコードで拒否されます。(省略可能) GET でも使用可能で、指定されている場合、渡されたバージョンが現在のリスト バージョンと一致すれば、リスト データなしで HTTP 304 - Not Modified コードが返されます。 |

## 応答本文

呼び出しが成功した場合、サービスはリストの最新のメタデータを返します。

### サンプル応答

```cpp theme={null}
{
        "ListVersion":  1,
        "ListCount":  1,
        "MaxListSize": 200,
        "AllowDuplicates": "true",
        "AccessSetting":  "OwnerOnly"
        }

      
```

## 関連項目

##### 親

[Universal Resource Identifier (URI) リファレンス](https://docs.xbox.com/ja-jp/reference/live/rest/uri/atoc-xboxlivews-reference-uris.md)


## Related topics

- [/users/xuid(xuid)/lists/PINS/{listname}/RemoveItems](https://docs.xbox.com/ja-jp/reference/live/rest/uri/lists/uri-usersxuidlistspinslistnameremoveitems.md)
- [DELETE /users/xuid(xuid)/lists/PINS/{listname}/RemoveItems](https://docs.xbox.com/ja-jp/reference/live/rest/uri/lists/uri-usersxuidlistspinslistnameremoveitemsdelete.md)
- [POST /users/xuid(xuid)/lists/PINS/{listname}/ContainsItems](https://docs.xbox.com/ja-jp/reference/live/rest/uri/lists/uri-usersxuidlistspinslistnamecontainsitemspost.md)
- [POST (/users/xuid(xuid)/lists/PINS/{listname})](https://docs.xbox.com/ja-jp/reference/live/rest/uri/lists/uri-usersxuidlistspinslistnamepost.md)
- [/users/xuid(xuid)/lists/PINS/{listname}/ContainsItems](https://docs.xbox.com/ja-jp/reference/live/rest/uri/lists/uri-usersxuidlistspinslistnamecontainsitems.md)