2025-03-03

Cisco Catalyst Center Platform API Release 2.3.7.9

New APIs

Feature	Description
Applications APIs	GET /dna/data/api/v1/networkApplications : Retrieves the list of network applications along with experience and health metrics. GET /dna/data/api/v1/networkApplications/count : Retrieves the total count of network applications by applying basic filtering. POST /dna/data/api/v1/networkApplications/trendAnalytics : Retrieves the Trend analytics data that are related to network applications.
Application Policy APIs	GET /dna/intent/api/v1/applicationVisibility/networkDevices : Retrieve the list of network devices with their application visibility status. GET /dna/intent/api/v1/applicationVisibility/networkDevices/count : Retrieve the count of network devices for the given application visibility status filters. POST /dna/intent/api/v1/applicationVisibility/networkDevices/enableAppTelemetry : Enable application telemetry feature on multiple network devices. POST /dna/intent/api/v1/applicationVisibility/networkDevices/disableAppTelemetry : Disable application telemetry feature on multiple network devices. POST /dna/intent/api/v1/applicationVisibility/networkDevices/enableCbar : Enable CBAR feature on multiple network devices. POST /dna/intent/api/v1/applicationVisibility/networkDevices/disableCbar : Disable CBAR feature on multiple network devices. GET /dna/intent/api/v1/qosPolicySetting : Retrieves the application QoS policy setting. PUT /dna/intent/api/v1/qosPolicySetting : Updates the application QoS policy setting.
Cisco Integrated Management Controller (IMC) APIs	GET /dna/system/api/v1/ciscoImcs : Retrieves Cisco IMC configurations for Catalyst Center nodes. POST /dna/system/api/v1/ciscoImcs : Adds Cisco IMC configuration to a Catalyst Center node. GET /dna/system/api/v1/ciscoImcs/${id} : Retrieves the Cisco IMC configuration for a Catalyst Center node. PUT /dna/system/api/v1/ciscoImcs/${id} : Updates the Cisco IMC configuration for a Catalyst Center node. DELETE /dna/system/api/v1/ciscoImcs/${id} : Deletes the Cisco IMC configurations for a Catalyst Center node.
Compliance APIs	POST /dna/intent/api/v1/networkBugs/trials : Creates a trial for bugs detection on network devices. GET /dna/intent/api/v1/networkBugs/trials : Get trial details for bugs detection on network devices. POST /dna/intent/api/v1/networkBugs/triggerScan : Triggers a bugs scan for the supported network devices. GET /dna/intent/api/v1/networkBugs/results/networkDevices/${networkDeviceId}/bugs/count : Get count of bugs affecting the network device. GET /dna/intent/api/v1/networkBugs/results/networkDevices/${networkDeviceId}/bugs : Get bugs affecting the network device. GET /dna/intent/api/v1/networkBugs/results/bugs/${id} : Get network bug by Id. GET /dna/intent/api/v1/networkBugs/results/bugs/${id}/networkDevices/count : Get count of network bug devices for the bug. GET /dna/intent/api/v1/networkBugs/results/bugs/${id}/networkDevices : Get network bug devices for the bug. GET /dna/intent/api/v1/networkBugs/results/bugs/${id}/networkDevices/${networkDeviceId} : Get network bug device for the bug by network device id. GET /dna/intent/api/v1/networkBugs/results/networkDevices/count : Get count of network bug devices. GET /dna/intent/api/v1/networkBugs/results/networkDevices : Get network bug devices. GET /dna/intent/api/v1/networkBugs/results/networkDevices/${networkDeviceId} : Get network bug device by device id. GET /dna/intent/api/v1/networkBugs/results/networkDevices/${networkDeviceId}/bugs/count : Get count of bugs affecting the network device. GET /dna/intent/api/v1/networkBugs/results/networkDevices/${networkDeviceId}/bugs : Get bugs affecting the network device. GET /dna/intent/api/v1/networkBugs/results/networkDevices/${networkDeviceId}/bugs/${id} : Get bug affecting the network device by device Id and bug id. GET /dna/intent/api/v1/networkBugs/resultsTrend/count : Get count of network bugs results trend over time. GET /dna/intent/api/v1/networkBugs/resultsTrend : Get network bugs results trend over time. POST /dna/intent/api/v1/fieldNotices/trials : Creates a trial for field notices detection on network devices. GET /dna/intent/api/v1/fieldNotices/trials : Get trial details for field notices detection on network devices. POST /dna/intent/api/v1/fieldNotices/triggerScan : Triggers a field notices scan for the supported network devices. GET /dna/intent/api/v1/fieldNotices/results/networkDevices/${networkDeviceId}/notices/count : Get count of field notices affecting the network device. GET /dna/intent/api/v1/fieldNotices/results/networkDevices/${networkDeviceId}/notices : Get field notices affecting the network device. GET /dna/intent/api/v1/fieldNotices/results/notices/${id} : Get field notice affecting the network devices by Id. GET /dna/intent/api/v1/fieldNotices/results/notices/${id}/networkDevices/count : Get count of field notice network devices for the notice. GET /dna/intent/api/v1/fieldNotices/results/notices/${id}/networkDevices : Get field notice network devices for the notice. GET /dna/intent/api/v1/fieldNotices/results/notices/${id}/networkDevices/${networkDeviceId} : Get field notice network device for the notice by network device id. GET /dna/intent/api/v1/fieldNotices/results/networkDevices/count : Get count of field notice network devices. GET /dna/intent/api/v1/fieldNotices/results/networkDevices : Get field notice network devices. GET /dna/intent/api/v1/fieldNotices/results/networkDevices/${networkDeviceId} : Get field notice network device by device id. GET /dna/intent/api/v1/fieldNotices/results/networkDevices/${networkDeviceId}/notices/count : Get count of field notices affecting the network device. GET /dna/intent/api/v1/fieldNotices/results/networkDevices/${networkDeviceId}/notices : Get field notices affecting the network device. GET /dna/intent/api/v1/fieldNotices/results/networkDevices/${networkDeviceId}/notices/${id} : Get field notice affecting the network device by device Id and notice id. GET /dna/intent/api/v1/fieldNotices/resultsTrend/count : Get count of field notices results trend over time. GET /dna/intent/api/v1/fieldNotices/resultsTrend : Get field notices results trend over time. POST /dna/intent/api/v1/securityAdvisories/trials : Creates a trial for security advisories detection on network devices. GET /dna/intent/api/v1/securityAdvisories/trials : Get trial details for security advisories detection on network devices. POST /dna/intent/api/v1/securityAdvisories/triggerScan : Triggers a security advisories scan for the supported network devices. GET /dna/intent/api/v1/securityAdvisories/results/advisories/count : Get count of security advisories affecting the network devices. GET /dna/intent/api/v1/securityAdvisories/results/advisories : Get security advisories affecting the network devices. GET /dna/intent/api/v1/securityAdvisories/results/advisories/${id} : Get security advisory affecting the network devices by Id. GET /dna/intent/api/v1/securityAdvisories/results/advisories/${id}/networkDevices/count : Get count of security advisory network devices for the security advisory. GET /dna/intent/api/v1/securityAdvisories/results/advisories/${id}/networkDevices : Get security advisory network devices for the security advisory. GET /dna/intent/api/v1/securityAdvisories/results/advisories/${id}/networkDevices/${networkDeviceId} : Get security advisory network device for the security advisory by network device id. GET /dna/intent/api/v1/securityAdvisories/results/networkDevices/count : Get count of security advisory network devices. GET /dna/intent/api/v1/securityAdvisories/results/networkDevices : Get security advisory network devices. GET /dna/intent/api/v1/securityAdvisories/results/networkDevices/${networkDeviceId} : Get security advisory network device by network device id. GET /dna/intent/api/v1/securityAdvisories/results/networkDevices/${networkDeviceId}/advisories/count : Get count of security advisories affecting the network device. GET /dna/intent/api/v1/securityAdvisories/results/networkDevices/${networkDeviceId}/advisories : Get security advisories affecting the network device. GET /dna/intent/api/v1/securityAdvisories/results/networkDevices/${networkDeviceId}/advisories/${id} : Get security advisory affecting the network device by device Id and advisory id. GET /dna/intent/api/v1/securityAdvisories/resultsTrend/count : Get count of security advisories results trend over time. GET /dna/intent/api/v1/securityAdvisories/resultsTrend : Get security advisories results trend over time.
Configuration Archive APIs	GET /dna/intent/api/v1/networkDeviceConfigFiles : Get Network Device Configuration File Details. GET /dna/intent/api/v1/networkDeviceConfigFiles/count : Count of Network Device Configuration Files. GET /dna/intent/api/v1/networkDeviceConfigFiles/${id} : Get Configuration File Details by ID. POST /dna/intent/api/v1/networkDeviceConfigFiles/${id}/downloadMasked : Download masked device configuration. POST /dna/intent/api/v1/networkDeviceConfigFiles/${id}/downloadUnmasked : Download Unmasked (raw) Device Configuration as ZIP.
Configuration Templates APIs	GET /dna/intent/api/v1/templates/${templateId}/networkProfilesForSites : Retrieve the network profiles attached to a CLI template. GET /dna/intent/api/v1/templates/${templateId}/networkProfilesForSites/count : Retrieve count of network profiles attached to a CLI template. POST /dna/intent/api/v1/templates/${templateId}/networkProfilesForSites : Attach network profile to a Day-N CLI template. POST /dna/intent/api/v1/templates/${templateId}/networkProfilesForSites/bulk : Attach a list of network profiles to a Day-N CLI template. DELETE /dna/intent/api/v1/templates/${templateId}/networkProfilesForSites/bulk : Detach a list of network profiles from a Day-N CLI template. DELETE /dna/intent/api/v1/templates/${templateId}/networkProfilesForSites/${profileId} : Detach a network profiles from a Day-N CLI template. GET /templates/${templateId}/versions : Get Template Versions. GET /dna/intent/api/v1/templates/${templateId}/versions/${versionId} : Get Template Version. GET /dna/intent/api/v1/templates/${templateId}/versions/count : Get Template Versions Count. POST /dna/intent/api/v1/templates/${templateId}/versions/commit : Commit Template For a New Version. GET /dna/intent/api/v1/projects : Get Template Projects. POST /dna/intent/api/v1/projects : Create Template Project. PUT /dna/intent/api/v1/projects/${projectId} : Update Template Project. GET /dna/intent/api/v1/projects/${projectId} : Get Template Project. DELETE /dna/intent/api/v1/projects/${projectId} : Delete Template. GET /dna/intent/api/v1/projects/count : Get Template Project Count.
Devices APIs	POST /dna/intent/api/v1/networkDevices/deleteWithoutCleanup : Delete a network device without configuration cleanup. POST /dna/intent/api/v1/networkDevices/deleteWithCleanup : Delete network device with configuration cleanup. GET /dna/data/api/v1/aaaServices : Retrieves the list of AAA Services for given parameters. GET /dna/data/api/v1/aaaServices/count : Retrieves the total number of AAA Services for given parameters. GET /dna/data/api/v1/aaaServices/${id} : Retrieves the details of a specific AAA Service matching the id of the Service. POST /dna/data/api/v1/aaaServices/query : Retrieves the list of AAA Services for given set of complex filters. POST /dna/data/api/v1/aaaServices/query/count : Retrieves the total number of AAA Services for given set of complex filters. POST /dna/data/api/v1/aaaServices/summaryAnalytics : Get summary analytics data of AAA Services for given set of complex filters. POST /dna/data/api/v1/aaaServices/topNAnalytics : Get Top N analytics data of AAA Services for given set of complex filters. POST /dna/data/api/v1/aaaServices/trendAnalytics : Get trend analytics data of AAA Services for given set of complex filters. POST /dna/data/api/v1/aaaServices/${id}/trendAnalytics : Get trend analytics data for a given AAA Service matching the id of the Service. GET /dna/data/api/v1/dhcpServices : Retrieves the list of DHCP Services for given parameters. GET /dna/data/api/v1/dhcpServices/count : Retrieves the total number of DHCP Services for given parameters. GET /dna/data/api/v1/dhcpServices/${id} : Retrieves the details of a specific DHCP Service matching the id of the Service. POST /dna/data/api/v1/dhcpServices/query : Retrieves the list of DHCP Services for given set of complex filters. POST /dna/data/api/v1/dhcpServices/query/count : Retrieves the total number of DHCP Services for given set of complex filters. POST /dna/data/api/v1/dhcpServices/summaryAnalytics : Get summary analytics data of DHCP Services for given set of complex filters. POST /dna/data/api/v1/dhcpServices/topNAnalytics : Get Top N analytics data of DHCP Services for given set of complex filters. POST /dna/data/api/v1/dhcpServices/trendAnalytics : Get trend analytics data of DHCP Services for given set of complex filters. POST /dna/data/api/v1/dhcpServices/${id}/trendAnalytics : Get trend analytics data for a given DHCP Service matching the id of the Service. GET /dna/data/api/v1/dnsServices : Retrieves the list of DNS Services for given parameters. GET /dna/data/api/v1/dnsServices/count : Retrieves the total number of DNS Services for given parameters. GET /dna/data/api/v1/dnsServices/${id} : Retrieves the details of a specific DNS Service matching the id of the Service. POST /dna/data/api/v1/dnsServices/query : Retrieves the list of DNS Services for given set of complex filters. POST /dna/data/api/v1/dnsServices/query/count : Retrieves the total number of DNS Services for given set of complex filters. POST /dna/data/api/v1/dnsServices/summaryAnalytics : Get summary analytics data of DNS Services for given set of complex filters. POST /dna/data/api/v1/dnsServices/topNAnalytics : Get Top N analytics data of DHCP Services for given set of complex filters. POST /dna/data/api/v1/dnsServices/trendAnalytics : Get trend analytics data of DNS Services for given set of complex filters. POST /dna/data/api/v1/dnsServices/${id}/trendAnalytics : Get trend analytics data for a given DNS Service matching the id of the Service. GET /dna/intent/api/v1/networkDeviceMaintenanceSchedules : Retrieve scheduled maintenance windows for network devices. POST /dna/intent/api/v1/networkDeviceMaintenanceSchedules : Create maintenance schedule for network devices. GET /dna/intent/api/v1/networkDeviceMaintenanceSchedules/count : Retrieve the total number of scheduled maintenance windows. GET /dna/intent/api/v1/networkDeviceMaintenanceSchedules/${id} : Retrieves the maintenance schedule information. PUT /dna/intent/api/v1/networkDeviceMaintenanceSchedules/${id} : Updates the maintenance schedule information. DELETE /dna/intent/api/v1/networkDeviceMaintenanceSchedules/${id} : Delete maintenance schedule. GET /dna/intent/api/v1/networkDevices : Retrieve network devices. GET /dna/intent/api/v1/networkDevices/${id} : Get details of a single network device. GET /dna/intent/api/v1/networkDevices/count : Count the number of network devices. POST /dna/intent/api/v1/networkDevices/query : Query network devices with filters. POST /dna/intent/api/v1/networkDevices/query/count : Count the number of network devices with filters. POST /dna/data/api/v1/networkDevices/topNAnalytics : Gets the Top-N analytics data related to network devices. POST /dna/data/api/v1/interfaces/${id}/trendAnalytics : The trend analytics data for the interfaces in the specified time range.
Device Replacement APIs	GET /dna/intent/api/v1/networkDeviceReplacements/${id} : Retrieve the status of device replacement workflow that replaces a faulty device with a replacement device. GET /dna/intent/api/v1/networkDeviceReplacements : Retrieve the status of all the device replacement workflows.
Fabric Wireless APIs	GET /dna/intent/api/v1/sda/fabrics/${fabricId}/switchWirelessSetting : Get SDA Wireless details from switches. PUT //dna/intent/api/v1/sda/fabrics/${fabricId}/wirelessMulticast : Update SDA Wireless Multicast. GET /dna/intent/api/v1/sda/fabrics/${fabricId}/wirelessMulticast : Get SDA Wireless Multicast. PUT /dna/intent/api/v1/sda/fabrics/${fabricId}/switchWirelessSetting : Switch Wireless Setting and Rolling AP Upgrade Management. POST //dna/intent/api/v1/sda/fabrics/${fabricId}/switchWirelessSetting/reload : Reload Switch for Wireless Controller Cleanup.
Health and Performance APIs	GET /dna/intent/api/v1/diagnosticTasks/${id} : Retrieves diagnostic task by ID. GET /dna/intent/api/v1/diagnosticTasks/${id}/detail : Retrieves diagnostic task details by ID.
Licenses APIs	GET /dna/intent/api/v1/connectionModeSetting : Retrieves CSSM connection mode. PUT /dna/intent/api/v1/connectionModeSetting : Update CSSM connection mode. GET /dna/system/api/v1/license/status : System licensing status. POST /dna/system/api/v1/license/register : Smart licensing registration. POST /dna/system/api/v1/license/renew : Smart licensing renew operation. POST /dna/system/api/v1/license/deregister : Smart licensing Deregistration. GET /dna/system/api/v1/license/lastOperationStatus : System licensing last operation status.
Network Settings APIs	GET /dna/intent/api/v1/networkProfilesForSites/${profileId}/templates : Retrieve CLI templates attached to a network profile. GET /dna/intent/api/v1/networkProfilesForSites/${profileId}/templates/count : Retrieve count of CLI templates attached to a network profile. GET /dna/intent/api/v1/ipam/globalIpAddressPools : Retrieves global IP address pools. POST /dna/intent/api/v1/ipam/globalIpAddressPools : Create a global IP address pool. GET /dna/intent/api/v1/ipam/globalIpAddressPools/${id} : Retrieves a global IP address pool. PUT /dna/intent/api/v1/ipam/globalIpAddressPools/${id} : Updates a global IP address pool. DELETE /dna/intent/api/v1/ipam/globalIpAddressPools/${id} : Deletes a global IP address pool. GET /dna/intent/api/v1/ipam/globalIpAddressPools/${globalIpAddressPoolId}/subpools : Retrieves subpools IDs of a global IP address pool. GET /dna/intent/api/v1/ipam/globalIpAddressPools/${globalIpAddressPoolId}/subpools/count : Counts subpools of a global IP address pool. GET /dna/intent/api/v1/ipam/globalIpAddressPools/count : Counts global IP address pools. GET /dna/intent/api/v1/ipam/siteIpAddressPools : Retrieves IP address subpools. POST /dna/intent/api/v1/ipam/siteIpAddressPools : Reserve (create) IP address subpools. GET /dna/intent/api/v1/ipam/siteIpAddressPools/${id} : Retrieves an IP address subpool. PUT /dna/intent/api/v1/ipam/siteIpAddressPools/{id} : Updates an IP address subpool. DELETE /dna/intent/api/v1/ipam/siteIpAddressPools/{id} : Releases an IP address subpool. GET /dna/intent/api/v1/ipam/siteIpAddressPools/count : Counts IP address subpools.
SDA APIs	GET /dna/intent/api/v1/sda/pendingFabricEvents : Get Pending Fabric Events. POST /dna/intent/api/v1/sda/pendingFabricEvents/apply : Apply Pending Fabric Events. GET /dna/data/api/v1/fabricSummary : Read Fabric entity summary. GET /dna/data/api/v1/fabricSiteHealthSummaries : Read list of Fabric Sites with their health summary. GET /dna/data/api/v1/fabricSiteHealthSummaries/${id} : Read Fabric Sites with health summary from ID. GET /dna/data/api/v1/fabricSiteHealthSummaries/${id}/trendAnalytics : The Trend analytics data for a fabric site in the specified time range. GET /dna/data/api/v1/fabricSiteHealthSummaries/count : Read fabric site count. GET //dna/data/api/v1/virtualNetworkHealthSummaries : Read list of Virtual Networks with their health summary. GET /dna/data/api/v1/virtualNetworkHealthSummaries/${id} : Read virtual network with its health summary from ID. GET /dna/data/api/v1/virtualNetworkHealthSummaries/count : Read Virtual Networks count. GET /dna/data/api/v1/virtualNetworkHealthSummaries/${id}/trendAnalytics : The Trend analytics data for a virtual network in the specified time range. GET //dna/data/api/v1/transitNetworkHealthSummaries : Read list of Transit Networks with their health summary. GET /dna/data/api/v1/transitNetworkHealthSummaries/${id} : Read transit network with its health summary from ID. GET /dna/data/api/v1/transitNetworkHealthSummaries/count : Read Transit Networks count. GET /dna/data/api/v1/transitNetworkHealthSummaries/${id}/trendAnalytics : The Trend analytics data for a transit network in the specified time range.
Sensor APIs	GET /dna/data/api/v1/icap/captureFiles : Lists ICAP packet capture files matching specified criteria. GET /dna/data/api/v1/icap/captureFiles/count : Retrieves the total number of packet capture files matching specified criteria. GET /dna/data/api/v1/icap/captureFiles/${id} : Retrieves details of a specific ICAP packet capture file. GET /dna/data/api/v1/icap/captureFiles/${id}/download : Downloads a specific ICAP packet capture file. GET /dna/data/api/v1/icap/spectrumSensorReports : Retrieves the spectrum sensor reports sent by WLC for provided AP Mac. GET /dna/data/api/v1/icap/spectrumInterferenceDeviceReports : Retrieves the spectrum interference devices reports sent by WLC for provided AP Mac. POST /dna/data/api/v1/icap/clients/${id}/stats : Retrieves specific client statistics over specified period of time. POST /dna/data/api/v1/icap/radios/${id}/stats : Retrieves specific radio statistics over specified period of time. POST /dna/intent/api/v1/icapSettings/deploy : Deploys the given ICAP configuration intent without preview and approve. POST /dna/intent/api/v1/icapSettings/deploy/${id}/deleteDeploy : Remove the ICAP configuration on the device without preview. POST /dna/intent/api/v1/icapSettings/configurationModels : Creates an ICAP configuration intent for preview-approve. POST /dna/intent/api/v1/icapSettings/configurationModels/${id}/deleteDeploy : Creates a ICAP configuration workflow for ICAP intent to remove the ICAP configuration on the device. GET /dna/intent/api/v1/icapSettings/configurationModels/${previewActivityId}/networkDeviceStatusDetails : Get ICAP configuration status per network device. POST /dna/intent/api/v1/icapSettings/configurationModels/${previewActivityId}/networkDevices/${networkDeviceId}/config : Generates the device's CLIs of the ICAP configuration intent. GET /dna/intent/api/v1/icapSettings/configurationModels/${previewActivityId}/networkDevices/${networkDeviceId}/config : Retrieves the device's CLIs of the ICAP intent. DELETE /dna/intent/api/v1/icapSettings/configurationModels/${previewActivityId} : Discards the ICAP configuration intent by activity ID. DELETE /dna/intent/api/v1/icapSettings/configurationModels/${previewActivityId}/deploy : Deploys the ICAP configuration intent by activity ID. GET /dna/intent/api/v1/icapSettings/deviceDeployments : Get device deployment status. GET /dna/intent/api/v1/icapSettings/deviceDeployments/count : Get device deployment status count. GET /dna/intent/api/v1/icapSettings : Retrieves deployed ICAP configurations while supporting basic filtering. GET /dna/intent/api/v1/icapSettings/count : Retrieves the count of deployed ICAP configurations while supporting basic filtering.
Site Design APIs	GET /dna/intent/api/v2/floors/${floorId}/accessPointPositions : Get Access Points positions. GET /dna/intent/api/v2/floors/${floorId}/accessPointPositions/count : Get Access Points positions count. POST /dna/intent/api/v2/floors/${floorId}/accessPointPositions/bulkChange : Edit the Access Points Positions. POST /dna/intent/api/v2/floors/${floorId}/plannedAccessPointPositions/bulk : Add Planned Access Points Positions. POST /dna/intent/api/v2/floors/${floorId}/plannedAccessPointPositions/bulkChange : Edit Planned Access Points Positions. DELETE /dna/intent/api/v2/floors/${floorId}/plannedAccessPointPositions/${id} : Delete Planned Access Points Position. GET /dna/intent/api/v2/floors/${floorId}/plannedAccessPointPositions : Get Planned Access Points Positions. GET /dna/intent/api/v2/floors/${floorId}/plannedAccessPointPositions/count : Get Planned Access Points Positions count. POST /dna/intent/api/v2/floors/${floorId}/plannedAccessPointPositions/assignAccessPointPositions : Assign Planned Access Points to operations ones.
SWIM APIs	POST /dna/intent/api/v1/images/ccoSync : Initiates sync of software images from Cisco.com. GET dna/intent/api/v1/siteWiseImagesSummary : Returns the image summary for the given site. DELETE /dna/intent/api/v1/images/${id} : Delete image. POST /dna/intent/api/v1/images/${id}/sites/${siteId}/tagGolden : Tagging golden image. POST /dna/intent/api/v1/images/${id}/sites/${siteId}/untagGolden : Untagging golden image.
Tag APIs	PUT /dna/intent/api/v1/tags/networkDevices/membersAssociations/bulk : Update tags associated with the network devices. PUT /dna/intent/api/v1/tags/interfaces/membersAssociations/bulk : Update tags associated with the interfaces.
Task APIs	GET /dna/intent/api/v1/activities/${activityId}/triggeredJobs/count : Retrieves the count of triggered jobs by activity ID. GET /dna/intent/api/v1/activities : Get activities. GET /dna/intent/api/v1/activities/count : Retrieves the count of activities. GET /dna/intent/api/v1/activities/${id} : Get activity by ID. GET /dna/intent/api/v1/activities/${activityId}/triggeredJobs : Get triggered jobs by activity ID.
Wireless APIs	GET /dna/intent/api/v1/wirelessSettings/anchorGroups : Get Anchor Groups POST /dna/intent/api/v1/wirelessSettings/anchorGroups : Create anchorGroup GET /dna/intent/api/v1/wirelessSettings/anchorGroups/${id} : Get AnchorGroup by ID PUT /dna/intent/api/v1/wirelessSettings/anchorGroups/${id} : Update AnchorGroup DELETE /dna/intent/api/v1/wirelessSettings/anchorGroups/${id} : Delete anchorGroup by ID GET /dna/intent/api/v1/wirelessSettings/anchorGroups/count : Get count of anchorGroups GET /dna/intent/api/v1/wirelessControllers/anchorCapableDevices : Get Anchor capable devices GET /dna/intent/api/v1/wirelessSettings/apAuthorizationLists : Get AP Authorization Lists POST /dna/intent/api/v1/wirelessSettings/apAuthorizationLists : Create AP Authorization List POST /dna/intent/api/v1/wirelessSettings/apAuthorizationLists/${id} : Get AP Authorization List by ID PUT /dna/intent/api/v1/wirelessSettings/apAuthorizationLists/${id} : Update AP Authorization List DELETE /dna/intent/api/v1/wirelessSettings/apAuthorizationLists/${id} : Delete AP Authorization List GET /dna/intent/api/v1/wirelessSettings/apAuthorizationLists/count : Get AP Authorization List Count GET /dna/intent/api/v1/wirelessControllers/${networkDeviceId}/apAuthorizationLists : Get AP Authorization List by network device ID GET /dna/intent/api/v1/wirelessSettings/powerProfiles : Get Power Profiles POST /dna/intent/api/v1/wirelessSettings/powerProfiles : Create Power Profile GET /dna/intent/api/v1/wirelessSettings/powerProfiles/${id} : Get Power Profile by ID PUT /dna/intent/api/v1/wirelessSettings/powerProfiles/${id} : Update Power Profile by ID DELETE /dna/intent/api/v1/wirelessSettings/powerProfiles/${id} : Delete Power Profile by ID GET /dna/intent/api/v1/wirelessSettings/powerProfiles/count : Get Power Profiles Count GET /dna/intent/api/v1/wirelessControllers/meshApNeighbours : Get Mesh Ap Neighbours GET /dna/intent/api/v1/wirelessControllers/meshApNeighbours/count : Get Mesh Ap Neighbours Count POST /dna/intent/api/v1/sites/${siteId}/wirelessSettings/ssids/${id}/update : Update or override SSID. GET /dna/intent/api/v1/wirelessSettings/ssids/overrideAtSites : Retrieve sites with overridden SSIDs. GET /dna/intent/api/v1/wirelessSettings/apProfiles : Get AP Profiles. POST /dna/intent/api/v1/wirelessSettings/apProfiles : Create AP Profile. GET /dna/intent/api/v1/wirelessSettings/apProfiles/${id} : Get AP Profile by ID. PUT /dna/intent/api/v1/wirelessSettings/apProfiles/${id} : Update AP Profile by ID. DELETE /dna/intent/api/v1/wirelessSettings/apProfiles/${id} : Delete AP Profile by ID. GET /dna/intent/api/v1/wirelessSettings/apProfiles/count : Get AP Profiles Count. GET /dna/intent/api/v1/wirelessProfiles/${id}/siteTags : Retrieve all Site Tags for a Wireless Profile. POST /dna/intent/api/v1/wirelessProfiles/${id}/siteTags/bulk : Create multiple Site Tags for a Wireless Profile in bulk. GET /dna/intent/api/v1/wirelessProfiles/${id}/siteTags/${siteTagId} : Retrieve a specific Site Tag for a Wireless Profile. GET /dna/intent/api/v1/wirelessProfiles/${id}/siteTags/${siteTagId} : Update a specific Site Tag for a Wireless Profile. DELETE /dna/intent/api/v1/wirelessProfiles/${id}/siteTags/${siteTagId} : Delete a specific Site Tag from a Wireless Profile. GET /dna/intent/api/v1/wirelessProfiles/${id}/siteTags/count : Retrieve the count of Site Tags for a Wireless Profile. GET /dna/intent/api/v1/wirelessProfiles/${id}/policyTags : Retrieve all Policy Tags for a Wireless Profile. POST /dna/intent/api/v1/wirelessProfiles/${id}/policyTags/bulk : Create multiple Policy Tags for a Wireless Profile in bulk. GET /dna/intent/api/v1/wirelessProfiles/${id}/policyTags/${policyTagId} : Retrieve a specific Policy Tag for a Wireless Profile. PUT /dna/intent/api/v1/wirelessProfiles/${id}/policyTags/${policyTagId} : Update a specific Policy Tag for a Wireless Profile. DELETE /dna/intent/api/v1/wirelessProfiles/${id}/policyTags/${policyTagId} : Delete a specific Policy Tag from a Wireless Profile. GET /dna/intent/api/v1/wirelessProfiles/${id}/policyTags/count : Retrieve the count of Policy Tags for a Wireless Profile. GET /dna/intent/api/v1/wirelessSettings/${networkDeviceId}/assignAnchorManagedApLocations : Assign Anchor Managed AP Locations For WLC. GET /dna/intent/api/v1/wireless/accesspoint-configuration/count : Get Access Point Configuration Count.

