Comment supprimer une équipe dans Zoho Desk

La suppression d'une équipe dans Zoho Desk via l'API nécessite une seule requête DELETE authentifiée ciblant l'identifiant unique de l'équipe concernée. Voici tout ce que vous devez savoir pour le faire proprement et en toute sécurité.

Pourquoi c'est important

Les équipes dans Zoho Desk permettent d'acheminer les tickets et d'organiser les agents — mais avec le temps, des équipes redondantes ou restructurées peuvent encombrer votre configuration. Que vous automatisiez un script de nettoyage ou que vous construisiez un workflow d'administration, savoir comment supprimer une équipe par programmation est essentiel pour maintenir votre configuration Zoho Desk en ordre. Ce guide couvre l'approche API, qui est la méthode la plus fiable pour les suppressions en masse ou automatisées.

> Remarque : Beam Help est une ressource d'assistance experte indépendante — et non le support officiel de Zoho.

---

Étape par étape

Étape 1. Vérifiez que vos scopes OAuth sont en place.

Avant d'effectuer tout appel API destructif, vérifiez que votre client OAuth connecté inclut les autorisations Zoho Desk nécessaires. Les opérations au niveau des paramètres — y compris la gestion des équipes — requièrent que des scopes tels que Desk.settings.ALL ou au minimum Desk.settings.DELETE soient présents dans la configuration de votre token. ^[2]

Étape 2. Récupérez le team_id que vous souhaitez supprimer.

Vous aurez besoin de l'identifiant unique de l'équipe avant d'émettre la requête de suppression. Si vous ne l'avez pas déjà enregistré, utilisez une requête GET sur l'endpoint des équipes pour lister toutes les équipes et notez le team_id de celle que vous souhaitez supprimer. Gardez cette valeur à portée de main pour l'étape suivante.

Étape 3. Émettez la requête DELETE vers l'endpoint des équipes.

Envoyez un HTTP DELETE authentifié vers l'endpoint suivant, en substituant votre identifiant d'équipe réel à la place de {team_id} : ^[1]

DELETE /api/v1/teams/{team_id}

En Python, en utilisant le wrapper client Zoho Desk, cela ressemble à :

def delete_team(self, team_id: str, p: dict = None):
    return self.c.request("DELETE", f"/api/v1/teams/{team_id}", p, None)

Passez le team_id en tant qu'argument de type chaîne de caractères. Le paramètre optionnel p peut transporter des paramètres de requête supplémentaires si nécessaire. ^[1]

Étape 4. Gérez la réponse de l'API.

Une suppression réussie retournera un statut HTTP de succès approprié. Si la réponse indique une erreur — comme un 404 (équipe introuvable) ou un 403 (autorisations insuffisantes) — revenez aux étapes 1 et 2 pour confirmer la configuration des scopes et l'exactitude du team_id que vous avez fourni. [^1, ^2]

---

Erreurs courantes

• Mauvais endpoint pour les groupes vs. les équipes. Zoho Desk dispose d'un endpoint distinct pour supprimer les groupes du Help Center (DELETE /api/v1/helpcenter/{helpcenterid}/groups/{groupid}), qui est une ressource complètement différente d'une équipe. Assurez-vous de cibler /api/v1/teams/{team_id} et non un endpoint de groupes ou de départements. ^[4]

• Scopes OAuth manquants ou insuffisants. Si votre token a été généré sans Desk.settings.DELETE ou Desk.settings.ALL, l'API rejettera la requête. Vérifiez la liste des scopes dans votre configuration OAuth avant de chercher ailleurs. ^[2]

• Confusion entre équipes et départements. Les départements disposent de leur propre ensemble d'endpoints (par exemple, pour dissocier des agents ou supprimer des logos). La suppression d'une équipe n'affectera pas l'appartenance aux départements ni leur configuration — ceux-ci sont gérés séparément. [^3, ^5]

---

Ce qu'il faut vérifier

• Couverture des scopes : Confirmez que votre token OAuth actif inclut au moins l'un des scopes Desk.settings.ALL ou Desk.settings.DELETE avant d'effectuer l'appel. ^[2]
• Identifiant de ressource correct : Vérifiez que le team_id que vous transmettez correspond bien à une équipe (et non à un département ou à un groupe du Help Center) en le recoupant d'abord avec une liste GET des équipes. ^[1]
• Statut de la réponse : Une fois l'appel DELETE terminé, confirmez que la réponse HTTP indique un succès — tout code d'erreur doit être examiné en regard de vos identifiants et de la validité de l'identifiant d'équipe. ^[1]