Cisco Umbrella for Government API, API Changelog

API Changelog

Learn about additions, updates, and deprecations to the Cisco Umbrella for Government API.

v2.0 – September 23, 2025

• Added the subcategory and subcategory_content_types query parameters and fields to the App Discovery API.
  • GET /reports/v2/appDiscovery/applications
  • GET /reports/v2/appDiscovery/applications/info

v2.0 – March 11, 2025

• Added an API endpoint to the Network Tunnel Groups and Regions API:

  • GET /deployments/v2/networktunnelgroups/{id}/peers

v2.0 – October 8, 2024

• Added API endpoints to the Network Tunnel Groups and Regions API that provide state information:
  • GET /deployments/v2/networktunnelgroups/{id}/state
  • GET /deployments/v2/networktunnelgroups/{id}/networktunnelhubs/{hub_id}/peers/{peer_id}/state
  • GET /deployments/v2/networktunnelgroupsstate

v2.0 – August 21, 2024

• Added the Key Admin API.
  • GET /admin/v2/apiKeys
  • POST /admin/v2/apiKeys
  • GET /admin/v2/apiKeys/{apiKeyId}
  • DELETE /admin/v2/apiKeys/{apiKeyId}
  • PATCH /admin/v2/apiKeys/{apiKeyId}
  • POST /admin/v2/apiKeys/{apiKeyId}/refresh
• Added the Users and User Roles API.
  • GET /admin/v2/users
  • GET /admin/v2/roles
• Added the Roaming Computers API.
  • GET /deployments/v2/roamingcomputers
  • GET /deployments/v2/roamingcomputers/{deviceId}
  • PUT /deployments/v2/roamingcomputers/{deviceId}
  • DELETE /deployments/v2/roamingcomputers/{deviceId}
• Added the Networks API.
  • GET /deployments/v2/networks
  • POST /deployments/v2/networks
  • GET /deployments/v2/networks/{networkId}
  • PUT /deployments/v2/networks/{networkId}
  • DELETE /deployments/v2/networks/{networkId}
  • GET /deployments/v2/networks/{networkId}/policies
• Added the Network Tunnel Groups and Regions API.
  • GET /deployments/v2/networktunnelgroups
  • POST /deployments/v2/networktunnelgroups
  • GET /deployments/v2/networktunnelgroups/{id}
  • PATCH /deployments/v2/networktunnelgroups/{id}
  • DELETE /deployments/v2/networktunnelgroups/{id}
  • GET /deployments/v2/regions
• Added the Internal Networks API.
  • GET /deployments/v2/internalnetworks
  • POST /deployments/v2/internalnetworks
  • GET /deployments/v2/internalnetworks/{internalNetworkId}
  • PUT /deployments/v2/internalnetworks/{internalNetworkId}
  • DELETE /deployments/v2/internalnetworks/{internalNetworkId}
  • GET /deployments/v2/internalnetworks/{internalNetworkId}/policies
• Added the Internal Domains API.
  • GET /deployments/v2/internaldomains
  • POST /deployments/v2/internaldomains
  • GET /deployments/v2/internaldomains/{internalDomainId}
  • PUT /deployments/v2/internaldomains/{internalDomainId}
  • DELETE /deployments/v2/internaldomains/{internalDomainId}
• Added the Sites API.
  • GET /deployments/v2/sites
  • POST /deployments/v2/sites
  • GET /deployments/v2/sites/{siteId}
  • PUT /deployments/v2/sites/{siteId}
  • DELETE /deployments/v2/sites/{siteId}
• Added the Virtual Appliances API.
  • GET /deployments/v2/virtualappliances
  • GET /deployments/v2/virtualappliances/{virtualApplianceId}
  • PUT /deployments/v2/virtualappliances/{virtualApplianceId}
  • DELETE /deployments/v2/virtualappliances/{virtualApplianceId}
• Added the Network Devices API.
  • GET /deployments/v2/networkdevices
  • POST /deployments/v2/networkdevices
  • GET /deployments/v2/networkdevices/{originId}
  • PATCH /deployments/v2/networkdevices/{originId}
  • DELETE /deployments/v2/networkdevices/{originId}
  • GET /deployments/v2/networkdevices/{originId}/policies
• Added the Policies API.
  • GET /deployments/v2/policies
  • PUT /deployments/v2/policies/{policyId}/identities/{originId}
  • DELETE /deployments/v2/policies/{policyId}/identities/{originId}
