--- title: "Journal des modifications de l'API Cato" slug: "cato-api-changelog" updated: 2026-10-19T23:17:00Z published: 2026-10-19T23:17:00Z canonical: "knowledge.catonetworks.com/cato-api-changelog" --- > ## Documentation Index > Fetch the complete documentation index at: https://knowledge.catonetworks.com/llms.txt > Use this file to discover all available pages before exploring further. # Journal des modifications de l'API Cato Cet article sert de plateforme pour les notifications concernant les modifications récentes et prévues du schéma API GraphQL de Cato. Il contient des nouvelles et des mises à jour mettant en avant de nouvelles fonctionnalités, telles que des API et des outils d'automatisation récemment publiés. Pour des informations sur les modifications qui pourraient vous obliger à mettre à jour votre client API, consultez [Cato API Potentially Breaking Changes and EoL](/v1/docs/cato-api-potentially-breaking-changes-and-eol). Les termes de l'API utilisées dans cet article sont expliqués dans [Quoi est l'API Cato](/v1/docs/what-is-the-cato-api). Pour tous les clients utilisant l'API Cato, nous vous recommandons de cliquer sur **Suivre** pour recevoir automatiquement des notifications par e-mail pour les mises à jour de cet article concernant les changements apportés à l'API. Pour plus d'informations sur les API, consultez le [Cato Networks GraphQL API Reference](https://api.catonetworks.com/documentation/). ## Nouvelles et mises à jour ### Origines de connexion mises à jour pour l'API des règles d'accès privé - 18 Oct 2026 **Modification :** API mis à jour **Titre de la fonctionnalité :** Aligner les origines de connexion des règles d'accès privé avec les API Internet et Pare-feu WAN L'API des Règles d'accès privé (Beta) remplace le champ obsolète `connectionOrigin` (`PrivateAccessPolicyOriginEnum`) avec `connectionsOriginList` (`ConnectionOriginsEnum`). Ce changement s'applique à `policy.privateAccess.addRule`, `policy.privateAccess.updateRule`, et aux règles retournées dans les réponses aux requêtes. - `SITE`, `REMOTE_CLIENT`, `REMOTE_EXTENSION`, et `REMOTE_BROWSER` restent inchangés. Les extensions et les origines du navigateur restent soumises à la disponibilité des comptes - Utilisez une liste vide au lieu de `ANY` pour correspondre à n'importe quelle origine de connexion - `REMOTE` et `REMOTE_PORTAL` ne sont pas pris en charge dans le nouveau champ - Les deux champs sont actuellement acceptés et automatiquement synchronisés, donc les intégrations existantes continuent de fonctionner. Les demandes contenant des valeurs conflictuelles retournent une erreur Le champ et l'énumération obsolètes seront supprimés lors d'une modification importante future. Pour Terraform, l'attribut `connection_origins` et ses valeurs restent inchangés Une mise à niveau de la version du fournisseur sera publiée avant la suppression. Après suppression, les anciennes versions du fournisseur ne prendront pas en charge les opérations de planification/appliquer la politique de règles d'accès privé. L'application de la politique n'est pas affectée ### Actions Utilisateur Supplémentaires **Modification :** API Mis à jour **Titre Fonctionnalité :** Administration simplifiée des utilisateurs via des flux de travail externes et des systèmes de gestion d'identité L' API soutient l'activation des utilisateurs (`enableUser`) et la désactivation des utilisateurs (`disableUser`). ## Actualités précédentes des API et mises à jour ### Analyses améliorées pour les résultats de l'API AppStats groupés - 21 juin 2026 **Modification :** API mis à jour **Titre de la fonctionnalité :** Analyses améliorées pour les résultats de l'API AppStats et Événements groupés Lors de la requête de données API AppStats ou Événements et de leur classification par dimension, telle que le pays ou le type d'appareil, vous avez la possibilité d'afficher les enregistrements sans valeur pour cette dimension comme un groupe vide. Cela permet de garantir des totaux cohérents dans les requêtes API et affiche les données précédemment cachées dans les tableaux de bord et rapports CMA. - Nouveau paramètre booléen au niveau de la requête : `IncludeEmptyDimension`, aucun impact sur les scripts API existants - S'applique aux requêtes API et aux données affichées dans le CMA ### Champs ajoutés pour appStats API pour Clients DEM - 19 Avril 2026 **Modification :** API mis à jour **Titre de la Fonctionnalité :** Mises à jour de l'API appStats pour les métriques de l'expérience application Les nouveaux champs suivants pour l'API appStats sont disponibles pour les mesures de l'expérience des applications afin de permettre un accès programmatique aux données de performance des utilisateurs, des hôtes et des applications. - `experience_score_level` - Indicateur de score d'expérience agrégé - `ttfb` - Temps jusqu'au premier octet, mesure de la réactivité du serveur - `tls_latency` - Temps pour établir la connexion TLS - `tcp_latency` - Temps de configuration de la connexion TCP - `http_latency` - Latence de la requête HTTP de bout en bout - `http_error_rate` - Taux d'erreurs HTTP observées **Note :** Ces champs sont disponibles uniquement pour les clients disposant d'une licence DEM. ### Mutations API ajoutées pour Webhooks, Listes de diffusion, et Groupes d'abonnement - 29 Mars 2026 **Modification :** Nouvelle API **Titre de la fonctionnalité :** Support API pour la gestion des webhooks, listes de diffusion, et groupes d'abonnement - Utilisez les API suivantes pour assigner, remplacer, mettre à jour et supprimer des licences de site via API pour les licences uniques et groupées Pour les détails sur la gestion des notifications dans le CMA, consultez les articles de la [Notifications](/v1/docs/notifications) KB - - Gérez les intégrations de webhooks en utilisant `createWebhook`, `updateWebhook`, `deleteWebhook`, `webhook`, `webhookList`, et `testWebhook` - Gérez les listes de diffusion en utilisant `createMailingList`, `updateMailingList`, `deleteMailingList`, `mailingList`, et `mailingListList` - Combinez les webhooks et les listes de diffusion dans les 'groupes d'abonnement en utilisant' `createSubscriptionGroup`, `updateSubscriptionGroup`, `deleteSubscriptionGroup`, `subscriptionGroup`, et `subscriptionGroupList` ### Mises à jour des API de politique de tunnel fractionné - Jan 18, 2026 **Modification :** API mis à jour **Titre de la fonctionnalité :** Mises à jour des mutations de la politique de tunnel fractionné - Les API suivantes ont été modifiées pour s'aligner plus précisément avec le comportement de la fonctionnalité dans l'application de gestion Cato. - **Ces modifications s'appliquent à toutes les mutations de la politique de tunnel fractionné :** - `Exclude` - changé en RouteAllToCatoExcept - `Include` - changé en RouteOnlySelected - `Coverage` - changé en ConnectionMode - `dnsExclusion` - changé en dnsSuffix Ces APIs sont actuellement disponibles en version bêta. ### Mutations API ajoutées pour Licences de bande passante de site - 11 Août 2025 **Modification :** Nouvelle API **Titre de la Fonctionnalité :** Support API pour la gestion des licences de bande passante de site - Utilisez les API suivantes pour assigner, remplacer, mettre à jour et supprimer des licences de site via API pour les licences uniques et groupées - **Mutations APIs :** - `assignSiteBwLicense` - assigne une licence à un site - `updateSiteBwLicense` - pour les licences groupées, met à jour la bande passante d'un site - `replaceSiteBwLicense` - remplace la licence du site sans temps d'arrêt - `removeSiteBwLicense` - retire une licence d'un site Ces APIs sont actuellement disponibles en version bêta. ### APIs de requête ajoutées pour Catalogue d'applications et Types de contenu DLP - 19 Mai 2025 **Modification :** Nouvelle API **Titre de la Fonctionnalité :** Support API pour interroger le Catalogue d'Applications et les Types de Contenu DLP - Catalogue d'Applications - Interrogez les données des applications, y compris la conformité, la sécurité et les activités CASB : - `catalogApplicationList` - Toutes les applications et données - `catalogApplication` - Application unique - Contenu DLP - Interrogez les types de contenu pour la règle de Protection des Données Inline DLP - `contentTypeGroupList` Ces APIs sont actuellement disponibles en version bêta. ### Mutations API ajoutées pour HA vSocket secondaire - 2 Mars 2025 **Modification :** Nouvelle API **Titre de la Fonctionnalité :** Support API pour le vSocket secondaire pour les configurations HA - Utilisez les [APIs suivantes](https://api.catonetworks.com/documentation/#mutation-sites.addBgpPeer) pour définir les verdicts d'histoire, changer le statut et ajouter des commentaires - **Mutations APIs :** - `addSecondaryAwsVSocketInput` Pour AWS vSocket avec une configuration HA, ajoutez un vSocket secondaire - `AddSecondaryAzureVSocketInput` Pour AWS vSocket avec une configuration HA, ajoutez un vSocket secondaire Ces APIs sont actuellement disponibles en version bêta. ### Mutation API XDR ajoutée - 12 Janvier 2025 **Modification :** Nouvelle API **Titre de la Fonctionnalité :** Support API pour les histoires et commentaires XDR - Utilisez les [APIs suivantes](https://api.catonetworks.com/documentation/#mutation-xdr.addStoryComment) pour définir les verdicts d'histoire, changer le statut et ajouter des commentaires - **Mutations APIs :** - `addStoryComment` Publiez des commentaires qui aident à suivre l'enquête sur l'histoire - `analystFeedback` Gérer les actions de l'histoire, telles que le verdict de l'histoire, le type et la classification. - `deleteStoryComment` Supprimez un commentaire précédemment publié en utilisant l'ID du commentaire Cette API est actuellement disponible en version Bêta. ### La bande passante du dernier kilomètre prend en charge les Kbps - Jan 12, 2025 **Changement :** Amélioration pour les API **Titre de la Fonctionnalité :** Définissez les valeurs de bande passante du site incluant une décimale (par ex. 1.5 Mbps) pour une précision plus granulée - Utilisez les [APIs suivantes](https://api.catonetworks.com/documentation/#mutation-sites.addSocketSite) pour définir les verdicts d'histoire, changer le statut et ajouter des commentaires - **Types concernés pour les API :** - `LastMileBwInput` - `InterfaceInfo` - `SocketInterfaceBandwidthInput` Ces types d'API sont actuellement disponibles en version Bêta. ### Modifications du compteSnapshot et des compteMetrics pour les sites IPsec IKEv2 - Jan 12, 2025 **Changement :** Mise à jour de la valeur `Primary` à `Primary 1` **Titre de la Fonctionnalité :** Support API pour les sites IPsec IKEv2 La valeur récupérée du champ `InterfaceId` dans les requêtes accountSnapshot et accountMetrics va changer à partir de la sortie progressive du support pour les configurations Actif/Actif le 12 janvier 2025. | Ancienne Valeur | Nouvelle Valeur | Notes | | --- | --- | --- | | Primaire | Primaire1 | Ce changement nous permet de soutenir plusieurs tunnels principaux | ### Nouvelle API de peering BGP - Dec 23, 2024 **Modification :** Nouvelle API **Titre de la Fonctionnalité :** Support API pour le Pair à Pair BGP - Utilisez les APIs suivantes pour simplifier la [configuration](https://api.catonetworks.com/documentation/#mutation-sites.addBgpPeer) et la [surveillance](https://api.catonetworks.com/documentation/#query-site.bgpPeer) des pairs BGP pour les sites - **Mutations APIs :** - `addBgpPeer` Ajoutez un nouveau pair BGP à un site - `updateBgpPeer` Mettre à jour les paramètres pour une configuration de pair BGP existante - `removeBgpPeer` Supprimez une configuration de pair BGP pour un site - **APIs de Requête :** - `bgpPeer` Récupérer des informations sur un pair BGP spécifique - `siteBgpStatus` Afficher le statut BGP actuel, y compris les détails de la session et les informations de routage Cette API est actuellement disponible en version Bêta.