Skip to main content

Comparing X API’s mutes endpoints

Mutes lookup

The v2 mutes lookup endpoint will replace the standard v1.1 GET mutes/users/ids and GET mutes/users/list endpoints. The following tables compare the standard v1.1 and X API v2 mute endpoints:  
DescriptionStandard v1.1X API v2
HTTP methods supportedGETGET
Host domainhttps://api.x.comhttps://api.x.com
Endpoint path/1.1/mutes/users/ids.json

/1.1/mutes/users/list.json
/2/users/:id/muting
AuthenticationOAuth 1.0a User ContextOAuth 1.0a User Context

OAuth 2.0 Authorization Code with PKCE
Default request rate limits15 requests per 15 min (per user)15 requests per 15 min (per user)
Data formatsStandard v1.1 formatX API v2 format (determined by fields and expansions request parameters, not backward-compatible with v1.1 formats)

To learn more about how to migrate from the Standard v1.1 format to the X API v2 format, please visit our data formats migration guide.
Requires use of credentials from a developer App that is associated with a Project✔️

Manage mutes

The v2 manage mutes endpoints will replace the standard v1.1 POST mutes/users/create and POST mutes/users/destroy endpoints. The following tables compare the standard v1.1 and X API v2 mute endpoints: Mute a user
DescriptionStandard v1.1X API v2
HTTP methods supportedPOSTPOST
Host domainhttps://api.x.comhttps://api.x.com
Endpoint path/1.1/mutes/users/create.json/2/users/:id/muting
AuthenticationOAuth 1.0a User ContextOAuth 1.0a User Context

OAuth 2.0 Authorization Code with PKCE
Default request rate limits50 requests per 15 min50 requests per 15 min
Requires use of credentials from a developer App that is associated with a Project✔️
Unmute a user The following tables compare the standard v1.1 and X API v2 unmute endpoints:
DescriptionStandard v1.1X API v2
HTTP methods supportedPOSTDELETE
Host domainhttps://api.x.comhttps://api.x.com
Endpoint path/1.1/mutes/users/destroy.json/2/users/:source_user_id/muting/:target_user_id
AuthenticationOAuth 1.0a User ContextOAuth 1.0a User Context

OAuth 2.0 Authorization Code with PKCE
Default request rate limits50 requests per 15 min50 requests per 15 min
Requires use of credentials from a developer App that is associated with a Project✔️
Other migration resources Manage mutes: Standard v1.1 to X API v2 X API migration hub