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

# 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: 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}/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: >-
        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.

````