> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwairy.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Supprimer un Tag

> Supprimez un Tag avec l’ETag lu en dernier. Les prompts, les réponses et l’historique sont conservés, et les prompts sont détachés du Tag supprimé.

Supprime le libellé et le détache des prompts. Les prompts et leurs réponses conservées sont préservés. L’opération n’exige aucun corps de requête.

Vous ne pouvez pas supprimer les Tags système `Branded` et `Non-branded` : dans un workspace créé à partir de la v1.21, Qwairy pose lui-même ces deux Tags sur les prompts d’après leur texte.

Nécessite une offre Business, Agency Business ou Enterprise active. Utilisez un jeton d’API dont l’accès en écriture est activé. Consultez [Écrire des données](https://docs.qwairy.co/fr/developers/writing-data.md) pour l’idempotence, les requêtes conditionnelles et la gestion des erreurs.

**Authorization** `string` *required*

Jeton bearer de votre équipe.

**If-Match** `string` *required*

Copiez l’`ETag` complet du dernier GET, guillemets compris.

**brandId** `string` *required*

Identifiant du workspace. Le workspace doit appartenir à l’équipe du jeton.

**tagId** `string` *required*

Identifiant du Tag dans ce workspace.

## Réponse

Renvoie `200` avec `deleted: true` et `tagId`. Supprimer un libellé déjà absent dans un workspace accessible réussit aussi. Pour un libellé existant, un ETag périmé renvoie `412` sans le supprimer.

## Requête et réponse synthétiques

Utilisez l’ETag de [Obtenir un Tag](https://docs.qwairy.co/fr/developers/endpoints/tags/get.md). Cet exemple suppose `"4"`.

```bash theme={null}
curl -X DELETE "https://www.qwairy.co/api/v1/brands/$BRAND_ID/tags/$TAG_ID" \
  -H "Authorization: Bearer $QWAIRY_API_TOKEN" \
  -H 'If-Match: "4"'
```

```json theme={null}
{
  "deleted": true,
  "tagId": "22222222-0000-4000-8000-000000000000"
}
```

## Erreurs

| Statut | Code | Cause |
| - | - | - |
| 400 | `INVALID_REQUEST` | Le Tag est le Tag système `Branded` ou `Non-branded` |
| 404 | `RESOURCE_NOT_FOUND` | Workspace absent ou inaccessible |
| 412 | `PRECONDITION_FAILED` | Le libellé existant a changé depuis votre lecture |
| 428 | `PRECONDITION_REQUIRED` | `If-Match` est absent |

Consultez [Codes d’erreur](https://docs.qwairy.co/fr/developers/errors.md) pour les erreurs d’authentification, d’offre, d’idempotence et de serveur. Sur `429`, respectez `Retry-After` ; les écritures peuvent renvoyer `503 SERVICE_UNAVAILABLE` si le limiteur d’écriture est indisponible.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.