クイックスタート

リストを作成、更新、削除する

このガイドでは、リストの作成、更新、削除の方法を順を追って説明します。

前提条件

開始する前に、次のものが必要です。

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

---

​

リストを作成する

1. リクエストを準備する

   リスト名 (必須) と、任意の説明およびプライバシー設定を指定します:

   {
     "name": "Tech News",
     "description": "Top tech journalists and publications",
     "private": false
   }
   
2. リクエストを送信する

   cURL

   shellscript

   curl -X POST "https://api.x.com/2/lists" \
     -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
       "name": "Tech News",
       "description": "Top tech journalists and publications",
       "private": false
     }'
   
3. レスポンスを確認する

   {
     "data": {
       "id": "1441162269824405510",
       "name": "Tech News"
     }
   }
   

   後でリストを更新または削除できるように、id を保存しておいてください。

---

​

リストを更新する

リストの名前、説明、またはプライバシー設定を変更します。

cURL

shellscript

curl -X PUT "https://api.x.com/2/lists/1441162269824405510" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Tech News & Insights",
    "description": "Updated description"
  }'

レスポンス:

{
  "data": {
    "updated": true
  }
}

---

​

リストを削除する

1. リスト ID を取得する

   削除するリストの ID が必要です。

2. 削除リクエストを送信する

   cURL

   shellscript

   curl -X DELETE "https://api.x.com/2/lists/1441162269824405510" \
     -H "Authorization: Bearer $USER_ACCESS_TOKEN"
   
3. 削除を確認する

   {
     "data": {
       "deleted": true
     }
   }
   

削除できるのは、自分が所有しているリストのみです。

---

​

次のステップ

リストメンバー

リストメンバーの追加と削除

リストの検索

リストの詳細を取得

統合ガイド

主要な概念とベストプラクティス

APIリファレンス

エンドポイントに関する詳細ドキュメント