ピン留めされたリストを管理する

リストをピン留めおよびピン留め解除する

このガイドでは、リストをピン留めおよびピン留め解除する方法を順を追って説明します。

前提条件

始める前に、次のものが必要です:

• 承認済みの App を持つ 開発者アカウント
• User Access Token (OAuth 1.0a または OAuth 2.0 PKCE)

---

​

リストをピン留めする

1. ユーザーIDとリストIDを取得する

   認証済みユーザーのIDと、ピン留めしたいリストのIDが必要です。リストを表示しているときのURLから、そのリストのIDを確認できます。

2. リストをピン留めする

   cURL

   shellscript

   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"}'
   
3. レスポンスを確認する

   {
     "data": {
       "pinned": true
     }
   }
   

---

​

リストのピン留めを外す

cURL

shellscript

curl -X DELETE "https://api.x.com/2/users/2244994945/pinned_lists/1454155907651158017" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

レスポンス:

{
  "data": {
    "pinned": false
  }
}

---

​

重要な注意事項

• ピン留めできるのは、フォローしているか自分が所有しているリストのみです
• ピン留めされたリストは、Xアプリのリストの一番上に表示されます
• ピン留めできるリストの数には上限があります

---

​

次のステップ

ピン留めしたリストの取得

自分のピン留めしたリストを取得する

リストの取得

リストの詳細を取得する

APIリファレンス

エンドポイントの詳細なドキュメント