--- title: "Cato API Changelog" slug: "cato-api-changelog" updated: 2026-10-19T23:16:21Z published: 2026-10-19T23:16:21Z 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. # Cato API Changelog Este artigo é uma plataforma para notificações sobre mudanças recentes e planejadas no esquema da API GraphQL do Cato. Ele contém notícias e atualizações destacando novas capacidades, como APIs recém-lançadas e ferramentas de automação. Para informações sobre alterações que podem exigir que você atualize seu cliente de API, consulte [Cato API Potentially Breaking Changes and EoL](/v1/docs/cato-api-potentially-breaking-changes-and-eol). Os termos da API usados neste artigo são explicados em [O que é a API Cato](/v1/docs/what-is-the-cato-api). Para qualquer cliente usando a API do Cato, recomendamos que você clique em **Seguir** para receber automaticamente notificações por email de atualizações neste artigo sobre mudanças na API. Para mais informações sobre as APIs, consulte a [Referência da API GraphQL da Cato Networks](https://api.catonetworks.com/documentation/). ## Notícias e Atualizações ### Atualizado: Origens de Conexão para Regras de Acesso Privado - 18 de Outubro de 2026 **Alterar:** API Atualizado **Título do Recurso:** Alinhar origens de conexão das Regras de Acesso Privado com APIs de Firewall de Internet e WAN A API de Regras de Acesso Privado (Beta) substitui o campo obsoleto `connectionOrigin` (`PrivateAccessPolicyOriginEnum`) por `connectionsOriginList` (`ConnectionOriginsEnum`). Essa alteração aplica-se a `policy.privateAccess.addRule`, `policy.privateAccess.updateRule`, e regras retornadas em respostas de consulta. - `SITE`, `REMOTE_CLIENT`, `REMOTE_EXTENSION`, e `REMOTE_BROWSER` permanecem inalterados. Extensão e Origem do Navegador permanecem sujeitas à disponibilidade da Conta - Use uma lista vazia em vez de `ANY` para corresponder a qualquer origem de conexão - `REMOTE` e `REMOTE_PORTAL` não são suportados no novo campo - Ambos os campos são atualmente aceitos e automaticamente sincronizados, então integrações existentes continuam a funcionar. Solicitações contendo valores conflitantes retornam um erro O campo e enum obsoletos serão removidos em uma futura alteração disruptiva. Para o Terraform, o atributo `connection_origins` e seus valores permanecem inalterados. Uma atualização para o lançamento do provedor será publicada antes da remoção. Após a remoção, versões de provedor mais antigas não darão suporte às operações de plano/aplicação de política de Acesso Privado. A aplicação da política não é afetada ### Ações Adicionais de Usuário **Alterar:** API Atualizado **Título da Funcionalidade:** Administração simplificada de usuários através de fluxos de trabalho externos e sistemas de gerenciamento de identidade A API suporta ativar usuários (`enableUser`) e desativar usuários (`disableUser`). ## Novas Notícias e Atualizações de API Anteriores ### Análises Melhoradas para Resultados de API de AppStats Agrupados - 21 de Jun 2026 **Alterar:** API Atualizado **Título da Funcionalidade:** Análises Melhoradas para Resultados de API de AppStats e Eventos Agrupados Ao consultar dados da API AppStats ou Eventos e agrupar por uma dimensão, como país ou tipo de dispositivo, você pode optar por exibir registros sem valor para essa dimensão como um grupo vazio. Isso ajuda a garantir totais consistentes nas consultas da API e mostra dados anteriormente ocultos em painéis de controle e relatórios CMA. - Novo parâmetro booleano a nível de consulta: `IncludeEmptyDimension`, sem impacto nos scripts de API existentes. - Aplica-se às consultas de API e dados exibidos no CMA ### Campos adicionados para API appStats para Clientes DEM - 19 de abril de 2026 **Alterar:** API Atualizado **Título do Recurso:** Atualizações para API appStats para métrica de experiência de aplicação Os seguintes novos Campos para a API appStats estão Disponíveis para Métricas de Experiência de Aplicação para habilitar o Acesso Programático a Dados de Usuário, Anfitrião e Desempenho de Aplicação: - `experience_score_level` - Indicador de Pontuação de Experiência Agregada - `ttfb` - Tempo até o Primeiro Byte, mede a capacidade de resposta do Servidor - `tls_latency` - Tempo para estabelecer Conexão TLS - `tcp_latency` - Tempo de configuração da Conexão TCP - `http_latency` - Latência de solicitação HTTP de ponta a ponta - `http_error_rate` - Taxa de Erros HTTP observados **Nota:** Esses campos estão disponíveis apenas para clientes com licença DEM. ### APIs de Mutação adicionadas para Webhooks, Listas de Email e Grupos de Assinatura - 29 de março de 2026 **Alterar:** Nova API **Título do Recurso:** Suporte a API para gerenciar webhooks, listas de email e grupos de assinatura - Use as seguintes APIs para atribuir, substituir, atualizar e remover licenças de sites via API para licenças individuais e agrupadas Para detalhes sobre a gestão de notificações no CMA, consulte os artigos de Notificações do [KB](/v1/docs/notifications) - - Gerencie integrações de webhook usando `createWebhook`, `updateWebhook`, `deleteWebhook`, `webhook`, `webhookList`, e `testWebhook` - Gerencie Lista de Emails usando `createMailingList`, `updateMailingList`, `deleteMailingList`, `mailingList`, e `mailingListList` - Combine webhooks e Listas de Emails em 'Grupos de Assinatura usando' `createSubscriptionGroup`, `updateSubscriptionGroup`, `deleteSubscriptionGroup`, `subscriptionGroup`, e `subscriptionGroupList` ### Atualizações nas APIs de Política de Túnel Dividido - 18 de jan, 2026 **Alterar:** API Atualizado **Título do Recurso:** Atualizações para SplitTunnelPolicyMutations - As seguintes APIs foram alteradas para alinhar mais precisamente com o comportamento do recurso no Aplicativo de Gerenciamento Cato. - **Essas mudanças se aplicam a todas as mutações para a política de Túnel Dividido:** - `Exclude` - alterado para RouteAllToCatoExcept - `Include` - alterado para RouteOnlySelected - `Coverage` - alterado para ConnectionMode - `dnsExclusion` - alterado para dnsSuffix Essas APIs estão atualmente disponíveis como Beta. ### APIs de Mutação adicionadas para Licenças de Largura de Banda do Site - 11 de agosto de 2025 **Alterar:** Nova API **Título do Recurso:** Suporte da API para gerenciar licenças de largura de banda do site - Use as seguintes APIs para atribuir, substituir, atualizar e remover licenças de sites via API para licenças individuais e agrupadas - **APIs de Mutação:** - `assignSiteBwLicense` - atribui uma licença a um site - `updateSiteBwLicense` - para licenças agrupadas, atualiza a largura de banda para um site - `replaceSiteBwLicense` - substitui a licença de site sem tempo de inatividade - `removeSiteBwLicense` - remove uma licença de um site Essas APIs estão atualmente disponíveis como Beta. ### APIs de Consulta adicionadas para Catálogo de Aplicativos e Tipos de Conteúdo DLP - 19 de maio de 2025 **Alterar:** Nova API **Título do Recurso:** Suporte da API para consulta de Catálogo de Aplicativos e Tipos de Conteúdo DLP - Catálogo de Aplicativos - Consulte os dados para aplicativos, incluindo Conformidade, Segurança e Atividades CASB: - `catalogApplicationList` - Todos os aplicativos e dados - `catalogApplication` - Aplicativo único - Conteúdo DLP - Consulte os tipos de conteúdo para a regra de Proteção de Dados Inline DLP - `contentTypeGroupList` Essas APIs estão atualmente disponíveis como Beta. ### API de Mutação adicionada para HA Secundário vSocket - 2 de março de 2025 **Alterar:** Nova API **Título do Recurso:** Suporte da API para vSocket secundário para configurações HA - Use as [seguintes APIs](https://api.catonetworks.com/documentation/#mutation-sites.addBgpPeer) para definir veredictos de história, alterar o status e adicionar comentários - **APIs de Mutação:** - `addSecondaryAwsVSocketInput` Para vSocket AWS com configuração HA, adicione um vSocket secundário - `AddSecondaryAzureVSocketInput` Para vSocket AWS com configuração HA, adicione um vSocket secundário Essas APIs estão atualmente disponíveis como Beta. ### API de Mutação XDR adicionada - 12 de janeiro de 2025 **Alterar:** Nova API **Título do Recurso:** Suporte da API para histórias e comentários XDR - Use as [seguintes APIs](https://api.catonetworks.com/documentation/#mutation-xdr.addStoryComment) para definir veredictos de história, alterar o status e adicionar comentários - **APIs de Mutação:** - `addStoryComment` Poste comentários que ajudam no rastreamento da investigação da história - `analystFeedback` Gerencie Ações da História, como o Veredito, Tipo e Classificação da história. - `deleteStoryComment` Exclua um comentário postado anteriormente usando o ID do comentário Esta API está atualmente disponível como Beta. ### Suporte à Largura de Banda de Última Milha Suporta Kbps - 12 de jan, 2025 **Mudança:** Melhoria para APIs **Título do Recurso:** Defina valores de largura de banda do site que incluam um ponto decimal (por exemplo, 1.5 Mbps) para maior precisão granular - Use as [seguintes APIs](https://api.catonetworks.com/documentation/#mutation-sites.addSocketSite) para definir veredictos de história, alterar o status e adicionar comentários - **Tipos impactados para APIs:** - `LastMileBwInput` - `InterfaceInfo` - `SocketInterfaceBandwidthInput` Esses tipos de API estão atualmente disponíveis como Beta. ### Mudanças para accountSnapshot e accountMetrics para Sites IPsec IKEv2 - 12 de jan, 2025 **Mudança:** Atualização do valor `Principal` para `Principal 1` **Título do Recurso:** Suporte da API para sites IPsec IKEv2 O valor recuperado do campo `InterfaceId` nas consultas accountSnapshot e accountMetrics está mudando a partir do lançamento gradual de suporte para configurações Ativas/Ativas em 12 de Janeiro de 2025. | Valor Antigo | Novo Valor | Nota | | --- | --- | --- | | Principal | Principal1 | Esta mudança nos permite suportar mais de um túnel principal | ### Nova API de Peering BGP - 23 de dez, 2024 **Alterar:** Nova API **Título do Recurso:** Suporte da API para Emparelhamento BGP - Use as APIs a seguir para simplificar a [configuração](https://api.catonetworks.com/documentation/#mutation-sites.addBgpPeer) e o [monitoramento](https://api.catonetworks.com/documentation/#query-site.bgpPeer) de pares BGP para locais - **APIs de Mutação:** - `addBgpPeer` Adicione um novo par BGP a um site - `updateBgpPeer` Atualizar configurações para uma configuração de par BGP existente - `removeBgpPeer` Excluir uma configuração de par BGP para um site - **APIs de Consulta:** - `bgpPeer` Recupere informações sobre um par BGP específico - `siteBgpStatus` Mostrar o status atual do BGP, incluindo detalhes da sessão e informações de rota Esta API está atualmente disponível como Beta.