API Changelog, Cisco Secure Access for Government APIs

API Changelog

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

v2.0 – January 6, 2026

• Destination Lists API—Secure Access supports up to 250,000 destinations spread across all destination lists in an organization.

v2.0 – November 3, 2025

• 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 VPN User Connections API.
  • GET /admin/v2/vpn/userConnections
  • PUT /admin/v2/vpn/userConnections
• Added the Secure Web Gateway Device Settings API.
  • POST /deployments/v2/deviceSettings/SWGEnabled/set
  • POST /deployments/v2/deviceSettings/SWGEnabled/list
  • POST /deployments/v2/deviceSettings/SWGEnabled/remove
• 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 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 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 IPS Profiles API.
  • GET /policies/v2/ipsSignatureProfiles
  • GET /policies/v2/ipsSignatureProfiles/{id}
  • GET /policies/v2/ipsSignatureProfiles/{id}/signatures
  • POST /policies/v2/ipsSignatureProfiles
  • PATCH /policies/v2/ipsSignatureProfiles/{id}
  • DELETE /policies/v2/ipsSignatureProfiles/{id}
• Added the Application Lists API.
  • GET /policies/v2/applicationLists
  • GET /policies/v2/applications/usage
  • POST /policies/v2/applicationLists
  • PUT /policies/v2/applicationLists/{applicationListId}
  • DELETE /policies/v2/applicationLists/{applicationListId}
• Added the Content Categories API.
  • GET /policies/v2/categorySettings
• Added the Security Profiles API.
  • GET /policies/v2/securityProfiles
  • GET /policies/v2/securityProfiles/{profileId}
• Added the Tenant Controls Profiles API.
  • GET /policies/v2/tenantControls/profiles
• Added the Application Categories.
  • GET /policies/v2/applicationCategories
• Added the Access Policy Rules API.
  • GET /policies/v2/rules
  • GET /policies/v2/rules/{ruleId}
  • GET /policies/v2/geolocations
  • POST /policies/v2/rules
  • PUT /policies/v2/rules
  • PUT /policies/v2/rules/{ruleId}
  • DELETE /policies/v2/rules/{ruleId}
  • GET /policies/v2/settings
  • GET /policies/v2/settings/{settingName}
  • GET /policies/v2/settingTypes
  • GET /policies/v2/settingTypes/{settingName}
  • PUT /policies/v2/settings
  • PUT /policies/v2/settings/{settingName}
  • DELETE /policies/v2/settings/{settingName}
• 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

• None.