Beta APIs

With this release, Catalyst Center platform includes the following Campus Automation Beta APIs:

Feature	Description
Wired APIs	POST dna/intent/api/v1/wired/networkDevices/${networkDeviceId}/configFeatures/intended/configurationModels : Create a configuration model for the intended configs for a wired device. PUT /dna/intent/api/v1/wired/networkDevices/${id}/configFeatures/intended/layer2/${feature} : Update configurations for an intended layer 2 feature on a wired device. GET /dna/intent/api/v1/wired/networkDevices/${id}/configFeatures/deployed/layer2/${feature} : Get configurations for a deployed layer 2 feature on a wired device. GET /dna/intent/api/v1/wired/networkDevices/${id}/configFeatures/deployed/layer2/${feature}/count : Get number of configurations for a deployed layer 2 feature on a wired device. POST /dna/intent/api/v1/wired/networkDevices/${networkDeviceId}/configFeatures/intended/deploy : Deploy the intended configuration features on a wired device. PUT /dna/intent/api/v1/wired/networkDevices/${id}/configFeatures/intended/layer2 : Update configurations for intended layer 2 features on a wired device. GET /dna/intent/api/v1/wired/networkDevices/${id}/configFeatures/supported/layer2 : Get the supported layer 2 features on a wired device. GET /dna/intent/api/v1/wired/networkDevices/${networkDeviceId}/configFeatures/intended/serviceDeployments : Get service deployment status. POST /dna/intent/api/v1/wired/networkDevices/${networkDeviceId}/configFeatures/intended/configurationModels/${previewActivityId}/config : Generate the device config for the configuration model. POST /dna/intent/api/v1/intent/api/v1/wired/networkDevices/${networkDeviceId}/configFeatures/intended/configurationModels/${previewActivityId}/deploy : Deploys the configuration model on the network device. DELETE /dna/intent/api/v1/wired/networkDevices/${id}/configFeatures/intended/layer2/${feature} : Delete configurations for an intended layer 2 feature on a wired device. GET /dna/intent/api/v1/wired/networkDevices/${id}/configFeatures/intended/layer2/${feature} : Get configurations for an intended layer 2 feature on a wired device. DELETE /dna/intent/api/v1/wired/networkDevices/${networkDeviceId}/configFeatures/intended/configurationModels/${previewActivityId} : Delete the configuration model. POST /dna/intent/api/v1/wired/networkDevices/${id}/configFeatures/intended/layer2/${feature} : Create configurations for an intended layer 2 feature on a wired device. GET /dna/intent/api/v1/wired/networkDevices/${id}/configFeatures/intended/layer2/${feature}/count : Get number of configurations for an intended layer 2 feature on a wired device. GET /dna/intent/api/v1/wired/networkDevices/${networkDeviceId}/configFeatures/intended/configurationModels/${previewActivityId}/config : Gets the device config for the configuration model. POST /dna/intent/api/v1/wired/networkDevices/${id}/configFeatures/intended/layer2 : Create configurations for intended layer 2 features on a wired device. GET /dna/intent/api/v1/wired/networkDevices/${networkDeviceId}/configFeatures/intended/deviceDeployments : Get device deployment status. GET /dna/intent/api/v1/intent/api/v1/wired/networkDevices/${id}/configFeatures/intended/layer2 : Get configurations for intended layer 2 features on a wired device.

