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

> Supprimez un libellé de Topic 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 Topic.

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.

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.

**keywordId** `string` *required*

Identifiant du Topic dans ce workspace.

## Réponse

Renvoie `200` avec `deleted: true` et `topicId`. 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 Topic](https://docs.qwairy.co/fr/developers/endpoints/keywords/get.md). Cet exemple suppose `"4"`.

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

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

## Erreurs

| Statut | Code | Cause |
| - | - | - |
| 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.