Cato API Changelog

This article is a platform for notifications on recent and planned changes to the Cato GraphQL API schema. It contains news and updates highlighting new capabilities, such as newly released APIs and automation tools.

For information about changes that might require you to update your API client, see Cato API Potentially Breaking Changes and EoL.

The API terms used in this article are explained in What is the Cato API.

For any customers using the Cato API, we recommend that you click Follow to automatically receive email notifications for updates to this article about changes to the API.

For more information about the APIs, see the Cato Networks GraphQL API Reference.

News and Updates

New Query APIs for App Catalog and DLP Content Types - May 19, 2025

Change: New API

Feature Title: API Support for querying App Catalog and DLP Content Types

  • App Catalog - Query the data for apps, including Compliance, Security, and CASB Activities:

    • catalogApplicationList - All apps and data

    • catalogApplication - Single app

  • DLP Content - Query the types of content for the DLP Data Inline Protection rule

    • contentTypeGroupList

These APIs are currently available as Beta.

Previous API News and Updates

New Mutation API for HA Secondary vSocket - Mar 2, 2025

Change: New API

Feature Title: API Support for secondary vSocket for HA configurations

  • Use the following APIs to set story verdicts, change status, and add comments

    • Mutation APIs: 

      • addSecondaryAwsVSocketInput For AWS vSocket with HA configuration, add a secondary vSocket

      • AddSecondaryAzureVSocketInput For AWS vSocket with HA configuration, add a secondary vSocket

These APIs are currently available as Beta.

New XDR Mutation API - Jan 12, 2025

Change: New API

Feature Title: API Support for XDR stories and comments

  • Use the following APIs to set story verdicts, change status, and add comments

    • Mutation APIs: 

      • addStoryComment Post comments that help track the story investigation

      • analystFeedback Manage Story Actions, such as the story Verdict, Type, and Classification.

      • deleteStoryComment Delete a previously posted comment using the comment ID

This API is currently available as Beta.

Last-Mile Bandwidth Supports Kbps - Jan 12, 2025

Change: Enhancement for APIs

Feature Title: Set site bandwidth values that include one decimal point (e.g. 1.5 Mbps) for more granular accuracy

  • Use the following APIs to set story verdicts, change status, and add comments

    • Impacted types for APIs: 

      • LastMileBwInput 

      • InterfaceInfo 

      • SocketInterfaceBandwidthInput 

These API types are currently available as Beta.

Changes to accountSnapshot and accountMetrics for IPsec IKEv2 Sites - Jan 12, 2025

Change: Update of Primary value to Primary 1

Feature Title: API Support for IPsec IKEv2 sites

The value retrieved from the InterfaceId field in the accountSnapshot and accountMetrics queries are changing as of the gradual release of support for Active/Active configurations on Jan 12, 2025.

Old Value

New Value

Notes

Primary

Primary1

This change lets us support more than one primary tunnel

New BGP Peering API - Dec 23, 2024

Change: New API

Feature Title: API Support for BGP Peering

  • Use the following APIs to simplify the configuring and monitoring BGP peers for sites

    • Mutation APIs: 

      • addBgpPeer Add a new BGP peer to a site

      • updateBgpPeer Update settings for an existing BGP peer configuration

      • removeBgpPeer Delete a BGP peer configuration for a site

    • Query APIs: 

      • bgpPeer Retrieve information about a specific BGP peer

      • siteBgpStatus Show the current BGP status, including session details and route information

This API is currently available as Beta.

Was this article helpful?

1 out of 1 found this helpful

3 comments

Date Votes
  • Comment author
    Yaakov Simon

    Added these updates:

    1. New XDR Mutation API
    2. APIs for last-mile site bandwidth supports Kbps
  • Comment author
    Yaakov Simon

    Added New Mutation API for HA Secondary vSocket

  • Comment author
    Yaakov Simon

    Added New Query APIs for App Catalog and DLP Content Types