Feature

Description

Wired APIs

POST dna/intent/api/v1/wired/networkDevices/${networkDeviceId}/configFeatures/intended/configurationModels : Create a configuration model for the intended configs for a wired device.
PUT /dna/intent/api/v1/wired/networkDevices/${id}/configFeatures/intended/layer2/${feature} : Update configurations for an intended layer 2 feature on a wired device.
GET /dna/intent/api/v1/wired/networkDevices/${id}/configFeatures/deployed/layer2/${feature} : Get configurations for a deployed layer 2 feature on a wired device.
GET /dna/intent/api/v1/wired/networkDevices/${id}/configFeatures/deployed/layer2/${feature}/count : Get number of configurations for a deployed layer 2 feature on a wired device.
POST /dna/intent/api/v1/wired/networkDevices/${networkDeviceId}/configFeatures/intended/deploy : Deploy the intended configuration features on a wired device.
PUT /dna/intent/api/v1/wired/networkDevices/${id}/configFeatures/intended/layer2 : Update configurations for intended layer 2 features on a wired device.
GET /dna/intent/api/v1/wired/networkDevices/${id}/configFeatures/supported/layer2 : Get the supported layer 2 features on a wired device.
GET /dna/intent/api/v1/wired/networkDevices/${networkDeviceId}/configFeatures/intended/serviceDeployments : Get service deployment status.
POST /dna/intent/api/v1/wired/networkDevices/${networkDeviceId}/configFeatures/intended/configurationModels/${previewActivityId}/config : Generate the device config for the configuration model.
POST /dna/intent/api/v1/intent/api/v1/wired/networkDevices/${networkDeviceId}/configFeatures/intended/configurationModels/${previewActivityId}/deploy : Deploys the configuration model on the network device.
DELETE /dna/intent/api/v1/wired/networkDevices/${id}/configFeatures/intended/layer2/${feature} : Delete configurations for an intended layer 2 feature on a wired device.
GET /dna/intent/api/v1/wired/networkDevices/${id}/configFeatures/intended/layer2/${feature} : Get configurations for an intended layer 2 feature on a wired device.
DELETE /dna/intent/api/v1/wired/networkDevices/${networkDeviceId}/configFeatures/intended/configurationModels/${previewActivityId} : Delete the configuration model.
POST /dna/intent/api/v1/wired/networkDevices/${id}/configFeatures/intended/layer2/${feature} : Create configurations for an intended layer 2 feature on a wired device.
GET /dna/intent/api/v1/wired/networkDevices/${id}/configFeatures/intended/layer2/${feature}/count : Get number of configurations for an intended layer 2 feature on a wired device.
GET /dna/intent/api/v1/wired/networkDevices/${networkDeviceId}/configFeatures/intended/configurationModels/${previewActivityId}/config : Gets the device config for the configuration model.
POST /dna/intent/api/v1/wired/networkDevices/${id}/configFeatures/intended/layer2 : Create configurations for intended layer 2 features on a wired device.
GET /dna/intent/api/v1/wired/networkDevices/${networkDeviceId}/configFeatures/intended/deviceDeployments : Get device deployment status.
GET /dna/intent/api/v1/intent/api/v1/wired/networkDevices/${id}/configFeatures/intended/layer2 : Get configurations for intended layer 2 features on a wired device.

API Enhancements

Feature	Description
Compliance API	With this release, the status and remediationSupported properties are added in the request query parameter of the Compliance Details of Device API, and a new response parameter called remediationSupported is introduced.
Devices APIs	The following Devices APIs now include the new response attributes physicalPortCount and virtualPortCount: Get the device data for the given device id (Uuid). Gets the Network Device details based on the provided query parameters. Gets the list of Network Devices based on the provided complex filters and aggregation functions.
SDA APIs	The Delete Port Channel API now includes the PortchannelIds and connectedDeviceType request parameters. The networkDeviceId parameter is now optional. With this release, a new request parameter called isGlobalAuthenticationProfile is added to the Get Authentication Profiles API. The fabricId request attribute is now optional in the Get Authentication Profiles and Update Authentication Profiles APIs.
Wireless APIs	With this release: The anchorGroupName, vlanGroupName, additionalInterfaces, apZones, apZoneName, rfProfileName and ssids attributes are included in the Update Wireless Profile, Create Wireless Profile, Get Wireless Profiles and Get Wireless Profile by ID APIs. A new response parameter called provisioningStatus is included in the Get Access Point Configuration API.

Deprecated APIs

A Sunset banner indicates that the particular API will be deprecated. If there is an alternative API, the details are given under the respective deprecated API's Features tab.

