> ## Documentation Index
> Fetch the complete documentation index at: https://platform.tatango.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Destroying a List

> This endpoint destroys a list.

## Request URL

```http theme={null}
DELETE https://app.tatango.com/api/v2/lists/<ID>
```


## OpenAPI

````yaml DELETE /api/v2/lists/{ID}
openapi: 3.1.0
info:
  title: Tatango Legacy v2 API
  description: Tatango legacy v2 API endpoints for existing integrations.
  version: 2.0.0
servers:
  - url: https://app.tatango.com
security:
  - basicAuth: []
paths:
  /api/v2/lists/{ID}:
    delete:
      tags:
        - Lists
      summary: Destroy a List
      description: This endpoint destroys a list.
      responses:
        '200':
          description: List destroyed
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: List Destroyed
                required:
                  - status
              example:
                status: List Destroyed
      x-codeSamples:
        - lang: cURL
          label: cURL
          source: |-
            curl "https://app.tatango.com/api/v2/lists/ID" -d '' -X DELETE 
              -H "Accept: application/json" 
              -H "Content-Type: application/json" 
              -u emailaddress@mydomain.com:my_api_key 
              -H "Host: example.org" 
              -H "Cookie: "
        - lang: Ruby
          label: Ruby
          source: |-
            require 'net/http'
            require 'uri'

            uri = URI.parse('https://app.tatango.com/api/v2/lists/ID')
            http = Net::HTTP.new(uri.host, uri.port)
            request = Net::HTTP::Delete.new(uri.request_url)
            request.basic_auth("emailaddress@mydomain.com", "my_api_key")
            response = http.request(request)
        - lang: JavaScript
          label: JavaScript
          source: >-
            var request = new XMLHttpRequest();

            request.open('DELETE', 'https://app.tatango.com/api/v2/lists/ID',
            false);

            request.setRequestHeader('Content-Type', 'application/json');

            request.setRequestHeader('Content-Type', 'application/json');

            request.setRequestHeader('Authorization', 'Basic ' +
            btoa('emailaddress@mydomain.com:my_api_key'));

            var data = JSON.stringify({ list: { name: 'My awesome list' } });

            request.send(data);
components:
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: >-
        Tatango authenticates API requests by validating an API key passed via
        HTTP Basic Authentication. Use your login email as the username and your
        API key as the password.

````