API Change Log in January 2026
This topic lists the APIs updated in this release.
New MRT APIs
|
Method |
Path |
Description |
|---|---|---|
|
Monitoring > Live Upgrade |
||
|
GET |
/network-monitoring/v1alpha1/live-upgrade/ap-upgrades |
This API is used to fetch the access point upgrade information organized in a hierarchy from the configuration scope from which the upgrade was initiated. |
|
GET |
/network-monitoring/v1alpha1/live-upgrade/gateway-upgrades |
This API is used to fetch the gateway upgrade information organized in a hierarchy from the configuration scope from which the upgrade was initiated. |
|
GET |
/network-monitoring/v1alpha1/live-upgrade/device-upgrades |
This API is used to fetch the access point or gateway upgrade information in a flat format keyed by device serial number. |
|
Services > Webhooks |
||
|
GET |
/network-services/v1beta1/webhooks |
This API is used to fetch a list of webhooks and their associated receiver details, such as the endpointURL, authentication mechanism, and the createdAt and updatedAt timestamps. |
|
POST |
/network-services/v1beta1/webhooks |
This API is used to create a new webhook using details of the receiver such as the endpoint URL and the authMechanis |
|
GET, PUT, PATCH, or DELETE |
/network-services/v1beta1/webhooks/{id} |
These APIs are used to fetch, update, or delete the webhook details for the specified webhook ID such as the endpointURL and the authMechanism along with createdAt and updatedAt timestamps. In the PUT call, all the request body parameters should be provided to update the Webhook. In the PATCH call, one or multiple parameters in the body can be used to update the Webhook. |
|
POST |
/network-services/v1beta1/webhooks/{id}/rotate-hmac-key |
This API is used to rotate the HMAC key for an existing webhook.
|
|
Services > Location Analytics |
||
|
GET |
/network-services/v1alpha1/location-analytics/trends |
This API is used to fetch visitor and client trend data for a tenant, either across all sites or for a specific site, within a specified time range. |
|
GET |
/network-services/v1alpha1/location-analytics/sites/insights |
This API is used to fetch the insights for each site of a tenant for a given time range. |
|
Monitoring > Topology |
||
|
GET |
/network-monitoring/v1alpha2/topology/{site-id} |
This API is used to fetch information about the topology and device relations information for a specific site ID. |
|
GET |
/network-monitoring/v1alpha2/unmanaged-device/{mac-address} |
This API is used to fetch the details of an unmanaged device associated to the specified site. |
|
GET |
/network-monitoring/v1alpha2/isolated-devices/{site-id} |
This API is used to fetch the list of all isolated devices for a specific site. An isolated device is a device that does not have any relation with other devices in the same site. |
|
GET |
/network-monitoring/v1alpha2/neighbours/{serial-number} |
The Neighbors API call response must include a complete list of all neighbors, along with the Site ID associated with each neighbor. |
|
MSP > MSP |
||
|
GET |
/network-msp/v1alpha1/msp/list-tenants |
This API is used to fetch the list of tenants associated with an MSP account. Tenants list includes details such as tenant name, tenant CID, sites count, devices count with health status, alerts count, etc. |
|
Monitoring > Clients |
||
|
GET |
/network-monitoring/v1alpha1/clients/{mac-address} |
This API is used to fetch details of a specific client, based on the query parameters provided. Client detail includes name, status, health, etc. |
|
GET |
/network-monitoring/v1alpha1/clients/{mac-address}/mobility_trail |
This API is used to fetch details of a specific wireless client mobility detail. |
|
Monitoring > Switch |
||
|
GET |
/network-monitoring/v1alpha1/switches |
This API fetches the list of all switches and provides information for each switch such as serial number, MAC address, model, software version, firmware version, IPv4 address, IPv6 addresses, etc. |
|
GET |
/network-monitoring/v1alpha1/switch/{serial}/interface-trends |
This API is used to fetch the interface trends for the specified switch serial associated to a specific site. The interface trends include rx bytes, tx bytes, discards, giants, errors, runts, collision. |
|
GET |
/network-monitoring/v1alpha1/switch/{serial}/hardware-trends |
This API is used to fetch the hardware trends for a serial for a specific site. The hardware trends include cpu utilization, memory utilization, POE available, POE consumption and total power available. |
|
GET |
/network-monitoring/v1alpha1/switch/{serial}/interface-poe |
This API fetches the PoE details for the switch interfaces. |
New Configuration APIs
|
Method |
Path |
Description |
|---|---|---|
|
Firmware Policy > Firmware Compliance |
||
|
GET, POST, PATCH, or Delete |
/network-config/v1alpha1/firmware-compliance |
These APIs are used to fetch, create, update, or delete the firmware policy for devices. To view the firmware details of a device, execute the API: [GET] /network-services/v1alpha1/firmware-details. |
|
Interfaces > Gw Port Profile |
||
|
GET |
/network-config/v1alpha1/gw-port-profiles |
This API is used to fetch a list of gateway port profiles configured. A port profile can be used to configure Ethernet interface. Same profile can be applied to multiple interfaces and avoids repeating same configuration for interfaces. |
|
GET, POST, PATCH, or DELETE |
/network-config/v1alpha1/gw-port-profiles/{profile-name} |
These APIs are used to fetch, configure, update, or delete the parameters related to a specific gateway port profile. |
|
System > Gw System |
||
|
GET |
/network-config/v1alpha1/gw-system |
This API is used to fetch the list of gateway device system level configurations. The system level configurations include timezone settings, LCD settings, device VLAN settings, common firewall settings, AAA global timers, RADIUS or TACACS client settings, and other system settings. |
|
GET, POST, PATCH, or DELETE |
/network-config/v1alpha1/gw-system/{name} |
These APIs are used to fetch, create, update, or delete the parameters related to the specified gateway system profile. |
|
High Availability > Gw Cluster |
||
|
GET |
/network-config/v1alpha1/gateway-clusters |
This API is used to fetch the list of gateway cluster configuration. |
|
GET, POST, PATCH, or DELETE |
/network-config/v1alpha1/gateway-clusters/{name} |
These APIs are used to fetch, create, update, or delete the parameters related to the specified gateway cluster profiles. |
|
Gateway Clustering Orchestration > Gw Cluster Intent |
||
|
GET |
/network-config/v1alpha1/gw-cluster-intent-config |
This API is used to fetch the list of gateway cluster mode configuration. |
|
GET, POST, PATCH, or DELETE |
/network-config/v1alpha1/gw-cluster-intent-config/{name} |
These APIs are used to fetch, create, update, or delete the parameters related to the specified gateway cluster intent profiles. |
|
Central NAC Service > DPP Registration |
||
|
GET |
/network-config/v1alpha1/cnac-dpp-reg |
This API is used to fetch the list of all Device Provisioning Protocol (DPP) registrations |
|
POST |
/network-config/v1alpha1/cnac-dpp-reg |
This API is used to register a new DPP URI. |
|
PUT |
/network-config/v1alpha1/cnac-dpp-reg |
This API is used to update an existing DPP registration. |
|
DELETE |
/network-config/v1alpha1/cnac-dpp-reg/{id} |
This API is used to delete a DPP registration. |
|
GET |
/network-config/v1alpha1/cnac-dpp-reg/{id} |
This API is used to fetch the details of a specific DPP registration. |
Modified APIs
MRT APIs
|
Method |
Description |
|---|---|
|
Monitoring > Access Points The softwareVersion is updated to firmwareVersion for the APIs listed under Monitoring > Access Points. |
|
|
GET /network-monitoring/v1alpha1/aps |
The response body of this API has been enhanced to include the following statistics for access points:
|
|
Services > Location The path for Start an AP ranging scan API is updated from [POST] /network-services/v1alpha1/sitemaps/{site-id}/floors/{floor-id}/ap-ranging-scans/start to [POST] /network-services/v1alpha2/ap-ranging-scans The POST /network-services/v1alpha1/ap-ranging-scans API is used to start an AP ranging scan for the given floor-id. AP ranging scans facilitate using automatic AP placement within the Floorplan manager as it allows the system to collect inter-AP ranging information in a shorter time frame. A Wi-Fi network outage is caused on executing the API call. |
|
|
GET /network-services/v1alpha1/asset-tags GET /network-services/v1alpha1/asset-tags/{asset-tag-id} PUT /network-services/v1alpha1/asset-tags/{asset-tag-id}/metadata POST /network-services/v1alpha1/asset-tags/{asset-tag-id}/metadata DELETE /network-services/v1alpha1/asset-tags/{asset-tag-id}/metadata |
These APIs are updated to include Role-Based Access Control (RBAC) information for the asset tracking APIs. The RBAC data is read-only. |
|
Monitoring > Clients |
|
|
GET /network-monitoring/v1alpha1/clients |
The allowed range is increased from 1-100 to 1-1000 for the limit parameter. |
|
Monitoring > Switch |
|
|
GET /network-monitoring/v1alpha1/switch/{serial} |
The response body of the API is updated to include the following statistics:
|
Configuration APIs
|
Method |
Description |
|---|---|
|
Named Object > Alias |
The APIs listed under Alias are updated to support the ALIAS_IPV4_SYSTEM_VLAN type for gateway system profile. |
|
Central NAC > Cda Portal Skin Profile In the request body, skinId parameter is updated to skin-id. |
|
|
Central NAC > Cda Message Provider In the request body, providerId parameter is updated to provider-id. |
|
|
Central NAC > Cda Authz Policy In the request body, policyId parameter is updated to policy-id. |
|
|
Central NAC > Cda Portal Overrides Profile In the request body, overrideId parameter is updated to override-id. |
|
|
Central NAC > Cda Portal Profile In the request body, portalId parameter is updated to portal-id. |
|
|
Central NAC > Cda Auth Profile In the request body, authProfileId parameter is updated to auth-profile-id. |
|
|
Config Management > Config Checkpoint In the request body, persona parameter is updated to device-function. |
|
|
Extensions > Extension Vsphere In the request body, persona parameter is updated to device-function. |
|
|
High Availability The following parameters are updated in the response body for the APIs listed under High Availability.
|
|
|
Named Object In the request body, persona parameter is updated to device-function. |
|
|
Miscellaneous The following APIs under Miscellaneous are updated:
|
|
|
Scope Management > Site Collections Site Collection IDs created using the Site Collections API can now be assigned during role-based policy creation. |
|
|
APIs listed under Miscellaneous > Device Certificate is moved to Security > Device Certificate. |
|
Deprecated APIs
|
Deprecated API |
Alternate APIs |
|---|---|
|
Monitoring > Access Points |
|
|
[GET] /network-monitoring/v1alpha1/aps |
[GET] /network-monitoring/v1alpha2/aps |
|
Monitoring > Gateways |
|
|
[GET] /network-monitoring/v1alpha1/gateways |
[GET] /network-monitoring/v1alpha2/gateways |
|
[GET] /network-monitoring/v1alpha1/gateways/{serial-number} |
[GET] /network-monitoring/v1alpha2/gateways/{serial-number} |
|
[GET] /network-monitoring/v1alpha1/gateways/{serial-number}/vlans/{vlan-id} |
[GET] /network-monitoring/v1alpha2/gateways/{serial-number}/tunnels |
|
[GET] /network-monitoring/v1alpha1/gateways/{serial-number}/lan-tunnels/{tunnel-name} |
[GET] /network-monitoring/v1alpha2/gateways/{serial-number}/tunnels/{tunnel-name} |
|
Monitoring > FloorPlan |
|
|
[GET] /network-monitoring/v1alpha1/sitemaps/{site-id}/floors/{floor-id}/raster |
Not available |
Removed APIs
|
Removed APIs |
Alternate APIs |
|---|---|
|
API listed under Monitoring > Location Services is removed. |
|
|
[GET] /network-monitoring/v1alpha1/wifi-clients-locations |
[GET] /network-services/v1alpha1/wifi-clients-locations |
|
Services > WIDS |
|
|
[GET] /network-services/v1alpha1/wids-intrusions |
Not available |
|
[GET] /network-services/v1alpha1/wids-monitored-aps |
Not available |
|
System > Ddns Http |
|
|
[GET] /network-config/v1alpha1/ddns-http |
Not available |
|
[GET, POST, PATCH, and DELETE] /network-config/v1alpha1/ddns-http/{name} |
Not available |