Feature	Description
Discovery API	POST /dna/intent/api/v1/discovery : Delete all discovery.
Event Management APIs	POST /dna/intent/api/v1/event/subscription : Create Event Subscriptions. PUT /dna/intent/api/v1/event/subscription : Update Event Subscriptions. GET /dna/intent/api/v1/event/subscription : Get Event Subscriptions.
Network Settings APIs	POST /dna/intent/api/v1/global-pool : Create Global Pool. GET /dna/intent/api/v1/global-pool : Get Global Pool. PUT /dna/intent/api/v1/global-pool : Update Global Pool. DELETE /dna/intent/api/v1/global-pool/${id} : Delete Global IP Pool. POST /dna/intent/api/v1/reserve-ip-subpool/${siteId} : Reserve IP Subpool. GET /dna/intent/api/v1/reserve-ip-subpool : Get Reserve IP Subpool. PUT /dna/intent/api/v1/reserve-ip-subpool/${siteId} : Update Reserve IP Subpool. DELETE /dna/intent/api/v1/reserve-ip-subpool/${id} : Release Reserve IP Subpool.
SDA APIs	Fabric Creation APIs POST /dna/intent/api/v1/business/sda/fabric : Add Fabric Site. GET /dna/intent/api/v1/business/sda/fabric : Get SDA Fabric Info. DELETE /dna/intent/api/v1/business/sda/fabric : Delete SDA Fabric. Fabric Site in SDA Fabric APIs POST /dna/intent/api/v1/business/sda/fabric-site : Add Site in SDA Fabric. GET /dna/intent/api/v1/business/sda/fabric-site : Get Site from SDA Fabric. DELETE /dna/intent/api/v1/business/sda/fabric-site : Delete Site from SDA Fabric. Fabric Zone in SDA fabric APIs POST /dna/intent/api/v1/business/sda/fabric-zone : Add fabric zone in SDA Fabric. GET /dna/intent/api/v1/business/sda/fabric-zone : Get fabric zone from SDA Fabric. DELETE /dna/intent/api/v1/business/sda/fabric-zone : Delete fabric zone from SDA Fabric. Control Plane Device APIs POST /dna/intent/api/v1/business/sda/control-plane-device : Add control plane device. GET /dna/intent/api/v1/business/sda/control-plane-device : Get control plane device. DELETE /dna/intent/api/v1/business/sda/control-plane-device : Delete control plane device in SDA Fabric. Edge-Device Role Assignment APIs POST /dna/intent/api/v1/business/sda/edge-device : Add edge device. GET /dna/intent/api/v1/business/sda/edge-device : Get edge device. DELETE /dna/intent/api/v1/business/sda/edge-device : Delete edge device. Border Device Role Assignment APIs POST /dna/intent/api/v1/business/sda/border-device : Adds border device in SDA Fabric. GET /dna/intent/api/v1/business/sda/border-device : Gets border device detail from SDA Fabric. DELETE /dna/intent/api/v1/business/sda/border-device : Deletes border device from SDA Fabric. Default Authentication Template (Profile) APIs PUT /dna/intent/api/v1/business/sda/authentication-profile : Update default authentication profile. POST /dna/intent/api/v1/business/sda/authentication-profile : Add default authentication profile. GET /dna/intent/api/v1/business/sda/authentication-profile : Get default authentication profile. DELETE /dna/intent/api/v1/business/sda/authentication-profile : Delete default authentication profile. Virtual Network Creation APIs POST /dna/intent/api/v1/business/sda/virtual-network : Add VN in SDA Fabric. GET /dna/intent/api/v1/business/sda/virtual-network : Get VN from SDA Fabric. DELETE /dna/intent/api/v1/business/sda/virtual-network : Delete VN from SDA Fabric. GET /dna/intent/api/v1/business/sda/virtual-network/summary : Get Virtual Network Summary. SDA Segment APIs POST /dna/intent/api/v1/business/sda/virtualnetwork/ippool : Add IP Pool in SDA Virtual Network. GET /dna/intent/api/v1/business/sda/virtualnetwork/ippool : Get IP Pool in SDA Virtual Network. DELETE /dna/intent/api/v1/business/sda/virtualnetwork/ippool : Delete IP Pool in SDA Virtual Network. Port Assignment for User Devices APIs POST /dna/intent/api/v1/business/sda/hostonboarding/user-device : Add Port assignment for user device. GET /dna/intent/api/v1/business/sda/hostonboarding/user-device : Get Port assignment for user device. DELETE /dna/intent/api/v1/business/sda/hostonboarding/user-device : Delete Port assignment for user device. Port Assignment to Access Points APIs POST /dna/intent/api/v1/business/sda/hostonboarding/access-point : Add Port assignment for access point. GET /dna/intent/api/v1/business/sda/hostonboarding/access-point : Get Port assignment for access point. DELETE /dna/intent/api/v1/business/sda/hostonboarding/access-point : Delete Port assignment for access point. SDA Multicast APIs POST /dna/intent/api/v1/business/sda/multicast : Add multicast. GET /dna/intent/api/v1/business/sda/multicast : Get multicast. DELETE /dna/intent/api/v1/business/sda/multicast : Delete multicast. Wired Device Provisioning APIs POST /dna/intent/api/v1/business/sda/provision-device : Provision Wired Device. GET /dna/intent/api/v1/business/sda/provision-device : Get Provision Wired Device. DELETE /dna/intent/api/v1/business/sda/provision-device : Delete Provision Wired Device. PUT /dna/intent/api/v1/business/sda/provision-device : Re-Provision Wired Device. Virtual Network APIs POST /dna/intent/api/v1/virtual-network : Add virtual network with scalable groups. GET /dna/intent/api/v1/virtual-network : Get virtual network with scalable groups. DELETE /dna/intent/api/v1/virtual-network : Delete virtual network with scalable groups. PUT /dna/intent/api/v1/virtual-network : Update virtual network with scalable groups. Transit and Peer Networks APIs POST /dna/intent/api/v1/business/sda/transit-peer-network : Add Transit Peer Network. GET /dna/intent/api/v1/business/sda/transit-peer-network : Get Transit Peer Network. DELETE /dna/intent/api/v1/business/sda/transit-peer-network : Delete Transit Peer Network. Retrieve Device Information from SDA fabric API GET /dna/intent/api/v1/business/sda/device : Get device info from SDA Fabric. Get SDA Device Role for a given device API GET /dna/intent/api/v1/business/sda/device/role : Get device role in SDA Fabric. Get Number of Fabric - Cyclops API GET /dna/intent/api/v1/business/sda/fabric/count : Get SDA Fabric Count.
Security Advisories APIs	GET /dna/intent/api/v1/security-advisory/advisory/aggregate : Get Advisories Summary. GET /dna/intent/api/v1/security-advisory/device/${deviceId} : Get Advisory Device Detail. GET /dna/intent/api/v1/security-advisory/advisory : Get Advisories List. GET /dna/intent/api/v1/security-advisory/device/${deviceId}/advisory : Get Advisories Per Device. GET /dna/intent/api/v1/security-advisory/advisory/${advisoryId}/device : Get Devices Per Advisory.
SWIM APIs	GET /dna/intent/api/v1/image/importation : Get software image details. GET /dna/intent/api/v1/image/importation/device-family-identifiers : Get Device Family Identifiers. POST /dna/intent/api/v1/image/importation/golden : Tag as Golden Image. GET /dna/intent/api/v1/image/importation/golden/site/${siteId}/family/${deviceFamilyIdentifier}/role/${deviceRole}/image/${imageId}Swagger doc : Get Golden Tag Status of an Image. DELETE /dna/intent/api/v1/image/importation/golden/site/${siteId}/family/${deviceFamilyIdentifier}/role/${deviceRole}/image/${imageId} : Remove Golden Tag for image.

API Changes That Break Backward Compatibility

Feature	Description
None	-

For more information, see the Release Notes for Cisco Catalyst Center, Release 2.3.7.x.

2024-08-02

Cisco Catalyst Center Platform API Release 2.3.7.6

New APIs

