Manage Mutes

This guide walks you through muting and unmuting users using the X API.

PrerequisitesBefore you begin, you’ll need:

A developer account with an approved App
User Access Token (OAuth 1.0a or OAuth 2.0 PKCE)

Mute a user

Get your user ID

You need your authenticated user’s ID. You can find it using the user lookup endpoint or from your Access Token (the numeric part is your user ID).

Get the target user ID

Find the user ID of the account you want to mute using the user lookup endpoint.

Send the mute request

cURL

curl -X POST "https://api.x.com/2/users/123456789/muting" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"target_user_id": "9876543210"}'

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)

# Mute a user
response = client.users.mute(
    source_user_id="123456789",
    target_user_id="9876543210"
)

print(f"Muting: {response.data.muting}")

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 });

// Mute a user
const response = await client.users.mute("123456789", {
  targetUserId: "9876543210",
});

console.log(`Muting: ${response.data?.muting}`);

Review the response

{
  "data": {
    "muting": true
  }
}

Unmute a user

Remove a mute from a user:

cURL

curl -X DELETE "https://api.x.com/2/users/123456789/muting/9876543210" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

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)

# Unmute a user
response = client.users.unmute(
    source_user_id="123456789",
    target_user_id="9876543210"
)

print(f"Muting: {response.data.muting}")

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 });

// Unmute a user
const response = await client.users.unmute("123456789", "9876543210");

console.log(`Muting: ${response.data?.muting}`);

Response:

{
  "data": {
    "muting": false
  }
}

Mute vs Block

Feature	Mute	Block
See their Posts	No	No
They see your Posts	Yes	No
They can follow you	Yes	No
They can DM you	Yes	No
They know	No	Yes

Next steps

Mutes lookup

Get your muted users

Blocks

Block users instead

API Reference

Full endpoint documentation

Mutes

Mutes Lookup

​Mute a user

​Unmute a user

​Mute vs Block

​Next steps

Mutes lookup

Blocks

API Reference

Mute a user

Unmute a user

Mute vs Block

Next steps