> ## 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 tags from a Subscriber

> This endpoint deletes multiple tags from a subscriber.

<Note>
  This endpoint allows you to remove multiple tags from a subscriber in a single request. Tags that don't exist on the subscriber will be reported in the response but won't cause the request to fail.
</Note>

## Request URL

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


## OpenAPI

````yaml DELETE /api/v2/lists/{ID}/subscribers/{PHONE_NUMBER}/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}/subscribers/{PHONE_NUMBER}/tags:
    delete:
      tags:
        - Subscribers
      summary: Deleting tags from a Subscriber
      description: This endpoint deletes multiple tags from a subscriber.
      parameters:
        - name: ID
          in: path
          description: ID of the list
          required: true
          schema:
            type: integer
        - name: PHONE_NUMBER
          in: path
          description: Subscriber's phone number with no special characters
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                tags:
                  type: array
                  example:
                    - vip
                    - customer
                    - newsletter
                  items:
                    type: string
                  description: All tags that will be deleted
              required:
                - tags
            example:
              tags:
                - vip
                - customer
                - newsletter
      responses:
        '200':
          description: Tags deletion completed
          content:
            application/json:
              schema:
                type: object
                properties:
                  deleted:
                    type: array
                    items:
                      type: string
                    description: the tags that were found and deleted from the subscriber
                  not_found:
                    type: array
                    items:
                      type: string
                    description: the tags that were not found for the subscriber
                  status:
                    type: string
                    description: >-
                      "OK" if the request was processed successfully or "ERROR"
                      if there was an error processing the request
                  message:
                    type: string
                    description: >-
                      A message explaining if the request was successful (all
                      tags deleted) or partially successful (some tags were not
                      found)
                required:
                  - deleted
                  - not_found
                  - status
                  - message
              example:
                status: OK
                deleted:
                  - local_news
                  - sports_news
                not_found:
                  - celebrity_news
                  - weather_news
                message: Tag removal completed with partial success.
      x-codeSamples:
        - lang: cURL
          label: cURL
          source: >-
            curl
            "https://app.tatango.com/api/v2/lists/<ID>/subscribers/<PHONE_NUMBER>/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>/subscribers/<PHONE_NUMBER>/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>/subscribers/<PHONE_NUMBER>/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.

````