Migrate
Comparing X API’s Lists endpoints
The v2 manage Lists endpoints will eventually replace POST lists/create, POST lists/destroy, and POST lists/update. If you have code, apps, or tools that use an older version of these endpoints and are considering migrating to the newer X API v2, then this guide is for you.
The following tables compare the standard v1.1 and X API v2 List endpoints:
Create a List
| Description | Standard v1.1 | X API v2 |
|---|---|---|
| HTTP methods supported | POST | POST |
| Host domain | https://api.x.com | https://api.x.com |
| Endpoint path | /1.1/lists/create.json | /2/lists |
| Authentication | OAuth 1.0a User Context | OAuth 1.0a User Context |
| Default request rate limits | None | 300 requests per 15 min (per user) |
Delete a List
| Description | Standard v1.1 | X API v2 |
|---|---|---|
| HTTP methods supported | POST | DELETE |
| Host domain | https://api.x.com | https://api.x.com |
| Endpoint path | /1.1/lists/destroy.json | /2/lists/:id |
| Authentication | OAuth 1.0a User Context | OAuth 1.0a User Context |
| Default request rate limits | None | 300 requests per 15 min (per user) |
Update a List
| Description | Standard v1.1 | X API v2 |
|---|---|---|
| HTTP methods supported | POST | PUT |
| Host domain | https://api.x.com | https://api.x.com |
| Endpoint path | /1.1/lists/update.json | /2/lists/:id |
| Authentication | OAuth 1.0a User Context | OAuth 1.0a User Context |
| Default request rate limits | None | 300 requests per 15 min (per user) |
To access the X API v2 endpoints, you must sign up for a developer account. When authenticating, you must use keys and tokens from a developer App that is located within a Project.
Learn more about getting access to the X API v2 endpoints in our getting started page.