Feature	Description
Cisco Trusted Certificates API	POST /dna/intent/api/v1/trustedCertificates/import : Imports trusted certificate into a truststore. Accepts .pem or .der file as input.
Clients API	GET /dna/data/api/v1/clients : Retrieves the list of clients, while also offering basic filtering and sorting capabilities. GET /dna/data/api/v1/clients/${id} : Retrieves specific client information matching the MAC address. GET /dna/data/api/v1/clients/count : Retrieves the total count of clients by applying basic filtering. POST /dna/data/api/v1/clients/query : Retrieves the list of clients by applying complex filters while also supporting aggregate attributes. POST /dna/data/api/v1/clients/query/count : Retrieves the number of clients by applying complex filters. POST /dna/data/api/v1/clients/trendAnalytics : Retrieves the Trend analytics data related to clients. POST /dna/data/api/v1/clients/${id}/trendAnalytics : Retrieves specific client information over a specified period of time. POST /dna/data/api/v1/clients/summaryAnalytics : Retrieves summary analytics data related to clients. POST /dna/data/api/v1/clients/topNAnalytics : Retrieves the Top-N analytics data related to clients.
Compliance API	POST /dna/intent/api/v1/compliance/networkDevices/${id}/issues/remediation/provision : Compliance Remediation.
Devices APIs	PUT /dna/intent/api/v1/networkDevices/resyncIntervalSettings : Update global resync interval. PUT /dna/intent/api/v1/networkDevices/${id}/resyncIntervalSettings : Update resync interval for the network device. GET /dna/intent/api/v1/networkDevices/${id}/resyncIntervalSettings : Get resync interval for the network device. POST /dna/intent/api/v1/networkDevices/resyncIntervalSettings/override : Override resync interval. GET /dna/data/api/v1/assuranceEvents : Query assurance events. GET /dna/data/api/v1/assuranceEvents/count : Count the number of events. GET /dna/data/api/v1/assuranceEvents/${id} : Get details of a single assurance event. GET /dna/data/api/v1/assuranceEvents/${id}/childEvents : Get list of child events for the given wireless client event. POST /dna/data/api/v1/assuranceEvents/query : Query assurance events with filters. POST /dna/data/api/v1/assuranceEvents/query/count : Count the number of events with filters. PUT /dna/intent/api/v1/healthScoreDefinitions/${id} : Update health score definition for the given ID. GET /dna/intent/api/v1/healthScoreDefinitions : Get all health score definitions for given filters. GET /dna/intent/api/v1/healthScoreDefinitions/${id} : Get health score definition for the given ID. GET /dna/intent/api/v1/healthScoreDefinitions/count : Get the count of health score definitions based on provided filters. POST /dna/intent/api/v1/healthScoreDefinitions/bulkUpdate : Update health score definitions. GET /dna/data/api/v1/networkDevices : Gets the Network Device details based on the provided query parameters. GET /dna/data/api/v1/networkDevices/{id} : Get the device data for the given device ID (Uuid). GET /dna/data/api/v1/networkDevices/count : Gets the total Network Device counts based on the provided query parameters. POST /dna/data/api/v1/networkDevices/query : Gets the list of Network Devices based on the provided complex filters and aggregation functions. POST /dna/data/api/v1/networkDevices/query/count : Gets the total number of Network Devices based on the provided complex filters and aggregation functions. POST /dna/data/api/v1/networkDevices/trendAnalytics : Gets the Trend analytics data. POST /dna/data/api/v1/networkDevices/${id}/trendAnalytics : The Trend analytics data for the network Device in the specified time range. POST /dna/data/api/v1/networkDevices/summaryAnalytics : Gets the summary analytics data related to network devices. GET /dna/data/api/v1/interfaces : Gets interfaces along with statistics data from all network devices. GET /dna/data/api/v1/interfaces/${id} : Get the interface data for the given interface ID (instance Uuid) along with the statistics data. GET /dna/data/api/v1/interfaces/count : Gets the total Network device interface counts in the specified time range. When there is no start and end time specified returns the latest interfaces total count. POST /dna/data/api/v1/interfaces/query : Gets the list of interfaces across the Network Devices based on the provided complex filters and aggregation functions. POST /dna/data/api/v1/interfaces/query/count : The Total interfaces count across the Network devices.
Fabric Wireless APIs	PUT /dna/intent/api/v1/sda/fabrics/${fabricId}/vlanToSsids : Add, Update or Remove SSID mapping to a VLAN. GET /dna/intent/api/v1/sda/fabrics/vlanToSsids/count : Return the count of all the fabric site which has SSID to IP Pool mapping. GET /dna/intent/api/v1/sda/fabrics/vlanToSsids : Returns all the Fabric Sites that have VLAN to SSID mapping. GET /dna/intent/api/v1/sda/fabrics/${fabricId}/vlanToSsids/count : Returns the count of VLANs mapped to SSIDs in a Fabric Site. GET /dna/intent/api/v1/sda/fabrics/${fabricId}/vlanToSsids : Retrieve the VLANs and SSIDs mapped to the VLAN within a Fabric Site.
Health and Performance APIs	GET /dna/intent/api/v1/diagnosticValidationSets : Retrieves all the validation sets. GET /dna/intent/api/v1/diagnosticValidationSets/${id} : Retrieves validation details for a validation set. GET /dna/intent/api/v1/diagnosticValidationWorkflows/count : Retrieves the count of validation workflows. GET /dna/intent/api/v1/diagnosticValidationWorkflows/${id} : Retrieves validation workflow details. GET /dna/intent/api/v1/diagnosticValidationWorkflows : Retrieves the list of validation workflows. POST /dna/ intent/api/v1/diagnosticValidationWorkflows : Submits the workflow for executing validations. DELETE /dna/intent/api/v1/diagnosticValidationWorkflows/${id} : Deletes a validation workflow.
Issues APIs	GET /dna/data/api/v1/assuranceIssues : Get the details of issues for given set of filters. GET /dna/data/api/v1/assuranceIssues/${id} : Get all the details and suggested actions of an issue for the given issue ID. GET /dna/data/api/v1/assuranceIssues/count : Get the total number of issues for given set of filters. POST /dna/data/api/v1/assuranceIssues/query : Get the details of issues for given set of filters. POST /dna/data/api/v1/assuranceIssues/query/count : Get the total number of issues for given set of filters. POST /dna/data/api/v1/assuranceIssues/topNAnalytics : Get Top N analytics data of issues. POST /dna/data/api/v1/assuranceIssues/summaryAnalytics : Get summary analytics data of issues. POST /dna/data/api/v1/assuranceIssues/trendAnalytics : Get trend analytics data of issues. POST /dna/intent/api/v1/assuranceIssues/resolve : Resolve the given lists of issues. POST /dna/intent/api/v1/assuranceIssues/ignore : Ignore the given list of issues. POST /dna/intent/api/v1/assuranceIssues/${id}/update : Update the given issue by updating selected fields. GET /dna/intent/api/v1/customIssueDefinitions : Get all the custom issue definitions based on the given filters. POST /dna/intent/api/v1/customIssueDefinitions : Creates a new user-defined issue definition. GET /dna/intent/api/v1/customIssueDefinitions/count : Get the total custom issue definitions count based on the provided filters. GET /dna/intent/api/v1/customIssueDefinitions/${id} : Get the custom issue definition for the given custom issue definition ID. PUT /dna/intent/api/v1/customIssueDefinitions/${id} : Updates an existing custom issue definition based on the provided ID. DELETE /dna/intent/api/v1/customIssueDefinitions/${id} : Deletes an existing custom issue definition. GET /dna/intent/api/v1/systemIssueDefinitions : Returns all issue trigger definitions for given filters. GET /dna/intent/api/v1/systemIssueDefinitions/${id} : Get issue trigger definition for given ID. GET /dna/intent/api/v1/systemIssueDefinitions/count : Get the count of system defined issue definitions based on provided filters. PUT /dna/intent/api/v1/systemIssueDefinitions/${id} : Issue trigger definition update.
Licenses APIs	PUT /dna/intent/api/v1/licenseSetting : Update license setting. GET /dna/intent/api/v1/licenseSetting : Retrieve license setting.
Network Settings APIs	PUT /dna/intent/api/v1/sites/{id}/timeZoneSettings : Set time zone for a site. PUT /dna/intent/api/v1/sites/{id}/bannerSettings : Set banner settings for a site. GET /dna/intent/api/v1/sites/${id}/telemetrySettings : Retrieve Telemetry settings for a site. PUT /dna/intent/api/v1/sites/${id}/telemetrySettings : Set Telemetry settings for a site. POST /dna/intent/api/v1/telemetrySettings/apply : Update a device(s) telemetry settings to conform to the telemetry settings for its site. GET /dna/intent/api/v1/sites/${id}/deviceCredentials : Get device credential settings for a site. GET /dna/intent/api/v1/sites/${id}/deviceCredentials/status : Get network devices credentials sync status at a given site. GET /dna/intent/api/v1/sites/deviceCredentials/apply : Sync network devices credential. PUT /dna/intent/api/v1/sites/${id}/deviceCredentials : Update device credential settings for a site. PUT /dna/intent/api/v1/sites/${id}/aaaSettings : Set AAA settings for a site. PUT /dna/intent/api/v1/sites/${id}/dnsSettings : Set DNS settings for a site. PUT /dna/intent/api/v1/sites/${id}/dhcpSettings : Set DHCP settings for a site. PUT /dna/intent/api/v1/sites/${id}/ntpSettings : Set NTP settings for a site. PUT /dna/intent/api/v1/sites/${id}/imageDistributionSettings : Set image distribution settings for a site. GET/dna/intent/api/v1/sites/${id}/aaaSettings : Retrieve AAA settings for a site. GET /dna/intent/api/v1/sites/${id}/dnsSettings : Retrieve DNS settings for a site. GET /dna/intent/api/v1/sites/${id}/dhcpSettings : Retrieve DHCP settings for a site. GET /dna/intent/api/v1/sites/${id}/ntpSettings : Retrieve NTP settings for a site. GET /dna/intent/api/v1/sites/${id}/imageDistributionSettings : Retrieve image distribution settings for a site.
SDA APIs	Extranet APIs DELETE /dna/intent/api/v1/sda/extranetPolicies : Delete extranet policies. Multicast APIs GET /dna/intent/api/v1/sda/multicast/virtualNetworks : Get multicast virtual networks. GET /dna/intent/api/v1/sda/multicast : Get multicast. PUT /dna/intent/api/v1/sda/multicast/virtualNetworks : Update multicast virtual networks. GET /dna/intent/api/v1/sda/multicast/virtualNetworks/count : Get multicast virtual network count. DELETE /dna/intent/api/v1/sda/multicast/virtualNetworks/${id} : Delete multicast virtual network by ID. POST /dna/intent/api/v1/sda/multicast/virtualNetworks : Add multicast virtual networks. PUT /dna/intent/api/v1/sda/multicast : Update multicast. Port Channel APIs POST /dna/intent/api/v1/sda/portChannels : Add Port Channels. GET /dna/intent/api/v1/sda/portChannels : Get Port Channels. PUT /dna/intent/api/v1/sda/portChannels : Update Port Channels. DELETE /dna/intent/api/v1/sda/portChannels : Delete Port Channels. DELETE /dna/intent/api/v1/sda/portChannels/{id} : Delete Port Channels by ID. GET /dna/intent/api/v1/sda/portChannels/count : Get Port Channels count. Transit Network APIs GET /dna/intent/api/v1/sda/transitNetworks : Get Transit Networks. POST /dna/intent/api/v1/sda/transitNetworks : Add Transit Networks. PUT /dna/intent/api/v1/sda/transitNetworks : Update Transit Networks. DELETE /dna/intent/api/v1/sda/transitNetworks/${id} : Delete transit network by ID. GET /dna/intent/api/v1/sda/transitNetworks/count : Get transit networks count. Layer 2 Virtual Network APIs PUT /dna/intent/api/v1/sda/layer2VirtualNetworks : Update layer 2 virtual networks. GET /dna/intent/api/v1/sda/layer2VirtualNetworks/count : Get layer 2 virtual network count. DELETE /dna/intent/api/v1/sda/layer2VirtualNetworks/${id} : Delete layer 2 virtual network by ID. DELETE /dna/intent/api/v1/sda/layer2VirtualNetworks : Delete layer 2 virtual networks. POST /dna/intent/api/v1/sda/layer2VirtualNetworks : Add layer 2 virtual networks. GET /dna/intent/api/v1/sda/layer2VirtualNetworks : Get layer 2 virtual networks. Layer 3 Virtual Network APIs POST /dna/intent/api/v1/sda/layer3VirtualNetworks : Add layer 3 virtual networks. GET /dna/intent/api/v1/sda/layer3VirtualNetworks : Get layer 3 virtual networks. PUT /dna/intent/api/v1/sda/layer3VirtualNetworks : Update layer 3 virtual networks. DELETE /dna/intent/api/v1/sda/layer3VirtualNetworks : Delete layer 3 virtual networks. DELETE /dna/intent/api/v1/sda/layer3VirtualNetworks/${id} : Delete layer 3 virtual network by ID. GET /dna/intent/api/v1/sda/layer3VirtualNetworks/count : Get layer 3 virtual network count.
Site APIs	GET /dna/data/api/v1/siteHealthSummaries : Read list of site health summaries. GET /dna/data/api/v1/siteHealthSummaries/${id} : Read site health summary data by site ID. GET /dna/data/api/v1/siteHealthSummaries/count : Read site count. GET /dna/data/api/v1/siteHealthSummaries/summaryAnalytics : Read an aggregated summary of site health data. POST /dna/data/api/v1/siteHealthSummaries/summaryAnalytics : Query an aggregated summary of site health data. GET /dna/data/api/v1/siteHealthSummaries/trendAnalytics : Read trend analytics data for a grouping of sites in your network. GET /dna/data/api/v1/siteHealthSummaries/${id}/trendAnalytics : Read trend analytics data for a specific site in your network.
Site Design APIs	POST /dna/intent/api/v1/areas : Creates an area. GET /dna/intent/api/v1/areas/${id} : Gets an area. PUT /dna/intent/api/v1/areas/${id} : Updates an area. DELETE /dna/intent/api/v1/areas/${id} : Deletes an area. POST /dna/intent/api/v2/buildings : Creates a building. GET /dna/intent/api/v2/buildings/${id} : Gets a building. PUT /dna/intent/api/v2/buildings/${id} : Updates a building. DELETE /dna/intent/api/v2/buildings/${id} : Deletes a building. POST /dna/intent/api/v2/floors : Creates a floor. GET /dna/intent/api/v2/floors/${id} : Gets a floor. PUT /dna/intent/api/v2/floors/${id} : Updates a floor. DELETE /dna/intent/api/v2/floors/${id} : Deletes a floor. POST /dna/intent/api/v2/floors/${id}/uploadImage : Uploads floor image. POST /dna/intent/api/v1/sites/bulk : Create sites. GET /dna/intent/api/v1/sites : Get sites. GET /dna/intent/api/v1/sites/count : Get sites count. POST /dna/intent/api/v1/networkDevices/assignToSite/apply : Assign network devices to a site. POST /dna/intent/api/v1/networkDevices/unassignFromSite/apply : Unassign network devices from sites. GET /dna/intent/api/v1/networkDevices/assignedToSite : Get site assigned network devices. GET /dna/intent/api/v1/networkDevices/assignedToSite/count : Get site assigned network devices count. GET /dna/intent/api/v1/networkDevices/notAssignedToSite : Get site not assigned network devices. GET /dna/intent/api/v1/networkDevices/${id}/assignedToSite : Get site assigned network device. GET /dna/intent/api/v1/networkDevices/notAssignedToSite/count : Get site not assigned network devices count. GET /dna/intent/api/v1/networkDevices/deviceControllability/settings : Get device controllability settings. PUT /dna/intent/api/v1/networkDevices/deviceControllability/settings : Update device controllability settings. GET /dna/intent/api/v1/networkProfilesforSites : Retrieves the list of network profiles for sites. GET /dna/intent/api/v1/networkProfilesforSites/count : Retrieves the count of network profiles for sites. GET /dna/intent/api/v1/networkProfilesforSites/${id} : Retrieves a network profiles for sites by ID. DELETE /dna/intent/api/v1/networkProfilesforSites/${id} : Delete a network profiles for sites. GET /dna/intent/api/v1/networkProfilesForSites/${profileId}/siteAssignments : Retrieves the list of sites that the given network profile for sites is assigned to. POST /dna/intent/api/v1/networkProfilesForSites/${profileId}/siteAssignments : Assign a network profile for sites to the given site. POST /dna/intent/api/v1/networkProfilesForSites/${profileId}/siteAssignments/bulk : Assign a network profile for sites to a list of sites. DELETE /dna/intent/api/v1/networkProfilesForSites/${profileId}/siteAssignments/bulk : Unassigns a network profile for sites from multiple sites. DELETE /dna/intent/api/v1/networkProfilesForSites/${profileId}/siteAssignments/${id} : Unassigns a network profile for sites from a site. GET /dna/intent/api/v1/networkProfilesForSites/${profileId}/siteAssignments/count : Retrieves the count of sites that the given network profile for sites is assigned to. GET /dna/intent/api/v1/sites/${siteId}/profileAssignments : Retrieves the list of network profiles that the given site has been assigned. GET /dna/intent/api/v1/sites/${siteId}/profileAssignments/count : Retrieves the count of profiles that the given site has been assigned.
SWIM APIs	GET /dna/intent/api/v1/images : Returns list of software images. POST /dna/intent/api/v1/images/${id}/download : Download the software image. GET /dna/intent/api/v1/productNames : Retrieves the list of network device product names. GET /dna/intent/api/v1/productNames/count : Count of network product names. GET /dna/intent/api/v1/productNames/${productNameOrdinal} : Retrieve network device product name. GET /dna/intent/api/v1/siteWiseProductNames : Returns network device product names for a site. POST /dna/intent/api/v1/images/${imageId}/siteWiseProductNames : Assign network device product name to the given software image. GET /dna/intent/api/v1/siteWiseProductNames/count : Returns the count of network device product names for a site. DELETE /dna/intent/api/v1/images/${imageId}/siteWiseProductNames/${productNameOrdinal} : Unassign network device product name from the given software image. PUT /dna/intent/api/v1/images/${imageId}/siteWiseProductNames/${productNameOrdinal} : Update the list of sites for the network device product name assigned to the software image. GET /dna/intent/api/v1/images/count : Returns count of software images. GET dna/intent/api/v1/images/${id}/addonImages/count : Returns count of add-on images. GET /dna/intent/api/v1/images/distributionServerSettings : Retrieve image distribution servers. POST /dna/intent/api/v1/images/distributionServerSettings : Add image distribution server. GET /dna/intent/api/v1/images/distributionServerSettings/${id} : Retrieve specific image distribution server. PUT /dna/intent/api/v1/images/distributionServerSettings/${id} : Update remote image distribution server. DELETE /dna/intent/api/v1/images/distributionServerSettings/${id} : Remove image distribution server. GET /dna/intent/api/v1/networkDeviceImageUpdates : Get network device image updates. GET /dna/intent/api/v1/networkDeviceImageUpdates/count : Count of network device image updates. GET /dna/intent/api/v1/images/${imageId}/siteWiseProductNames : Retrieves network device product names assigned to a software image GET /dna/intent/api/v1/siteWiseProductNames/count : Returns the count of network device product names for a site.
System Settings APIs	POST /dna/intent/api/v1/ipam/serverSetting : Creates configuration details of the external IPAM server. You should only create one external IPAM server; delete any existing external server before creating a new one. GET /dna/intent/api/v1/ipam/serverSetting : Retrieves configuration details of the external IPAM server. If an external IPAM server has not been created, this resource will return a `404` response. PUT /dna/intent/api/v1/ipam/serverSetting : Updates configuration details of the external IPAM server. DELETE /dna/intent/api/v1/ipam/serverSetting : Deletes configuration details of the external IPAM server. GET /dna/intent/api/v1/provisioningSettings : Get provisioning settings. PUT /dna/intent/api/v1/provisioningSettings : Set provisioning settings.
Task APIs	GET/dna/intent/api/v1/tasks : Get tasks. GET/dna/intent/api/v1/tasks/count : Get tasks count. GET/dna/intent/api/v1/tasks/${id} : Get tasks by ID. GET/dna/intent/api/v1/tasks/${id}/detail : Get task details by ID. GET /dna/data/api/v1/assuranceTasks/${id} : Retrieve a specific assurance task by id. GET /dna/data/api/v1/assuranceTasks/count : Retrieve a count of the number of assurance tasks that currently exist. GET /dna/data/api/v1/assuranceTasks : Retrieve a list of assurance tasks.
Tag APIs	GET /dna/intent/api/v1/tags/networkDevices/membersAssociations : Retrieve tags associated with network devices. GET /dna/intent/api/v1/tags/interfaces/membersAssociations/count : Retrieve the count of interfaces that are associated with at least one tag. GET /dna/intent/api/v1/tags/networkDevices/membersAssociations/count : Retrieve the count of network devices that are associated with at least one tag. POST /dna/intent/api/v1/tags/networkDevices/membersAssociations/query : Query the tags associated with network devices. POST /dna/intent/api/v1/tags/interfaces/membersAssociations/query : Query the tags associated with interfaces. GET /dna/intent/api/v1/tags/interfaces/membersAssociations : Retrieve tags associated with the interfaces.
Wireless APIs	Note: The new Wireless APIs do not support Cisco AireOS Wireless Controller. The support is extended only to the Cisco Catalyst 9800 family of devices. GET /dna/intent/api/v1/wirelessControllers/${networkDeviceId}/anchorManagedApLocations : Get Anchor Managed AP Locations for specific Wireless Controller. GET /dna/intent/api/v1/wirelessControllers/${networkDeviceId}/managedApLocations/count : Get Managed AP Locations Count for specific Wireless Controller. GET /dna/intent/api/v1/wirelessControllers/${networkDeviceId}/primaryManagedApLocations : Get Primary Managed AP Locations for specific Wireless Controller. GET /dna/intent/api/v1/wirelessControllers/${networkDeviceId}/secondaryManagedApLocations : Get Secondary Managed AP Locations for specific Wireless Controller. GET /dna/intent/api/v1/wirelessControllers/wirelessMobilityGroups/count : Get MobilityGroups Count. GET /dna/intent/api/v1/wirelessControllers/wirelessMobilityGroups : Get All MobilityGroups. POST /dna/intent/api/v1/wirelessControllers/wirelessMobilityGroups/mobilityProvision : Mobility Provision. POST /dna/intent/api/v1/wirelessControllers/wirelessMobilityGroups/mobilityReset : Mobility Reset. GET /dna/intent/api/v1/wirelessControllers/${networkDeviceId}/ssidDetails : Get SSID Details for specific Wireless Controller. GET /dna/intent/api/v1/wirelessControllers/${networkDeviceId}/ssidDetails/count : Get SSID Count for specific Wireless Controller. PUT /dna/intent/api/v1/wirelessSettings/interfaces/${id} : Update Interface. DELETE /dna/intent/api/v1/wirelessSettings/interfaces/${id} : Delete Interface. GET /dna/intent/api/v1/wirelessSettings/interfaces : Get Interfaces. POST /dna/intent/api/v1/wirelessSettings/interfaces : Create Interface. GET /dna/intent/api/v1/wirelessSettings/interfaces/${id} : Get Interface by ID. GET /dna/intent/api/v1/wirelessSettings/interfaces/count : Get Interfaces Count. POST /dna/intent/api/v1/sites/${siteId}/wirelessSettings/ssids : Create SSID. PUT /dna/intent/api/v1/sites/${siteId}/wirelessSettings/ssids/${id} : Update SSID. DELETE /dna/intent/api/v1/sites/${siteId}/wirelessSettings/ssids/${id} : Delete SSID. GET /dna/intent/api/v1/sites/${siteId}/wirelessSettings/ssids : Get SSID by Site. GET /dna/intent/api/v1/sites/${siteId}/wirelessSettings/ssids/${id} : Get SSID by ID. GET /dna/intent/api/v1/sites/${siteId}/wirelessSettings/ssids/count : Get SSID Count by Site. DELETE /dna/intent/api/v1/wirelessProfiles/${id} : Delete Wireless Profile. PUT /dna/intent/api/v1/wirelessProfiles/${id} : Update Wireless Profile. POST /dna/intent/api/v1/wirelessProfiles : Create Wireless Profile. GET /dna/intent/api/v1/wirelessProfiles : Get Wireless Profiles. GET /dna/intent/api/v1/wirelessProfiles/${id} : Get Wireless Profile by ID. GET /dna/intent/api/v1/wirelessProfiles/count : Get Wireless Profiles Count. DELETE /dna/intent/api/v1/wirelessSettings/rfProfiles/${id} : Delete RF Profile. POST /dna/intent/api/v1/wirelessSettings/rfProfiles : Create RF Profile. PUT /dna/intent/api/v1/wirelessSettings/rfProfiles/${id} : Update RF Profile. GET /dna/intent/api/v1/wirelessSettings/rfProfiles : Get RF Profiles. GET /dna/intent/api/v1/wirelessSettings/rfProfiles/${id} : Get RF Profile by ID. GET /dna/intent/api/v1/wirelessSettings/rfProfiles/count : Get RF Profiles Count. POST /dna/intent/api/v1/wirelessAccessPoints/factoryResetRequest/provision : Factory Reset Access Point(s). GET /dna/intent/api/v1/wirelessAccessPoints/factoryResetRequestStatus : Get Access Point(s) Factory Reset status. GET /dna/intent/api/v1/wirelessSettings/dot11beProfiles : Get all 802.11be Profiles. PUT /dna/intent/api/v1/wirelessSettings/dot11beProfiles/${id} : Update 802.11be Profile. DELETE /dna/intent/api/v1/wirelessSettings/dot11beProfiles/${id} : Delete a 802.11be Profile. GET /dna/intent/api/v1/wirelessSettings/dot11beProfiles/${id} : Get 802.11be Profile by ID. GET /dna/intent/api/v1/wirelessSettings/dot11beProfiles/count : Get 802.11be Profiles Count. POST /dna/intent/api/v1/wirelessSettings/dot11beProfiles : Create a 802.11be Profile. POST/dna/intent/api/v1/wirelessControllers/${deviceId}/assignManagedApLocations : Assign Managed AP Locations For WLC. POST/dna/intent/api/v1/wirelessControllers/${deviceId}/provision : Wireless Controller Provision. POST /dna/intent/api/v1/wirelessAccessPoints/provision : AP Provision.

