POST lists/update
POST lists/update
Updates the specified list. The authenticated user must own the list to be able to update it.
Resource URL¶
https://api.x.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.x.com/1.1/lists/update.json?list_id=1234&mode=public&name=Party%20Time