> ## Documentation Index
> Fetch the complete documentation index at: https://developers.momogood.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: momoGood Messaging API v2
  description: >-
    The platform management API for momoGood Messaging (formerly the Tatango v2
    API). Manage lists, subscribers, custom fields, tags, webhooks, shortcodes,
    MOMT reports, and scheduled broadcasts from a single REST surface.
  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.
      parameters:
        - name: ID
          in: path
          description: The ID of the list to destroy.
          required: true
          schema:
            type: integer
      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: >-
        The momoGood Messaging API v2 authenticates 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.

````