> ## Documentation Index
> Fetch the complete documentation index at: https://docs.x.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Manage Pinned Lists
> X API v2 の pinned Lists エンドポイントを利用して、認証済みユーザーのアカウントで X の List のピン留めおよびピン留め解除を行うクイックスタート。リクエスト例を含みます。
export const Button = ({href, children}) => {
return ;
};
このガイドでは、List のピン留めおよびピン留め解除の手順を説明します。
**前提条件**
始める前に、以下が必要です:
* 承認済みの App がある [developer account](https://developer.x.com/en/portal/petition/essential/basic-info)
* ユーザー Access Token (OAuth 1.0a または OAuth 2.0 PKCE)
***
## List をピン留め
認証済みユーザーの ID と、ピン留めしたい List の ID が必要です。List ID は List 表示時の URL で確認できます。
```bash cURL theme={null}
curl -X POST "https://api.x.com/2/users/2244994945/pinned_lists" \
-H "Authorization: Bearer $USER_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"list_id": "1454155907651158017"}'
```
```python title="Python SDK" lines wrap icon="python" theme={null}
from xdk import Client
from xdk.oauth1_auth import OAuth1
oauth1 = OAuth1(
api_key="YOUR_API_KEY",
api_secret="YOUR_API_SECRET",
access_token="YOUR_ACCESS_TOKEN",
access_token_secret="YOUR_ACCESS_TOKEN_SECRET"
)
client = Client(auth=oauth1)
# List をピン留め
response = client.lists.pin(
user_id="2244994945",
list_id="1454155907651158017"
)
print(f"Pinned: {response.data.pinned}")
```
```javascript title="JavaScript SDK" lines wrap icon="square-js" theme={null}
import { Client, OAuth1 } from "@xdevplatform/xdk";
const oauth1 = new OAuth1({
apiKey: "YOUR_API_KEY",
apiSecret: "YOUR_API_SECRET",
accessToken: "YOUR_ACCESS_TOKEN",
accessTokenSecret: "YOUR_ACCESS_TOKEN_SECRET",
});
const client = new Client({ oauth1 });
// List をピン留め
const response = await client.lists.pin("2244994945", {
listId: "1454155907651158017",
});
console.log(`Pinned: ${response.data?.pinned}`);
```
```json theme={null}
{
"data": {
"pinned": true
}
}
```
***
## List のピン留めを解除
```bash cURL theme={null}
curl -X DELETE "https://api.x.com/2/users/2244994945/pinned_lists/1454155907651158017" \
-H "Authorization: Bearer $USER_ACCESS_TOKEN"
```
```python title="Python SDK" lines wrap icon="python" theme={null}
from xdk import Client
from xdk.oauth1_auth import OAuth1
oauth1 = OAuth1(
api_key="YOUR_API_KEY",
api_secret="YOUR_API_SECRET",
access_token="YOUR_ACCESS_TOKEN",
access_token_secret="YOUR_ACCESS_TOKEN_SECRET"
)
client = Client(auth=oauth1)
# List のピン留めを解除
response = client.lists.unpin(
user_id="2244994945",
list_id="1454155907651158017"
)
print(f"Pinned: {response.data.pinned}")
```
```javascript title="JavaScript SDK" lines wrap icon="square-js" theme={null}
import { Client, OAuth1 } from "@xdevplatform/xdk";
const oauth1 = new OAuth1({
apiKey: "YOUR_API_KEY",
apiSecret: "YOUR_API_SECRET",
accessToken: "YOUR_ACCESS_TOKEN",
accessTokenSecret: "YOUR_ACCESS_TOKEN_SECRET",
});
const client = new Client({ oauth1 });
// List のピン留めを解除
const response = await client.lists.unpin("2244994945", "1454155907651158017");
console.log(`Pinned: ${response.data?.pinned}`);
```
**レスポンス:**
```json theme={null}
{
"data": {
"pinned": false
}
}
```
***
## 重要なポイント
* ピン留めできるのは、フォローしているか自分が所有する List に限られます
* ピン留めした List は X アプリの List の最上部に表示されます
* ピン留めできる List の数には上限があります
***
## 次のステップ
ピン留めした List を取得
List の詳細を取得
エンドポイントの詳細ドキュメント