API Changelog, Cisco Secure Access APIs

API Changelog

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

September 2, 2025

  • Third-Party Integrations API—Added the Third-Party Integrations API.

    • GET /admin/v2/integrations
    • GET /admin/v2/integrationTypes
    • GET /admin/v2/integrations/{intId}
    • GET /admin/v2/integrations/{intId}/credentials/{credId}
    • GET /admin/v2/integrations/{intId}/credentials/{credId}/value
    • POST /admin/v2/integrations
    • PUT /admin/v2/integrations
    • PATCH /admin/v2/integrations/{intId}
    • DELETE /admin/v2/integrations/{intId}
    • POST /admin/v2/integrations/{intId}/credentials

August 11, 2025

  • App Discovery API—Added the subcategory and subcategory_content_types query parameters and fields.

    • GET /reports/v2/appDiscovery/applications
    • GET /reports/v2/appDiscovery/applications/info

August 4, 2025

  • Identity Endpoints API—Added the Identity Endpoints API.

    • GET /deployments/v2/identities/registrations/{type}
    • PUT /deployments/v2/identities/registrations/{type}

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.

June 12, 2025

  • IPS Profiles API—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}

June 10, 2025

  • DNS Forwarders API—Added the DNS Forwarders API.

    • GET /deployments/v2/dnsForwarders
    • POST /deployments/v2/dnsForwarders
    • GET /deployments/v2/dnsForwarders/{dnsForwardersId}
    • PUT /deployments/v2/dnsForwarders/{dnsForwardersId}
    • DELETE /deployments/v2/dnsForwarders/{dnsForwardersId}

June 5, 2025

  • Content Categories API—Added an API endpoint for the Content Categories API.
    • GET /policies/v2/categorySettings
  • Security Profiles API—Added API endpoints for the Security Profiles API.
    • GET /policies/v2/securityProfiles
    • GET /policies/v2/securityProfiles/{profileId}
  • Tenant Controls Profiles API—Added an API endpoint for the Tenant Controls Profiles API.
    • GET /policies/v2/tenantControls/profiles
  • Application Categories—Added an API endpoint for the Application Categories API.
    • GET /policies/v2/applicationCategories

June 3, 2025

  • Network and Service Objects API—Added new API endpoints for importing Network Objects and Service Objects.
    • GET /policies/v2/objects/unifiedNetworkObjects
    • GET /policies/v2/objects/unifiedServiceObjects
    • POST /policies/v2/objects/networkObjects/upload
    • POST /policies/v2/objects/networkObjects/validate
    • POST /policies/v2/objects/serviceObjects/upload
    • POST /policies/v2/objects/serviceObjects/validate

May 22, 2025

  • Threat Intelligence Feeds API—Added the Threat Intelligence Feeds API.
    • GET /policies/v2/feeds
    • POST /policies/v2/feeds
    • GET /policies/v2/feeds/{feedId}
    • PUT /policies/v2/feeds/{feedId}
    • DELETE /policies/v2/feeds/{feedId}

May 21, 2025

  • S3 Bucket Key Rotation API—Added the S3 Bucket Key Rotation API.
    • POST /admin/v2/iam/rotateKey

May 7, 2025

  • Network Devices API—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}

March 31, 2025

  • App Discovery API—Added an API endpoint:
    • GET /reports/v2/appDiscovery/applications/info

March 11, 2025

  • Network Tunnel Groups and Regions API–Added these API endpoints:

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

  • Internal Networks API—Added the Internal Networks API endpoints.

    • GET /deployments/v2/internalnetworks
    • POST /deployments/v2/internalnetworks
    • GET /deployments/v2/internalnetworks/{internalNetworkId}
    • PUT /deployments/v2/internalnetworks/{internalNetworkId}
    • DELETE /deployments/v2/internalnetworks/{internalNetworkId}

December 19, 2024

  • Roaming Computers API—Added the swgStatus query parameter for the Roaming Computers API endpoint:
    • GET /deployments/v2/roamingcomputers
  • Roaming Computers API—Added the swgStatus and lastSyncSwgStatus fields to the response for the Roaming Computers API endpoints:
    • GET /deployments/v2/roamingcomputers
    • GET /deployments/v2/roamingcomputers/{deviceId}
    • PUT /deployments/v2/roamingcomputers/{deviceId}

December 9, 2024

  • 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}

