Comment supprimer une vue dans Zoho Desk

La suppression d'une vue dans Zoho Desk est simple via l'API : envoyez une requête DELETE à l'endpoint des vues avec l'ID de la vue cible, et Zoho Desk la supprimera définitivement.

Pourquoi c'est important

Les vues personnalisées aident les agents à filtrer et à prioriser les tickets, mais avec le temps, les vues obsolètes ou redondantes encombrent l'interface. Que vous effectuiez un nettoyage périodique, que vous désactiviez un workflow ou que vous automatisiez la gestion du cycle de vie des vues via un script, connaître le bon appel API vous fait gagner du temps et évite de naviguer manuellement dans l'interface. C'est particulièrement utile pour gérer des vues à grande échelle dans plusieurs départements.

Étape par étape

Étape 1. Vérifiez que les scopes OAuth appropriés sont configurés pour votre intégration Zoho Desk. Votre token doit au minimum inclure Desk.settings.DELETE (et idéalement le scope complet Desk.settings.ALL) pour autoriser les opérations destructives sur les ressources de paramètres telles que les vues. ^[2]

Étape 2. Récupérez le view_id de la vue que vous souhaitez supprimer. Vous pouvez l'obtenir en listant les vues via l'API Zoho Desk au préalable, ou en inspectant l'URL de la vue dans l'interface Zoho Desk. Conservez cet ID à portée de main — il s'agit d'un paramètre de chemin obligatoire. ^[1]

Étape 3. Construisez votre requête DELETE ciblant l'endpoint /api/v1/views/{viewid}, en remplaçant {viewid} par l'identifiant réel récupéré à l'étape précédente. Aucun corps de requête n'est nécessaire ; l'ID de la vue dans le chemin suffit à identifier la ressource. ^[1]

Étape 4. Envoyez la requête. En Python, l'appel ressemble à ceci (paraphrasé à partir de l'implémentation sous-jacente) :

# Assuming `client` is your authenticated Zoho Desk API client
client.request("DELETE", f"/api/v1/views/{view_id}", None, None)

Une réponse réussie confirmera que la vue a été supprimée. ^[1]

Étape 5. Si vous travaillez avec des vues personnalisées Zoho CRM plutôt qu'avec des vues Zoho Desk, notez que l'endpoint est entièrement différent : DELETE /settings/custom_views/{vid}, et il nécessite un paramètre module (par exemple, "Leads", "Contacts") pour identifier le module dont la vue est supprimée. Ne confondez pas ces deux endpoints. ^[3]

---

> Beam Help est un support expert indépendant pour Zoho — nous ne sommes pas le support officiel de Zoho. Testez toujours les appels API destructifs dans un environnement sandbox ou de staging avant de les exécuter sur des données de production.

---

Erreurs courantes

• Mauvais scope : Si votre token OAuth ne contient pas Desk.settings.DELETE ou Desk.settings.ALL, l'API retournera une erreur d'autorisation. Vérifiez votre liste de scopes dans la configuration de votre environnement avant de déboguer la requête elle-même. ^[2]

• Confusion entre les vues Desk et les vues personnalisées CRM : L'endpoint de suppression de vue Zoho Desk (/api/v1/views/{viewid}) et l'endpoint de vue personnalisée Zoho CRM (/settings/customviews/{vid}) sont complètement distincts. Utiliser l'endpoint CRM avec un ID de vue Desk (ou inversement) retournera soit une erreur 404, soit échouera silencieusement. ^[1][3]

• Suppression d'un layout au lieu d'une vue : Zoho Desk expose également un endpoint DELETE /api/v1/layouts/{layoutId} pour supprimer des layouts — un type de ressource différent. Vérifiez que vous ciblez bien un ID de *vue* et non un ID de *layout* avant d'exécuter l'appel. ^[7]

• Action irréversible : La suppression d'une vue dans Zoho Desk est permanente. Il n'existe pas de corbeille ni de mécanisme d'annulation exposé via l'API. Vérifiez toujours le view_id avant d'envoyer la requête.

Ce qu'il faut vérifier

• Validation du scope : Confirmez que votre token OAuth actif inclut Desk.settings.DELETE ou Desk.settings.ALL et qu'il n'a pas expiré. ^[2]
• ID de vue correct : Vérifiez que le view_id que vous transmettez correspond bien à la vue souhaitée — listez les vues d'abord et effectuez une vérification croisée avant de supprimer. ^[1]
• Confirmation post-suppression : Après le retour réussi de l'appel DELETE, tentez de récupérer la vue via une requête GET pour confirmer qu'elle n'existe plus et n'a pas simplement été désactivée. ^[1]