> ## 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.

# Deleting a Tag From All Subscribers

> This endpoint deletes tags from all subscribers with the tag.

<Warning>
  After the endpoint is called, please allow up to 10 minutes for the tags provided to be removed from all subscribers.
</Warning>

## Request URL

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


## OpenAPI

````yaml DELETE /api/v2/lists/{ID}/tags
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}/tags:
    delete:
      tags:
        - Tags
      summary: Deleting a Tag From All Subscribers
      description: >-
        This endpoint deletes tags from all subscribers with the tag. After the
        endpoint is called, please allow up to 10 minutes for the tags provided
        to be removed from all subscribers.
      parameters:
        - name: ID
          in: path
          description: ID of the list
          required: true
          schema:
            type: integer
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                tags:
                  type: array
                  items:
                    type: string
                  description: An array of tag names
              required:
                - tags
            example:
              tags:
                - vip
                - customer
                - newsletter
      responses:
        '200':
          description: Tags enqueued for deletion
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: Tags enqueued for deletion
                required:
                  - status
              example:
                status: Tags enqueued for deletion
      x-codeSamples:
        - lang: cURL
          label: cURL
          source: >-
            curl "https://app.tatango.com/api/v2/lists/ID/tags" -d
            '{"tags":["vip","customer"]}' -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/tags')
            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")
            request.body = {"tags":["vip","customer"]}.to_json
            response = http.request(request)
        - lang: JavaScript
          label: JavaScript
          source: >-
            var request = new XMLHttpRequest();

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

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

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

            var data = JSON.stringify({ tags: ['vip', 'customer'] });

            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.

````