Skip to main content
PUT
Update List

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

FlowAuthorization Code
Authorization URL
https://api.x.com/2/oauth2/authorize
Token URL
https://api.x.com/2/oauth2/token
Scopes3
list.write
Create and manage Lists on your behalf.
users.read
View any account you can see, including protected accounts.
tweet.read
View all posts you can see, including those from protected accounts.

Path Parameters

id
string
required

Unique identifier of a List

Pattern: ^[0-9]{1,19}$
Example:

"1146654567674912769"

Body

application/json
description
string

New description for the List (up to 100 characters).

Maximum string length: 100
name
string

New name for the List (1-25 characters).

Required string length: 1 - 25
private
boolean

Whether the List is private.

Response

The request has succeeded.

data
object
errors
object[]