> ## Documentation Index
> Fetch the complete documentation index at: https://x-preview-mintlify-04d20e4e.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage Lists migration overview

> Move List creation, updates, and deletion from Standard v1.1 lists endpoints to the X API v2 manage Lists endpoints with mapped parameters and limits.

export const Button = ({href, children}) => {
  return <div className="not-prose group">
    <a href={href}>
      <button className="flex items-center space-x-2.5 py-1 px-4 bg-primary-dark dark:bg-white text-white dark:text-gray-950 rounded-full group-hover:opacity-[0.9] font-medium">
        <span>
          {children}
        </span>
        <svg width="3" height="24" viewBox="0 -9 3 24" class="h-6 rotate-0 overflow-visible"><path d="M0 0L3 3L0 6" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"></path></svg>
      </button>
    </a>
  </div>;
};

## Comparing X API’s Lists endpoints

The v2 manage Lists endpoints will eventually replace [POST lists/create](https://developer.x.com/en/docs/twitter-api/v1/accounts-and-users/create-manage-lists/api-reference/post-lists-create), [POST lists/destroy](https://developer.x.com/en/docs/twitter-api/v1/accounts-and-users/create-manage-lists/api-reference/post-lists-destroy), and [POST lists/update](https://developer.x.com/en/docs/twitter-api/v1/accounts-and-users/create-manage-lists/api-reference/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) | [https://api.x.com](https://api.x.com) |
| Endpoint path                                                      | /1.1/lists/create.json                 | /2/lists                               |
| [Authentication](/resources/fundamentals/authentication)           | OAuth 1.0a User Context                | OAuth 1.0a User Context                |
| Default request [rate limits](/resources/fundamentals/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) | [https://api.x.com](https://api.x.com) |
| Endpoint path                                                      | /1.1/lists/destroy.json                | /2/lists/:id                           |
| [Authentication](/resources/fundamentals/authentication)           | OAuth 1.0a User Context                | OAuth 1.0a User Context                |
| Default request [rate limits](/resources/fundamentals/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) | [https://api.x.com](https://api.x.com) |
| Endpoint path                                                      | /1.1/lists/update.json                 | /2/lists/:id                           |
| [Authentication](/resources/fundamentals/authentication)           | OAuth 1.0a User Context                | OAuth 1.0a User Context                |
| Default request [rate limits](/resources/fundamentals/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](https://developer.x.com/en/portal/petition/essential/basic-info). When authenticating, you must use keys and tokens from a [developer App](/resources/fundamentals/developer-apps) that is located within a [Project](/resources/fundamentals/developer-apps). 

Learn more about getting access to the X API v2 endpoints in our [getting started](/x-api/getting-started/getting-access) page.

<div className="flex space-x-2">
  <Button href="/x-api/lists/manage-lists/quickstart">
    Quick start
  </Button>

  <Button href="https://github.com/xdevplatform/Twitter-API-v2-sample-code">
    Sample code
  </Button>

  <Button href="https://www.postman.com/xapidevelopers/x-api-public-workspace/collection/34902927-2efc5689-99c6-4ab6-8091-996f35c2fd80">
    Run in Postman
  </Button>
</div>