La suppression d'un tag dans Zoho Desk peut s'effectuer à deux niveaux : retirer un tag d'un ticket spécifique, ou supprimer définitivement le tag lui-même de votre portail via l'API.
Pourquoi c'est important
Les tags dans Zoho Desk permettent de catégoriser et de filtrer les tickets d'assistance, mais avec le temps, votre bibliothèque de tags peut se retrouver encombrée d'étiquettes obsolètes ou en double. Savoir comment retirer un tag d'un seul ticket — par opposition à la suppression totale du tag dans le système — permet de garder votre espace de travail propre et vos rapports précis. Cela est particulièrement pertinent pour les équipes gérant de grands volumes de tickets ou exécutant des workflows automatisés qui dépendent d'un balisage cohérent.
Étape par étape
Étape 1. Déterminez l'opération dont vous avez besoin.
Deux actions distinctes sont disponibles via l'API Zoho Desk. La première retire l'association d'un tag à un ticket sans supprimer le tag globalement. La seconde supprime définitivement le tag de votre portail. Choisissez le bon endpoint avant de continuer afin d'éviter toute perte de données involontaire. [1][2]
Étape 2. Rassemblez les identifiants requis.
Pour l'une ou l'autre opération, vous aurez besoin du tagId du tag sur lequel vous souhaitez agir. Si vous retirez un tag d'un ticket spécifique, vous aurez également besoin du ticketId de ce ticket. Vous pouvez récupérer ces identifiants en interrogeant vos tags ou tickets via l'API Zoho Desk avant d'effectuer tout appel destructif. [1][2]
Étape 3. Pour retirer un tag d'un seul ticket, appelez l'endpoint de suppression de tag de ticket.
Envoyez une requête DELETE vers /api/v1/tickets/{ticketId}/tags/{tagId}, en remplaçant les identifiants réels du ticket et du tag. Cela dissocie uniquement le tag de ce ticket — le tag continue d'exister dans votre portail et peut toujours être appliqué ailleurs. [2]
DELETE /api/v1/tickets/{ticketId}/tags/{tagId}En Python, l'appel équivalent ressemble à :
desk_api.remove_tags_from_ticket(ticketId="12345", tagId="67890")Étape 4. Pour supprimer définitivement un tag du portail, appelez l'endpoint de suppression de tag.
Envoyez une requête DELETE vers /api/v1/tags/{tagId} avec le tagId concerné. Cette opération supprime entièrement le tag de Zoho Desk — il n'apparaîtra plus dans aucun ticket, filtre ou rapport. [1]
DELETE /api/v1/tags/{tagId}En Python :
desk_api.delete_tag(tagId="67890")Étape 5. Vérifiez que vos scopes OAuth incluent les permissions nécessaires.
Les deux opérations requièrent que votre token OAuth Zoho Desk connecté dispose du scope approprié. Le scope Desk.settings.DELETE couvre la suppression des tags au niveau du portail, tandis que Desk.tickets.DELETE couvre la suppression des tags au niveau du ticket. Si votre token ne dispose pas de l'un ou l'autre de ces scopes, l'API retournera une erreur d'authentification ou d'autorisation. [4]
Étape 6. Gérez la réponse de l'API.
Une suppression réussie retournera une réponse HTTP 200 ou 204 sans corps ou avec un payload de confirmation minimal. Si vous recevez un statut 401, vos identifiants OAuth doivent être actualisés ou reconnectés. Tout message d'erreur faisant référence à un identifiant invalide signifie que le tagId ou le ticketId fourni n'existe pas dans votre portail. [6]
Erreurs courantes
- Confondre les deux endpoints. Utiliser la suppression au niveau du portail (
/api/v1/tags/{tagId}) alors que vous souhaitiez uniquement dissocier un tag d'un ticket supprimera définitivement ce tag partout. Vérifiez toujours quel endpoint vous appelez. [1][2] - Scopes OAuth manquants. Si votre intégration a été configurée sans
Desk.settings.DELETEouDesk.tickets.DELETE, l'API rejettera la requête. Vérifiez la configuration de vos scopes et réautorisez si nécessaire. [4] - Identifiants invalides ou obsolètes. Les identifiants de tags et de tickets peuvent changer ou être supprimés par d'autres processus. Récupérez les identifiants actuels immédiatement avant la suppression plutôt que de vous fier à des valeurs en cache. [1][2]
- Erreurs d'authentification. Une réponse
401signifie que le token a expiré ou que la connexion doit être rétablie — ce n'est pas un problème lié à l'identifiant du tag lui-même. [6]
Ce qu'il faut vérifier
- Vérifiez que le
tagIdque vous transmettez existe bien dans votre portail Zoho Desk avant d'appeler l'un ou l'autre endpoint de suppression. [1] - Confirmez que votre token OAuth inclut
Desk.settings.DELETE(pour la suppression à l'échelle du portail) ouDesk.tickets.DELETE(pour la suppression au niveau du ticket) dans ses scopes actifs. [4] - Une fois l'appel terminé, interrogez le ticket ou la liste de tags concernés pour confirmer que le tag n'apparaît plus comme prévu. [2]
---
*Beam Help fournit une assistance experte indépendante pour les produits Zoho et ne constitue pas le support officiel de Zoho. Testez toujours les opérations destructives de l'API dans un environnement sandbox avant de les exécuter sur des données de production.*