API Enhancements

Feature	Description
Device Onboarding (PnP) APIs	With this release: The sudiSerialNos request parameter is renamed as userSudiSerialNos in the Update Device and Add Device APIs. The addressIpV6 request parameter is added to the Add Virtual Account and Update PnP Server Profile APIs. This parameter is required when the cluster is configured with IPv6. The isSudiRequired request parameter is renamed as sudiRequired in the Import Devices in bulk API. A new optional request parameter called hostname is added to the Claim a Device to a Site API. A new optional request parameter called authorizationNeeded is added to the Claim Device API.
Devices API	With this release, syncRequestedByApp and lastManagedResyncReasons response parameters are introduced in the Get Device list API.
Event Management API	The Get EventArtifacts API now includes the optional deprecationMessage and deprecated response parameters. If the deprecated value is true, then the event artifact is deprecated and a deprecation message is displayed.
Fabric Device APIs	With this release: The request parameter deviceRoles accepts the WIRELESS_CONTROLLER_NODE value. The Fabric Device APIs support is extended to wireless role.
Path Trace API	The egressPhysicalInterface, ingressPhysicalInterface, egressInterface, ingressInterface attributes are now optional attributes in the Retrieves Previous Pathtrace API.
SDA API	In this release, an optional isBpduGuardEnabled request body parameter is added in the Update authentication profile API. The value must not be null when the authenticationProfileName parameter is set as Closed Authentication.

Deprecated APIs

Feature	Description
Fabric Wireless APIs	DELETE /dna/intent/api/v1/business/sda/wireless-controller : Remove WLC from Fabric Domain. PUT /dna/intent/api/v1/business/sda/hostonboarding/ssid-ippool : Update SSID to IP Pool Mapping. POST /dna/intent/api/v1/business/sda/hostonboarding/ssid-ippool : Add SSID to IP Pool Mapping. GET /dna/intent/api/v1/business/sda/hostonboarding/ssid-ippool : Get SSID to IP Pool Mapping. POST /dna/intent/api/v1/business/sda/wireless-controller : Add WLC to Fabric Domain.
Network Settings APIs	POST /dna/intent/api/v1/network/${siteId} : Create Network. POST /dna/intent/api/v2/network/${siteId} : Create Network V2. PUT /dna/intent/api/v1/network/${siteId} : Update Network. PUT /dna/intent/api/v2/network/${siteId} : Update Network V2. GET /dna/intent/api/v1/network : Get Network. GET /dna/intent/api/v2/network : Get Network V2. POST /dna/intent/api/v1/credential-to-site/${siteId} : Assign Device Credential To Site. POST /dna/intent/api/v2/credential-to-site/${siteId} : Assign Device Credential To Site V2.
Site Design APIs	GET /dna/intent/api/v1/site-member/${id}/member : Get devices that are assigned to a site. POST /dna/intent/api/v1/assign-device-to-site/${siteId}/device : Assign Devices To Site. POST /dna/intent/api/v1/site : Create Site. DELETE /dna/intent/api/v1/site/${siteId} : Delete Site. PUT /dna/intent/api/v1/site/${siteId} : Update Site. GET /dna/intent/api/v1/site : Get Site. GET /dna/intent/api/v2/site : Get Site V2. GET /dna/intent/api/v1/site/count : Get Site Count. GET /dna/intent/api/v1/membership/${siteId} : Get Membership. GET /dna/intent/api/v2/site/count : Get Site Count V2.
Task APIs	GET /dna/intent/api/v1/task : Get tasks. GET /dna/intent/api/v1/task/${taskId} : Get task by ID. GET /dna/intent/api/v1/task/operation/${operationId}/${offset}/${limit} : Get task by OperationId. GET /dna/intent/api/v1/task/${taskId}/tree : Get task tree. GET /dna/intent/api/v1/task/count : Get task count.
Wireless APIs	POST /dna/intent/api/v1/wireless/profile : Create Wireless Profile. GET /dna/intent/api/v1/wireless/profile : Get Wireless Profile. DELETE /dna/intent/api/v1/wireless-profile/${wirelessProfileName} : Delete Wireless Profile. UT /dna/intent/api/v1/wireless/profile : Update Wireless Profile. GET /dna/intent/api/v1/wireless/rf-profile : Retrieve RF profiles. DELETE /dna/intent/api/v1/wireless/rf-profile/${rfProfileName} : Delete RF profiles. POST /dna/intent/api/v1/wireless/rf-profile : Create or Update RF profile. GET /dna/intent/api/v1/wireless/dynamic-interface : Get dynamic interface. PUT /dna/intent/api/v1/wireless/dynamic-interface : Create Update Dynamic interface. DELETE /dna/intent/api/v1/wireless/dynamic-interface : Delete dynamic interface. POST /dna/intent/api/v1/enterprise-ssid : Create Enterprise SSID. PUT /dna/intent/api/v1/enterprise-ssid : Update Enterprise SSID. Delete /dna/intent/api/v1/enterprise-ssid/${ssidName} : Delete Enterprise SSID. GET /dna/intent/api/v1/enterprise-ssid : Get Enterprise SSID. DELETE /dna/intent/api/v1/business/ssid/${ssidName}/${managedAPLocations} : Delete SSID and provision it to devices. POST /dna/intent/api/v1/business/ssid : Create and Provision SSID. GET /dna/intent/api/v1/task/count : AP Provision. POST /dna/intent/api/v1/wireless/ap-provision : Provision update. POST /dna/intent/api/v1/wireless/provision : Provision.

API Changes That Break Backward Compatibility

Feature	Description
None	-

For more information, see the Release Notes for Cisco Catalyst Center, Release 2.3.7.x.

2024-04-08

Cisco Catalyst Center Platform API Release 2.3.7.5

New APIs

