Please note

We recently released manage Lists, a Twitter API v2 endpoint that has similar functionality to this one. The new version is currently in development and serves adequate access for the majority of developers on our platform. While elevated levels of access are coming soon, developers in need of higher levels of access should continue to use this endpoint along with the Twitter API v2 version.

POST lists/members/destroy

Removes the specified member from the list. The authenticated user must be the list's owner to remove members from the list.

Resource URL

https://api.twitter.com/1.1/lists/members/destroy.json

Resource Information

Response formats JSON
Requires authentication? Yes
Rate limited? Yes

Parameters

Name Required Description Default Value Example
list_id optional The numerical id of the list.
slug optional You can identify a list by its slug instead of its numerical id. If you decide to do so, note that you'll also have to specify the list owner using the owner_id or owner_screen_name parameters.
user_id optional The ID of the user to remove from the list. Helpful for disambiguating when a valid user ID is also a valid screen name.
screen_name optional The screen name of the user for whom to remove from the list. Helpful for disambiguating when a valid screen name is also a user ID.
owner_screen_name optional The screen name of the user who owns the list being requested by a slug .
owner_id optional The user ID of the user who owns the list being requested by a slug .

Example Request

POST https://api.twitter.com/1.1/lists/members/destroy?screen_name=episod&slug=cool_people&owner_screen_name=twitter

Example Response