API Changelog, Cisco Secure Access China APIs

API Changelog

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

v2.0 – April 9, 2025

Added the Cisco Secure Access China API.

• Added the Token AuthorizationAPI.
  • POST /auth/v2/token
• 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 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 Roaming Computers API.
  • GET /deployments/v2/roamingcomputers
  • GET /deployments/v2/roamingcomputers/{deviceId}
  • PUT /deployments/v2/roamingcomputers/{deviceId}
  • DELETE /deployments/v2/roamingcomputers/{deviceId}
• Added the Private Resources and Resource Groups API.
  • GET /policies/v2/privateResources
  • POST /policies/v2/privateResources
  • GET /policies/v2/privateResources/{id}
  • PUT /policies/v2/privateResources/{id}
  • GET /policies/v2/privateResourceGroups
  • POST /policies/v2/privateResourceGroups
  • GET /policies/v2/privateResourceGroups/{id}
  • PUT /policies/v2/privateResourceGroups/{id}
  • DELETE /policies/v2/privateResourceGroups/{id}
• 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
• Policy Rules API—Added the Rules, Rule Settings, and Application Lists APIs.
  • GET /policies/v2/applicationLists
  • GET /policies/v2/applications/usage
  • POST /policies/v2/applicationLists
  • PUT /policies/v2/applicationLists/{applicationListId}
  • DELETE /policies/v2/applicationLists/{applicationListId}
  • 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}
• Network and Service Objects API—Added the Network and Service Objects API endpoints. Network Objects:
  • GET /policies/v2/objects/networkObjects
  • POST /policies/v2/objects/networkObjects
  • GET /policies/v2/objects/networkObjects/references
  • GET /policies/v2/objects/networkObjects/{networkObjectId}
  • GET /policies/v2/objects/networkObjects/{networkObjectId}/references
  • PUT /policies/v2/objects/networkObjects/{networkObjectId}
  • DELETE /policies/v2/objects/networkObjects/{networkObjectId} Network Object Groups:
  • GET /policies/v2/objects/networkObjectGroups
  • POST /policies/v2/objects/networkObjectGroups
  • GET /policies/v2/objects/networkObjectGroups/references
  • GET /policies/v2/objects/networkObjectGroups/{networkObjectGroupId}
  • GET /policies/v2/objects/networkObjectGroups/{networkObjectGroupId}/references
  • PUT /policies/v2/objects/networkObjectGroups/{networkObjectGroupId}
  • DELETE /policies/v2/objects/networkObjectGroups/{networkObjectGroupId} Service Objects:
  • GET /policies/v2/objects/serviceObjects
  • POST /policies/v2/objects/serviceObjects
  • GET /policies/v2/objects/serviceObjects/references
  • GET /policies/v2/objects/serviceObjects/{serviceObjectId}
  • GET /policies/v2/objects/serviceObjects/{serviceObjectId}/references
  • PUT /policies/v2/objects/serviceObjects/{serviceObjectId}
  • DELETE /policies/v2/objects/serviceObjects/{serviceObjectId} Service Object Groups:
  • GET /policies/v2/objects/serviceObjectGroups
  • POST /policies/v2/objects/serviceObjectGroups
  • GET /policies/v2/objects/serviceObjectGroups/references
  • GET /policies/v2/objects/serviceObjectGroups/{serviceObjectGroupId}
  • GET /policies/v2/objects/serviceObjectGroups/{serviceObjectGroupId}/references
  • PUT /policies/v2/objects/serviceObjectGroups/{serviceObjectGroupId}
  • DELETE /policies/v2/objects/serviceObjectGroups/{serviceObjectGroupId}
• Added the Reporting API.
  • All endpoints on /reports/v2/*
• 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
• Added the Metering API.
  • GET /reports/v2/usage/metrics

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.