Comment supprimer un profil dans Zoho Desk

La suppression d'un profil dans Zoho Desk via l'API est une opération simple en un seul appel — vous émettez une requête DELETE vers l'endpoint des profils en indiquant l'ID du profil cible. En tant que support expert indépendant (et non le support officiel de Zoho), Beam Help vous guide pas à pas dans tout ce dont vous avez besoin.

Pourquoi c'est important

Les profils dans Zoho Desk contrôlent ce que les agents peuvent voir et faire au sein de votre service d'assistance. Au fil du temps, les organisations accumulent des profils redondants ou obsolètes qui doivent être nettoyés. Supprimer les profils inutiles permet de maintenir une structure de permissions claire et réduit le risque que des agents opèrent sous des règles d'accès incorrectes.

Étape par étape

Étape 1. Assurez-vous que votre token OAuth dispose des scopes Zoho Desk appropriés avant d'effectuer tout appel API. Les scopes nécessaires incluent Desk.settings.ALL ou au minimum Desk.settings.DELETE, qui régissent les opérations au niveau des paramètres telles que la gestion des profils. ^[2]

Étape 2. Identifiez le profile_id du profil que vous souhaitez supprimer. Vous pouvez le récupérer en listant les profils existants via l'API Zoho Desk et en notant l'ID retourné dans la réponse. Conservez cette valeur — vous la passerez directement dans la requête de suppression. ^[1]

Étape 3. Construisez et envoyez la requête de suppression. L'opération cible l'endpoint suivant :

DELETE /api/v1/profiles/{profile_id}

Remplacez {profile_id} par l'ID réel que vous avez récupéré à l'étape 2. ^[1]

Étape 4. Si vous utilisez un client Python, l'appel se présente comme suit :

def delete_profile(self, profile_id: str, p: dict = None):
    return self.c.request("DELETE", f"/api/v1/profiles/{profile_id}", p, None)

Passez l'ID du profil sous forme de 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 5. Assurez-vous que votre client API est initialisé avec un ID d'organisation Zoho Desk valide (orgid). Le client en a besoin pour acheminer correctement les requêtes vers votre instance Desk. Si l'orgid est absent, le système peut le découvrir automatiquement en appelant d'abord l'endpoint des organisations et en conservant l'ID retourné. ^[6]

Erreurs courantes

• Scopes manquants ou incorrects. Si votre token OAuth n'inclut pas Desk.settings.DELETE (ou le scope plus large Desk.settings.ALL), l'API rejettera la requête avec une erreur d'autorisation. Vérifiez les scopes configurés dans votre environnement. ^[2]

• ID de profil incorrect. Passer un ID qui n'existe pas ou qui appartient à un autre portail entraînera l'échec de la requête. Vérifiez toujours le profile_id en récupérant la liste des profils avant de tenter la suppression. ^[1]

• Blocage des opérations destructives. Dans les workflows automatisés ou assistés par IA, les opérations de suppression sont classées comme « destructives » et peuvent être bloquées si le système n'est pas explicitement configuré pour les autoriser. Confirmez que votre intégration ou vos outils autorisent les permissions de niveau destructif avant de déclencher cet appel. ^[4]

• ID d'organisation manquant. Les requêtes effectuées sans org_id valide sur le client Desk ne parviendront pas à atteindre la bonne organisation. Assurez-vous que l'ID d'organisation est résolu et attaché au client avant d'émettre la suppression. ^[6]

Ce qu'il faut vérifier

• Confirmez que le token OAuth utilisé inclut Desk.settings.DELETE ou Desk.settings.ALL dans sa liste de scopes. ^[2]
• Vérifiez que le profile_id ciblé est valide en récupérant au préalable la liste des profils actuels. ^[1]
• Après le retour de l'appel de suppression, tentez de récupérer le même ID de profil pour confirmer qu'il n'existe plus dans Zoho Desk. ^[1]