POST lists/members/destroy
post-lists-members-destroy

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.x.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.x.com/1.1/lists/members/destroy?screen_name=episod&slug=cool_people&owner_screen_name=twitter

Example Response