Feature	Description
LAN Automation APIs	POST /dna/intent/api/v2/lan-automation : LAN Automation Start V2. PUT /dna/intent/api/v2/lan-automation/${id} : LAN Automation Stop and Update Devices V2.
Reports APIs	GET /dna/data/api/v1/flexible-report/schedule/${reportId} : Get Flexible report schedule by report ID. GET /dna/data/api/v1/flexible-report/report/${reportId}/executions : Get Execution ID by report ID. POST /dna/data/api/v1/flexible-report/report/${reportId}/execute : Executing the Flexible report. PUT /dna/data/api/v1/flexible-report/schedule/${reportId} : Update schedule of Flexible report. GET /dna/data/api/v1/flexible-report/schedules : Get all Flexible report schedules. GET /dna/data/api/v1/flexible-report/report/content/${reportId}/${executionId} : Download Flexible report.
SDA APIs	Extranet Policy APIs GET /dna/intent/api/v1/sda/extranetPolicies : Get extranet policies. PUT /dna/intent/api/v1/sda/extranetPolicies : Update extranet policy. POST /dna/intent/api/v1/sda/extranetPolicies : Add extranet policy. GET /dna/intent/api/v1/sda/extranetPolicies/count : Get extranet policy count. DELETE /dna/intent/api/v1/sda/extranetPolicies/${id} : Delete extranet policy by ID. Port Assignment APIs POST /dna/intent/api/v1/sda/portAssignments : Add port assignments. GET /dna/intent/api/v1/sda/portAssignments : Get port assignments. PUT /dna/intent/api/v1/sda/portAssignments : Update port assignments. GET /dna/intent/api/v1/sda/portAssignments/count : Get port assignment count. DELETE /dna/intent/api/v1/sda/portAssignments/${id} : Delete port assignment by ID. DELETE /dna/intent/api/v1/sda/portAssignments : Delete port assignments. Fabric Site APIs POST /dna/intent/api/v1/sda/fabricSites : Add fabric site. PUT /dna/intent/api/v1/sda/fabricSites : Update fabric site. DELETE /dna/intent/api/v1/sda/fabricSites/${id} : Delete fabric site by ID. GET /dna/intent/api/v1/sda/fabricSites : Get fabric sites. GET /dna/intent/api/v1/sda/fabricSites/count : Get fabric site count. Fabric Zone APIs POST /dna/intent/api/v1/sda/fabricZones : Add fabric zone. PUT /dna/intent/api/v1/sda/fabricZones : Update fabric zone. DELETE /dna/intent/api/v1/sda/fabricZones/${id} : Delete fabric zone by ID. GET /dna/intent/api/v1/sda/fabricZones : Get fabric zones. GET /dna/intent/api/v1/sda/fabricZones/count : Get fabric zone count. Authentication Profile APIs PUT /dna/intent/api/v1/sda/authenticationProfiles : Update authentication profile. GET /dna/intent/api/v1/sda/authenticationProfiles : Get authentication profiles. Bulk Device Provisioning APIs GET /dna/intent/api/v1/sda/provisionDevices : Get provisioned devices. POST /dna/intent/api/v1/sda/provisionDevices : Provision devices. GET /dna/intent/api/v1/sda/provisionDevices/count : Get provisioned devices count. DELETE /dna/intent/api/v1/sda/provisionDevices : Delete provisioned devices. PUT /dna/intent/api/v1/sda/provisionDevices : Reprovision devices. DELETE /dna/intent/api/v1/ sda/provisionDevices/${id} : Delete provisioned device by ID. Fabric Device APIs POST /dna/intent/api/v1/sda/fabricDevices : Add fabric devices. GET /dna/intent/api/v1/sda/fabricDevices : Get fabric devices. GET /dna/intent/api/v1/sda/fabricDevices/count : Get fabric devices count. DELETE /dna/intent/api/v1/sda/fabricDevices : Delete fabric devices. DELETE /dna/intent/api/v1/sda/fabricDevices/${id} : Delete a fabric device by ID. PUT /dna/intent/api/v1/sda/fabricDevices : Update fabric devices. Fabric Device Layer 2 Handoff APIs POST /dna/intent/api/v1/sda/fabricDevices/ layer2Handoffs : Add fabric devices Layer 2 handoffs. GET /dna/intent/api/v1/sda/fabricDevices/ layer2Handoffs : Get fabric devices Layer 2 handoffs. GET / dna/intent/api/v1/sda/fabricDevices/layer2Handoffs/count : Get fabric devices Layer 2 handoffs count. DELETE /dna/intent/api/v1/sda/fabricDevices/ layer2Handoffs : Delete fabric devices Layer 2 handoffs. DELETE /dna/intent/api/v1/sda/fabricDevices/ layer2Handoffs/${id} : Delete fabric device Layer 2 handoff by ID. Fabric Device IP Transit Layer 3 Handoff APIs POST /dna/intent/api/v1/sda/fabricDevices/layer3Handoffs/ipTransits : Add fabric devices Layer 3 handoffs with IP transit. GET /dna/intent/api/v1/sda/fabricDevices/layer3Handoffs/ipTransits : Get fabric devices Layer 3 handoffs with IP transit. GET /dna/intent/api/v1/sda/fabricDevices/layer3Handoffs/ipTransits/count : Get fabric devices Layer 3 handoffs with IP transit count. DELETE /dna/intent/api/v1/sda/fabricDevices/layer3Handoffs/ipTransits : Delete fabric devices Layer 3 handoffs with IP transit. DELETE /dna/intent/api/v1/sda/fabricDevices/layer3Handoffs/ipTransits/${id} : Delete fabric device Layer 3 handoff with IP transit by ID. PUT /dna/intent/api/v1/sda/fabricDevices/layer3Handoffs/ipTransits : Update fabric devices Layer 3 handoffs with IP transit. Fabric Device SDA Transit Layer 3 Handoff APIs POST /dna/intent/api/v1/sda/fabricDevices/layer3Handoffs/sdaTransits : Add fabric devices Layer 3 handoffs with SDA transit. GET /dna/intent/api/v1/sda/fabricDevices/ layer3Handoffs/sdaTransits : Get fabric devices Layer 3 handoffs with SDA transit. GET /dna/intent/api/v1/sda/fabricDevices/ layer3Handoffs/sdaTransits/count : Get fabric devices Layer 3 handoffs with SDA transit count. DELETE /dna/intent/api/v1/sda/fabricDevices/ layer3Handoffs/sdaTransits : Delete fabric devices Layer 3 handoffs with SDA transit. PUT /dna/intent/api/v1/sda/fabricDevices/layer3Handoffs/sdaTransits : Update fabric devices Layer 3 handoffs with SDA transit. Anycast Gateways APIs DELETE /dna/intent/api/v1/sda/anycastGateways/${id} : Delete anycast gateway by ID. PUT /dna/intent/api/v1/sda/anycastGateways : Update anycast gateways. GET /dna/intent/api/v1/sda/anycastGateways : Get anycast gateways. POST /dna/intent/api/v1/sda/anycastGateways : Add anycast gateways. GET /dna/intent/api/v1/sda/anycastGateways/count : Get anycast gateway count.

Feature

Description

LAN Automation APIs

POST /dna/intent/api/v2/lan-automation : LAN Automation Start V2.
PUT /dna/intent/api/v2/lan-automation/${id} : LAN Automation Stop and Update Devices V2.

Reports APIs

GET /dna/data/api/v1/flexible-report/schedule/${reportId} : Get Flexible report schedule by report ID.
GET /dna/data/api/v1/flexible-report/report/${reportId}/executions : Get Execution ID by report ID.
POST /dna/data/api/v1/flexible-report/report/${reportId}/execute : Executing the Flexible report.
PUT /dna/data/api/v1/flexible-report/schedule/${reportId} : Update schedule of Flexible report.
GET /dna/data/api/v1/flexible-report/schedules : Get all Flexible report schedules.
GET /dna/data/api/v1/flexible-report/report/content/${reportId}/${executionId} : Download Flexible report.

SDA APIs

Extranet Policy APIs

GET /dna/intent/api/v1/sda/extranetPolicies : Get extranet policies.
PUT /dna/intent/api/v1/sda/extranetPolicies : Update extranet policy.
POST /dna/intent/api/v1/sda/extranetPolicies : Add extranet policy.
GET /dna/intent/api/v1/sda/extranetPolicies/count : Get extranet policy count.
DELETE /dna/intent/api/v1/sda/extranetPolicies/${id} : Delete extranet policy by ID.

Port Assignment APIs

POST /dna/intent/api/v1/sda/portAssignments : Add port assignments.
GET /dna/intent/api/v1/sda/portAssignments : Get port assignments.
PUT /dna/intent/api/v1/sda/portAssignments : Update port assignments.
GET /dna/intent/api/v1/sda/portAssignments/count : Get port assignment count.
DELETE /dna/intent/api/v1/sda/portAssignments/${id} : Delete port assignment by ID.
DELETE /dna/intent/api/v1/sda/portAssignments : Delete port assignments.

Fabric Site APIs

POST /dna/intent/api/v1/sda/fabricSites : Add fabric site.
PUT /dna/intent/api/v1/sda/fabricSites : Update fabric site.
DELETE /dna/intent/api/v1/sda/fabricSites/${id} : Delete fabric site by ID.
GET /dna/intent/api/v1/sda/fabricSites : Get fabric sites.
GET /dna/intent/api/v1/sda/fabricSites/count : Get fabric site count.

Fabric Zone APIs

POST /dna/intent/api/v1/sda/fabricZones : Add fabric zone.
PUT /dna/intent/api/v1/sda/fabricZones : Update fabric zone.
DELETE /dna/intent/api/v1/sda/fabricZones/${id} : Delete fabric zone by ID.
GET /dna/intent/api/v1/sda/fabricZones : Get fabric zones.
GET /dna/intent/api/v1/sda/fabricZones/count : Get fabric zone count.

Authentication Profile APIs

PUT /dna/intent/api/v1/sda/authenticationProfiles : Update authentication profile.
GET /dna/intent/api/v1/sda/authenticationProfiles : Get authentication profiles.

Bulk Device Provisioning APIs

GET /dna/intent/api/v1/sda/provisionDevices : Get provisioned devices.
POST /dna/intent/api/v1/sda/provisionDevices : Provision devices.
GET /dna/intent/api/v1/sda/provisionDevices/count : Get provisioned devices count.
DELETE /dna/intent/api/v1/sda/provisionDevices : Delete provisioned devices.
PUT /dna/intent/api/v1/sda/provisionDevices : Reprovision devices.
DELETE /dna/intent/api/v1/ sda/provisionDevices/${id} : Delete provisioned device by ID.

Fabric Device APIs

POST /dna/intent/api/v1/sda/fabricDevices : Add fabric devices.
GET /dna/intent/api/v1/sda/fabricDevices : Get fabric devices.
GET /dna/intent/api/v1/sda/fabricDevices/count : Get fabric devices count.
DELETE /dna/intent/api/v1/sda/fabricDevices : Delete fabric devices.
DELETE /dna/intent/api/v1/sda/fabricDevices/${id} : Delete a fabric device by ID.
PUT /dna/intent/api/v1/sda/fabricDevices : Update fabric devices.

Fabric Device Layer 2 Handoff APIs

POST /dna/intent/api/v1/sda/fabricDevices/ layer2Handoffs : Add fabric devices Layer 2 handoffs.
GET /dna/intent/api/v1/sda/fabricDevices/ layer2Handoffs : Get fabric devices Layer 2 handoffs.
GET / dna/intent/api/v1/sda/fabricDevices/layer2Handoffs/count : Get fabric devices Layer 2 handoffs count.
DELETE /dna/intent/api/v1/sda/fabricDevices/ layer2Handoffs : Delete fabric devices Layer 2 handoffs.
DELETE /dna/intent/api/v1/sda/fabricDevices/ layer2Handoffs/${id} : Delete fabric device Layer 2 handoff by ID.

Fabric Device IP Transit Layer 3 Handoff APIs

POST /dna/intent/api/v1/sda/fabricDevices/layer3Handoffs/ipTransits : Add fabric devices Layer 3 handoffs with IP transit.
GET /dna/intent/api/v1/sda/fabricDevices/layer3Handoffs/ipTransits : Get fabric devices Layer 3 handoffs with IP transit.
GET /dna/intent/api/v1/sda/fabricDevices/layer3Handoffs/ipTransits/count : Get fabric devices Layer 3 handoffs with IP transit count.
DELETE /dna/intent/api/v1/sda/fabricDevices/layer3Handoffs/ipTransits : Delete fabric devices Layer 3 handoffs with IP transit.
DELETE /dna/intent/api/v1/sda/fabricDevices/layer3Handoffs/ipTransits/${id} : Delete fabric device Layer 3 handoff with IP transit by ID.
PUT /dna/intent/api/v1/sda/fabricDevices/layer3Handoffs/ipTransits : Update fabric devices Layer 3 handoffs with IP transit.

Fabric Device SDA Transit Layer 3 Handoff APIs

POST /dna/intent/api/v1/sda/fabricDevices/layer3Handoffs/sdaTransits : Add fabric devices Layer 3 handoffs with SDA transit.
GET /dna/intent/api/v1/sda/fabricDevices/ layer3Handoffs/sdaTransits : Get fabric devices Layer 3 handoffs with SDA transit.
GET /dna/intent/api/v1/sda/fabricDevices/ layer3Handoffs/sdaTransits/count : Get fabric devices Layer 3 handoffs with SDA transit count.
DELETE /dna/intent/api/v1/sda/fabricDevices/ layer3Handoffs/sdaTransits : Delete fabric devices Layer 3 handoffs with SDA transit.
PUT /dna/intent/api/v1/sda/fabricDevices/layer3Handoffs/sdaTransits : Update fabric devices Layer 3 handoffs with SDA transit.

Anycast Gateways APIs

DELETE /dna/intent/api/v1/sda/anycastGateways/${id} : Delete anycast gateway by ID.
PUT /dna/intent/api/v1/sda/anycastGateways : Update anycast gateways.
GET /dna/intent/api/v1/sda/anycastGateways : Get anycast gateways.
POST /dna/intent/api/v1/sda/anycastGateways : Add anycast gateways.
GET /dna/intent/api/v1/sda/anycastGateways/count : Get anycast gateway count.

API Enhancements

Feature	Description
LAN Automation APIs	The LAN Automation Device Update API now includes a new query param HOSTNAME_UPDATE to change the hostname of the device based on the new request body parameter hostnameUpdateDevices. The LAN Automation Status By Id and LAN Automation Status APIs now include three additional optional parameters discoveryLevel, discoveryTimeout, and discoveryDevices which are displayed in the response body when the user starts LAN Automation using the LAN Automation Start V2 API.
Devices APIs	In this release, you can provide IPv6 addresses to assign the devices in the Assign Devices to Site API. In the Export Device list API, the password parameter is now optional. With this release, Catalyst Center platform supports the following changes in the response parameters of the Get Device Interfaces by specified range, Get Interface info by Id, Get Interface by IP, Get OSPF interfaces, Get ISIS interfaces, Get Interface by interface name, Get all interfaces, and Get Interface by Id APIs: The addresses, lastOutgoingPacketTime, lastIncomingPacketTime, mtu, and name response parameters are now included in the above APIs. The poweroverethernet, networkdevice_id, managedNetworkElementUrl, managedNetworkElement, managedComputeElementUrl, and managedComputeElement response parameters are now removed from the above APIs.
Network Settings API	In this release, a new groupName request query parameter is added in the Get Reserve IP Subpool API. The siteId parameter is now optional. Note: When you omit the siteId parameter: You must use the ignoreInheritedGroups parameter. The maximum page size of the response is 1000 entries.

Deprecated APIs

Feature	Description
None	-

API Changes That Break Backward Compatibility

Feature	Description
None	-

For more information, see the Release Notes for Cisco Catalyst Center, Release 2.3.7.x.

2023-12-20

Cisco Catalyst Center Platform API Release 2.3.7.4

New APIs

Feature	Description
User and Roles APIs	POST /dna/system/api/v1/users/external-servers/aaa-attribute : Add and update AAA Attribute API. GET /dna/system/api/v1/users/external-servers/aaa-attribute : Get AAA Attribute API. DELETE /dna/system/api/v1/users/external-servers/aaa-attribute : Delete AAA Attribute API. POST /dna/system/api/v1/users/external-authentication : Manage External Authentication Setting API. GET /dna/system/api/v1/users/external-authentication : Get External Authentication Setting API.
ITSM Integration API	GET /dna/intent/api/v1/integration-settings/status : Fetches the ITSM integration status.

