X API v2 でダイレクトメッセージのブロックを管理する

manage DM blocks エンドポイントを使用すると、認証済みユーザーの代理で指定したアカウントをブロックまたはブロック解除できます。これらのエンドポイントには、次の 2 つの POST メソッドが用意されています。

ユーザーの代理でリクエストを行うため、これらのエンドポイントは OAuth 1.0a User Context または OAuth 2.0 Authorization Code with PKCE のいずれかで認証し、リクエスト対象のユーザーに紐づく user Access Token を利用する必要があります。この user Access Token は、3-legged OAuth flow（OAuth 1.0a）または Authorization Code with PKCE grant flow（OAuth 2.0）を使用して生成できます。

Block ユーザーがアプリで認証を完了したら、以下のようにユーザーの代理で Block エンドポイントを呼び出すことができます。

curl --request POST 'https://api.x.com/2/users/:id/dm/block' --header 'Authorization: ••••••'

リクエストが成功すると、以下のような JSON レスポンスが返されます。

{
   "data": {
       "blocked": true
   }
}

Unblock ユーザーがアプリで認証を完了したら、以下のようにユーザーの代理で Unblock エンドポイントを呼び出すことができます。

curl --request POST 'https://api.x.com/2/users/:id/dm/unblock' --header 'Authorization: ••••••'

リクエストが成功すると、以下のような JSON レスポンスが返されます。

{
   "data": {
       "blocked": false
   }
}