Overview

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.

​Comparing X API’s Lists endpoints

Comparing X API’s Lists endpoints