POST lists/update

Updates the specified list. The authenticated user must own the list to be able to update it.

Resource URL

https://api.twitter.com/1.1/lists/update.json

Resource Information

Response formats JSON
Requires authentication? Yes
Rate limited? Yes

Parameters

Name Required Description Default Value Example
list_id required The numerical id of the list.
slug required 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.
name optional The name for the list.
mode optional Whether your list is public or private. Values can be public or private . If no mode is specified the list will be public.
description optional The description to give the list.
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/update.json?list_id=1234&mode=public&name=Party%20Time

Example Response

Was this document helpful?

Thank you

Thank you for the feedback. We’re really glad we could help!

Thank you for the feedback. How could we improve this document?

Thank you for the feedback. Your comments will help us improve our documents in the future.