Feature

Description

User and Roles APIs

POST /dna/system/api/v1/users/external-servers/aaa-attribute : Add and update AAA Attribute API.
GET /dna/system/api/v1/users/external-servers/aaa-attribute : Get AAA Attribute API.
DELETE /dna/system/api/v1/users/external-servers/aaa-attribute : Delete AAA Attribute API.
POST /dna/system/api/v1/users/external-authentication : Manage External Authentication Setting API.
GET /dna/system/api/v1/users/external-authentication : Get External Authentication Setting API.

ITSM Integration API

GET /dna/intent/api/v1/integration-settings/status : Fetches the ITSM integration status.

API Enhancements

Feature	Description
Devices API	In the Add User-Defined-Field to device API, the value request parameter is now a required attribute.
Discovery APIs	The request parameters of the Create Global Credentials V2 and Update Global Credentials V2 APIs, httpRead.name and httpWrite.name, are now changed to httpRead.description and httpWrite.description, respectively.

Deprecated APIs

Feature	Description
Devices API	The Get Device Config for all devices API is deprecated.

API Changes That Break Backward Compatibility

Feature	Description
None	-

For more information, see the Release Notes for Cisco Catalyst Center, Release 2.3.7.x.

2023-08-11

Cisco DNA Center Platform API Release 2.3.7.0 and 2.3.7.3

Compliance APIs: Support is extended for the following:

Get config task details.
Commit device configuration.

Configuration Archive API: Support is extended for the following:

Get configuration archive details.

Devices APIs: Support is extended for the following:

Get Device Interface Stats Info.

LAN Automation APIs: Support is extended for the following:

LAN Automation Stop and Update Devices.
LAN Automation Device Update.

Sites APIs: Support is extended for the following:

Get Site V2.
Get Site Count V2.
Get devices that are assigned to a site.

System Settings APIs: Support is extended for the following:

Delete Authentication and Policy Server Access Configuration.
Add Authentication and Policy Server Access Configuration.
Cisco ISE Server Integration Status.
Accept Cisco ISE Server Certificate for Cisco ISE Server Integration.
Edit Authentication and Policy Server Access Configuration.

User and Roles APIs: Support is extended for the following:

Update role API.
Delete user API.
Add role API.
Delete role API.

With this release, the following APIs are deprecated:

Get Sync Result for Virtual Account.
Sync Virtual Account Devices.

With this release, email authentication support is extended for primary and secondary SMTP servers while configuring an email destination to receive notifications.

For more information, see the Release Notes for Cisco DNA Center, Release 2.3.7.0 and 2.3.7.3.

2022-12-21

Cisco DNA Center Platform API Release 2.3.5

Devices APIs: Support is extended for the following:

Rogue additional detail count.
Rogue additional details.

End of Life (EoX) APIs: Support is extended for the following:

Get EoX status for all devices.
Get EoX details per device.
Get EoX summary.

Policy APIs: Support is extended for the following:

Apply ANC policy.
Get ANC policies.
Revoke ANC policy.
Update a registered endpoint.
Get the count of endpoints and task details.
Get AI endpoint analytics attribute dictionaries.
Get endpoint details.
Delete an endpoint
Query the endpoints.
Register an endpoint.
Process CMDB endpoints.

Discovery API: Support is extended for the following:

Get, Create, Update, and Delete Global Credential V2.

LAN Automation API: Support is extended for the following:

LAN automation logs for individual devices.
LAN automation active sessions.

System Settings API: Support is extended for the following:

Get authentication and policy servers.

2022-09-21

Cisco DNA Center Platform API Release 2.3.4

Cisco Software-Defined Access APIs: Support is extended for the following:

Get Cisco SD-Access transit network detail.
Create and delete Cisco SD-Access transit network.

Cisco Wireless APIs:

Support is extended for new options in the Wireless API for access point configuration and reboot access point:

Get access point configuration task result.
Get access point configuration.
Configure access points.

Support is extended for new options in the Wireless API for reboot access point:

Get a reboot access point.
Add the threat MAC address to the allowed list.

Cisco DNA Center System Platform API:

Support is extended for new options in the Platform API for reboot access point:

Get the Cisco DNA Center release summary.
Get the Cisco DNA Center nodes configuration summary.
Get the Cisco DNA Center packages summary.

Cisco DNA Center System User and Roles API:

Support is extended for new options in the User and Roles API for reboot access point:

Add a new user for Cisco DNA Center system.
Get all users and roles for the Cisco DNA Center system.
Get permissions for a role from Cisco DNA Center system.
Get external users authentication servers.
Update a user for Cisco DNA Center system.

Issues API:

Support is extended for a new option in the Issues API for reboot access point:

Execute suggested actions command.

Event Management API:

Support is extended for new options in the Event Management API for reboot access point:

Get webhook destination, syslog destination, Email destination, and SNMP destination.

Network Settings API:

Support is extended for new options in the Network Settings API for reboot access point:

Get device credential and service provider details.
Get SNMP, NTP, Network AAA, Client and Endpoint AAA, and/or DNS center server settings.
Create device credentials.
Assign device credential to site.
Create network settings for DHCP, Syslog, SNMP, NTP, Network AAA, Client and Endpoint AAA, and/or DNS center server settings.
Create, update, and delete service provider profile (QoS).
Update network settings for DHCP, Syslog, SNMP, NTP, Network AAA, Client and Endpoint AAA, and/or DNS center server settings.
Update and delete device credentials.

2022-04-26

Cisco DNA Center Platform API Release 2.3.3

Cisco SD-Access API: Support is extended for the following:

Get a virtual network summary.
Get a transit peer network information from Cisco SD-Access.
Add a transit peer network in Cisco SD-Access.
Delete a transit peer network from Cisco SD-Access.

Note: All the Cisco SD-Access platform APIs are Beta.

With this release, the following Cisco SD-Access APIs are deprecated from Cisco DNA Center platform:

Get Cisco SD-Access fabric information.
Get Cisco SD-Access fabric count.
Add a Cisco SD-Access fabric.
Delete a Cisco SD-Access fabric.

Devices API: Support is extended for the following:

Add or update voice VLAN to perform devices operations.
Get all the defined threat types.
Get all the allowed MAC addresses in the system.
Remove the threat MAC address from the allowed list.
Get all the defined threat levels.
Add the threat MAC address to the allowed list.
Get the count of allowed MAC addresses in the system.

Cisco DNA Center System API: Support is extended for the following:

Authorize one or more devices. Cisco DNA Center platform allows you to authorize a device only if the authorization is configured in device settings.

2021-08-04

Cisco DNA Center Platform API Release 2.2.3

Application Policies: Support is extended for the following:

Application Policy Queuing Profile APIs:
- Get all the existing application policy queuing profiles.
- Get all the existing application policy queuing profiles by name.
- Get the number of all existing application policy queuing profiles.
- Create, update, and delete custom application queuing profiles.
Quality of Service (QoS) Device Interface Information APIs
- Get all the existing QoS device interface information.
- Get all the existing QoS device interface information by network device ID.
- Get the number of all existing QoS device interface information groups by network device ID.
- Create, update, and delete QoS device interface information associated with network device ID.
Application Policy APIs
- Get the default application policy.
- Get all existing application policies.
- Create, update, and delete application policies.
AI Endpoint Analytics APIs to manage profiling rules for the endpoint.

Application: This Cisco DNA Center platform release supports a new Application API that allows you to get a list of issues, devices, and endpoints for a combination of a specific application with a site or device.

Configuration Templates: Support is extended for Get project(s) and Get template(s) details with more input filter parameters.

Device Onboarding (PnP): In the PnP workflow, the Cisco DNA Center platform now allows you to bypass the provisioning workflow and provision multiple access point devices by using an API.

Site Design: The Cisco DNA Center platform now allows you to support associate and disassociate a site to a network profile.

Task: The Cisco DNA Center platform now allows you to retrieve the execution details of a business API.

SWIM: Support is extended for the following:

Device family identifiers for all device families that can be used for tagging an image as a golden image.
Tag a golden image. Set siteId as -1 for a global site.
Remove a golden tag. Set siteId as -1 for a global site.
Get the golden tag status of an image. Set siteId as -1 for a global site.

2021-04-23

Cisco DNA Center Platform API Release 2.2.2.x

Cisco Software-Defined Access APIs: Support is extended for the following:

Get virtual network with scalable groups.
Update virtual network with scalable groups.
Add virtual network with scalable groups at the global level.
Get multicast details from the SD-Access fabric.
Delete virtual network with scalable groups.

SD-Access APIs (Beta):

Provision wired and wireless device.
Add multicast in SD-Access fabric.
Add, update, and get the SSID-to-IP pool mapping.
Add and remove wireless controllers in the fabric domain.

Reports APIs: Support is extended for the following:

Retrieve a list of summaries of all views for a given view group.
Retrieve the complete information of the view that is required to configure a report.
Retrieve the list of scheduled report configurations.
Retrieve a list of summaries of all view groups.
Retrieve the details of all executions for a given report.
Retrieve the scheduled report configuration using report ID.
Retrieve the report content.
Create and schedule a report configuration.
Delete a scheduled report configuration and report executions.

License Manager APIs: Support is extended for the following:

Retrieve a list of smart and virtual accounts.
Retrieve license information details.
Retrieve license details by device ID.

IPAM APIs:

Retrieve a list of smart accounts.
Post a list of virtual accounts and licenses.
Delete license information details.

PnP APIs: This Cisco DNA Center platform release supports a new option in the PnP claim API that indicates if user authorization is needed for the claim to complete.

SWIM Automation APIs:

Create and update a SWIM upgrade request.
Create and update a SWIM upgrade request - ServiceNow Connector
Update ITSM details

New Supervisor and Line Card API Detail: This release supports updated APIs that provide additional information about Cisco supervisor and line cards.

New Device Link Mismatch API Support: This release supports updated APIs that provide additional information about device link mismatches.

New Display PoE Interface API: This release supports updated APIs that display device interface PoE data.

Audit Log API Updates: The following updates have been made in the Audit Log API for this release.

Different descriptions for Get Audit Log Records and Get Audit Log parent records. They are no longer the same.
New descriptions and default values for attributes.
For the map data types, only details and additional details are the map type attributes. Others are strings and the schema has been updated.
The feature section of Get Audit Log Summary has been updated to state that it returns a summary and also briefly mention the purging mechanism set up for audit logs (1 million records or 1 year, whichever is earlier).
The Sort, Order, Limit, and Offset parameters have been removed from the Summary API.

2020-08-31

Cisco DNA Center Platform API Release 2.1.2.x

Clients APIs: Support is extended for the following:

New client proximity API to support client tracing.
Updated the wireless API to support client tracing.

Application API: The Cisco DNA Center platform now returns a list of applications for a specific site, a device, or a client device MAC address.

Assurance APIs: Support is extended for the following:

Return overall health information for all sites.
Return a list of global issues, issues for a specific device, or issues for a specific client device's MAC address.
Access Assurance device objects for generating reports, creating dashboards, or creating additional value-added services.

Assurance Sensor APIs: Support is extended for the following:

Create a sensor test template.
Delete an existing sensor test.
Duplicate an existing sensor test template.
Return a list of sensor devices.
Deploy, schedule, or edit a sensor test.
Run a sensor test.

Configuration Archive API: The Cisco DNA Center platform now supports the export of device configurations to an encrypted zip file.

Device Replacement APIs: Support is extended for the following:

Unmark the device for replacement.
Mark the device for replacement.
Trigger an RMA workflow that replaces the faulty device with a replacement device with the same configuration and images.
Retrieve the replacement device count.
Retrieve the replacement list of devices with details and filter the results based on Faulty Device Name, Faulty Device Platform, and Replacement.

Event Retry APIs: This release supports new retry (resend and reprocess) APIs for an ITSM (ServiceNow) event.

IP Pool APIs: The Cisco DNA Center platform supports new bulk functionality for IP and global pools.

NFV Profile APIs: Support is extended for the following:

Create a network profile for different Network Functions Visualization (NFV) topologies.
Update an existing NFV profile. To update the NFV profile, you must provide either the site profile ID as a mandatory path parameter or the site profile name as a query parameter.
Retrieve the NFV network profile details. The ID of the profile to be retrieved is provided as the path parameter. If the ID is not provided, you can provide the site profile name to retrieve the details.
Delete the NFV network profile. You must provide either the ID or the site profile name.

Rogue Management Threat APIs: Support is extended for the following:

The threat summary for the rogues and aWIPS.
The detail counts for the rogue and aWIPS threats.
The details for the rogue and aWIPS threats.

SD-Access APIs: Support is extended for the following:

Retrieve the number of fabrics.
Retrieve the SD-Access role of a device.

2020-01-17

Cisco DNA Center Platform API Release 1.3.3.x

Cisco Software-Defined Access APIs (Beta): Support is extended for the following:

Fabric creation.
Fabric site in the SD-Access fabric.
Control plane device APIs.
Edge device lifecycle management in the SD-Access fabric.
Border device business APIs.
Default Authentication Template (Profile) selection for host onboarding in the SD-Access fabric.
Virtual network creation in the SD-Access fabric.
Add IP pools to virtual networks (SD-Access segment life management).
Port assignment for user devices.
Port assignment to APs.

Network Settings API: Support is extended for the following:

Create, update, and retrieve a network.
Create and update device credentials.
Create and update a service provider profile.
Create, update, and retrieve a global IP address pool.
Retrieve device details by IP address.