Create and manage lists
API Reference contents
GET lists/list
GET lists/members
GET lists/members/show
GET lists/memberships
GET lists/ownerships
GET lists/show
GET lists/statuses
GET lists/subscribers
GET lists/subscribers/show
GET lists/subscriptions
POST lists/create
POST lists/destroy
POST lists/members/create
POST lists/members/create_all
POST lists/members/destroy
POST lists/members/destroy_all
POST lists/subscribers/create
POST lists/subscribers/destroy
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.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