• Added the Destination Lists API.
  • GET /policies/v2/destinationlists
  • POST /policies/v2/destinationlists
  • GET /policies/v2/destinationlists/{destinationListId}
  • PATCH /policies/v2/destinationlists/{destinationListId}
  • DELETE /policies/v2/destinationlists/{destinationListId}
  • GET /policies/v2/destinationlists/{destinationListId}/destinations
  • POST /policies/v2/destinationlists/{destinationListId}/destinations
  • DELETE /policies/v2/destinationlists/{destinationListId}/destinations/remove
• Added the Reporting API.
  • GET /reports/v2/activity/dns
  • GET /reports/v2/activity/proxy
  • GET /reports/v2/activity/firewall
  • GET /reports/v2/activity/intrusion
  • GET /reports/v2/activity/ip
  • GET /reports/v2/activity/amp-retrospective
  • GET /reports/v2/top-identities
  • GET /reports/v2/top-identities/{type}
  • GET /reports/v2/identity-distribution
  • GET /reports/v2/identity-distribution/{type}
  • GET /reports/v2/top-destinations
  • GET /reports/v2/top-destinations/{type}
  • GET /reports/v2/top-urls
  • GET /reports/v2/top-categories
  • GET /reports/v2/top-categories/{type}
  • GET /reports/v2/top-eventtypes
  • GET /reports/v2/top-dns-query-types
  • GET /reports/v2/top-files
  • GET /reports/v2/total-requests
  • GET /reports/v2/total-requests/{type}
  • GET /reports/v2/top-threats
  • GET /reports/v2/top-threats/{type}
  • GET /reports/v2/top-threat-types
  • GET /reports/v2/top-threat-types/{type}
  • GET /reports/v2/top-ips
  • GET /reports/v2/top-ips/internal
  • GET /reports/v2/summary
  • GET /reports/v2/summary/{type}
  • GET /reports/v2/summaries-by-category
  • GET /reports/v2/summaries-by-category/{type}
  • GET /reports/v2/summaries-by-destination
  • GET /reports/v2/summaries-by-destination/{type}
  • GET /reports/v2/requests-by-hour
  • GET /reports/v2/requests-by-hour/{type}
  • GET /reports/v2/requests-by-timerange
  • GET /reports/v2/requests-by-timerange/{type}
  • GET /reports/v2/categories-by-hour
  • GET /reports/v2/categories-by-hour/{type}
  • GET /reports/v2/categories-by-timerange
  • GET /reports/v2/categories-by-timerange/{type}
  • GET /reports/v2/deployment-status
  • GET /reports/v2/bandwidth-by-hour
  • GET /reports/v2/bandwidth-by-timerange
  • GET /reports/v2/summaries-by-rule/intrusion
  • GET /reports/v2/applications
  • GET /reports/v2/categories
  • GET /reports/v2/identities
  • GET /reports/v2/identities/{identityid}
  • GET /reports/v2/threat-types
  • GET /reports/v2/threat-types/{threattypeid}
  • GET /reports/v2/threat-names
  • GET /reports/v2/threat-names/{threatnameid}
  • POST /reports/v2/identities
• Added the App Discovery API.
  • GET /reports/v2/appDiscovery/applications
  • PATCH /reports/v2/appDiscovery/applications
  • GET /reports/v2/appDiscovery/applications/{applicationId}
  • PATCH /reports/v2/appDiscovery/applications/{applicationId}
  • GET /reports/v2/appDiscovery/applications/{applicationId}/risk
  • GET /reports/v2/appDiscovery/applications/{applicationId}/identities
  • GET /reports/v2/appDiscovery/applications/{applicationId}/attributes
  • GET /reports/v2/appDiscovery/protocols
  • GET /reports/v2/appDiscovery/protocols/{protocolId}
  • GET /reports/v2/appDiscovery/protocols/{protocolId}/identities
  • GET /reports/v2/appDiscovery/applicationCategories
• Added the API Usage Reports API.
  • GET /reports/v2/apiUsage/requests
  • GET /reports/v2/apiUsage/responses
  • GET /reports/v2/apiUsage/keys
  • GET /reports/v2/apiUsage/summary

Deprecated

• None.

Removed

• None.

Fixed

v2.0 – June 18, 2025

• Updated the documentation of the fields in the filters query parameter on the /deployments/v2/regions API endpoint. The type of the latitude and longitude fields is number not string.