November 14, 2024

  • Investigate API—Added the Secure Access Investigate API endpoints.

    • GET /investigate/v2/domains/categorization/{domain}
    • POST /investigate/v2/domains/categorization
    • GET /investigate/v2/domains/volume/{domain}
    • GET /investigate/v2/recommendations/name/{domain}.json
    • GET /investigate/v2/pdns/name/{domain}
    • GET /investigate/v2/pdns/domain/{domain}
    • GET /investigate/v2/pdns/ip/{ip}
    • GET /investigate/v2/pdns/raw/{anystring}
    • GET /investigate/v2/links/name/{domain}
    • GET /investigate/v2/security/name/{domain}
    • GET /investigate/v2/domains/risk-score/{domain}
    • GET /investigate/v2/bgp_routes/ip/{ip}/as_for_ip.json
    • GET /investigate/v2/bgp_routes/asn/{asn}/prefixes_for_asn.json
    • GET /investigate/v2/whois/{domain}
    • GET /investigate/v2/whois/{domain}/history
    • GET /investigate/v2/whois/nameservers/{nameserver}
    • GET /investigate/v2/whois/nameservers
    • GET /investigate/v2/whois/emails/{email}
    • GET /investigate/v2/whois/search/{searchField}/{regexExpression}
    • GET /investigate/v2/search/{expression}
    • GET /investigate/v2/topmillion
    • GET /investigate/v2/samples/{destination}
    • GET /investigate/v2/sample/{hash}
    • GET /investigate/v2/sample/{hash}/artifacts
    • GET /investigate/v2/sample/{hash}/connections
    • GET /investigate/v2/sample/{hash}/behaviors
    • GET /investigate/v2/timeline/{name}
    • GET /investigate/v2/subdomains/{domain}

November 4, 2024

  • 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}

October 31, 2024

  • Added counts and status fields and updated the filters query parameters on the Resource Connector Groups and Resource Connectors API.
  • 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 ipv6Count field on the Destination Lists API.

October 28, 2024

  • Updated a query parameter and request and response field on the Resource Connector Groups and Resource Connectors API. These changes support the deployment of Resource Connectors in Docker containers.
    • Updated the environment field with the container attribute in the Resource Connector Group request body and responses.
    • Updated the environment field with the container attribute in the filters query parameter for the Resource Connector Group list (GET) operation.

October 24, 2024

  • Added a query parameter and object to the Resource Connector Groups and Resource Connectors API. These additions are related to the DNS server and domains associated with the Resource Connector Group.
    • Added the forwardDNS object (dnsResourceId and domains) in the list Resource Connector Group response.
    • Added the dnsResourceId field to the filters query parameter for the Resource Connector Group list (GET) operation.
    • Added the forwardDNS field as a path on the request body of the Resource Connector Group PATCH operation. The value is a forwardDNS object.

October 14, 2024

Integration Guides

  • Added the Cisco Cloud Security Add-On for Splunk (version 1.0.34) guide to the Cloud Security Integration Guides. For more information, see Cisco Cloud Security Add-On for Splunk. This guide describes how to integrate the Umbrella and Secure Access event data sources with Splunk in the add-on.

October 7, 2024

  • Added the optional anyconnectDeviceId field to the response for these Roaming Computers API endpoints:
    • GET /deployments/v2/roamingcomputers
    • GET /deployments/v2/roamingcomputers/{deviceId}
    • PUT /deployments/v2/roamingcomputers/{deviceId}
  • 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

September 16, 2024

  • Added the OrgInfo API endpoint to the Roaming Computers API.
    • GET /deployments/v2/roamingcomputers/orgInfo

July 24, 2024

  • Added the VPN User Connections API.

    • GET /admin/v2/vpn/userConnections
    • PUT /admin/v2/vpn/userConnections

  • 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}

July 17, 2024

  • 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

July 8, 2024

  • Added the Zero Trust User Devices API.
    • GET /admin/v2/ztna/users/{userId}/deviceCertificates
    • GET /admin/v2/ztna/users/{userId}/devices/{deviceId}/certificates
    • GET /admin/v2/ztna/userSummaries
    • DELETE /admin/v2/ztna/users/{userId}/devices/{deviceId}

April 30, 2024

  • Added the Resource Connector Groups API.

    • GET /deployments/v2/connectorGroups
    • POST /deployments/v2/connectorGroups
    • GET /deployments/v2/connectorGroups/{id}
    • PUT /deployments/v2/connectorGroups/{id}
    • PATCH /deployments/v2/connectorGroups/{id}
    • DELETE /deployments/v2/connectorGroups/{id}
    • GET /deployments/v2/connectorGroups/counts

  • Added the Resource Connectors API.

    • GET /deployments/v2/connectorAgents
    • GET /deployments/v2/connectorAgents/{id}
    • PATCH /deployments/v2/connectorAgents/{id}
    • DELETE /deployments/v2/connectorAgents/{id}
    • GET /deployments/v2/connectorAgents/counts

  • Added the Resource Groups API.

    • 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 Private Resources API.

    • GET /policies/v2/privateResources
    • POST /policies/v2/privateResources
    • GET /policies/v2/privateResources/{id}
    • PUT /policies/v2/privateResources/{id}
    • DELETE /policies/v2/privateResources/{id}

April 25, 2024

  • Added the configuration of restricted networks on API keys in Secure Access. For more information, see Authentication.

February 2, 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 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 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.
    • 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