# Tag von Unternehmen entfernen (https://webmetic.de/docs/api/referenz/company-tags/company-tags-delete)

## DELETE /company-tags

Nimmt den Tag von den Unternehmen hinter den Domains, auf allen Websites des Kontos.
Der Tag selbst bleibt bestehen; löschen lässt er sich im Dashboard.

### Anfrage

`application/json`

| Feld | Typ | Pflicht | Beschreibung |
| --- | --- | --- | --- |
| `tag` | string | ja | Name des Tags, z. B. 'Zielkunde'. Groß- und Kleinschreibung zählt nicht; ein neuer Name legt den Tag an (nur POST). |
| `domains` | string[] | ja | 1 bis 10.000 Domains oder URLs der Unternehmen, z. B. 'acme.de'. |

### Antworten

| Status | Beschreibung |
| --- | --- |
| 200 | Entfernt |
| 400 | NO_WEBSITE: im Konto ist keine Website eingetragen |
| 403 | API_KEY_MISSING, API_KEY_INVALID oder API_KEY_NOT_FOUND |
| 404 | TAG_NOT_FOUND: kein Tag mit diesem Namen im Konto |
| 422 | VALIDATION_ERROR: tag oder domains fehlt oder ist ungültig (höchstens 10.000 Domains) |
| 500 | INTERNAL_ERROR: unerwarteter Serverfehler |

Felder der Antwort 200:

| Feld | Typ | Pflicht | Beschreibung |
| --- | --- | --- | --- |
| `untagged` | integer | ja | Domains, deren Unternehmen den Tag jetzt nicht mehr trägt; auch wenn es ihn nie hatte |
| `unknown` | string[] | ja | Eingaben ohne Unternehmen im Register, unverändert zurückgegeben |

### Beispiel

```bash
curl -X DELETE 'https://hub.webmetic.de/company-tags' \
  -H 'Authorization: wmtc_IHR_API_SCHLUESSEL' \
  -H 'Content-Type: application/json' \
  -d '{"tag":"Zielkunde","domains":["bergquell.example"]}'
```