# Supprimer un tag

> Supprime un tag par sa cle (l' id retourne par GET /v2/api/tags ). Le tag est supprime de maniere logique (soft delete) : il n'apparait plus dans la liste et…

`DELETE /v2/api/tags/{id}`

<Note>
**Scope requis :** `TAGS_WRITE`
</Note>

## Comportement

Supprime un tag par sa **cle** (l'`id` retourne par `GET /v2/api/tags`). Le tag est supprime de maniere logique (soft delete) : il n'apparait plus dans la liste et ne peut plus etre applique aux appels, tandis que l'historique de tagging des appels est conserve.

- Supprimer un tag qui n'existe pas retourne une erreur `404` avec le code `TAG_NOT_FOUND`.
- Les tags synchronises depuis une integration CRM ne peuvent pas etre supprimes via l'API et retournent une erreur `409` avec le code `CRM_SYNCED_TAG_READONLY`. Gerez-les depuis le CRM connecte.

## Idempotence

Cet endpoint prend en charge l'en-tete `Idempotency-Key`. Si une requete reussit et que vous la renvoyez avec la meme cle, la reponse stockee est retournee sans re-executer l'operation. Voir [Idempotence](/fr/docs/guides/error-handling#idempotency).
