API Change Log in January 2026

This topic lists the APIs updated in this release.

New MRT APIs

Table 1: 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

Table 2: 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

Table 3: Modified 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:

  • publicIpv4—IPv4 address assigned to a device, server, or network interface that can be reached directly from the internet. It is an IPv4 address visible outside your private network

  • lastRebootReason—Information about the reason for the last reboot.

  • clusterId—Information about the cluster ID to which the Access Points is assigned.

  • device_group_id—Information about the group ID to which the AP is assigned.

  • deviceGroupName—Name of the device group to which the AP is assigned.

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:

  • switchRole—Role of the switch.

  • cpuUtilization—Percentage of CPU currently utilized by the specified switch.

  • memoryUtilization—Percentage of memory currently utilized by the specified switch.

  • systemTemperature—Current operating temperature of the specified switch.

  • poeAvailable—Amount of Power over Ethernet (PoE) power currently available on the switch.

  • poeConsumption—Amount of PoE power currently being consumed by connected devices.

  • powerConsumption—Current power consumption of the switch.

Configuration APIs

Table 4: Modified 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.

  • persona is updated to device-function

  • object_type is updated to object-type

  • scope_id is updated to scope-id

  • view_type is updated to view-type

Named Object

In the request body, persona parameter is updated to device-function.

Miscellaneous

The following APIs under Miscellaneous are updated:

  • APIs listed under Switch Profiles, Switch Chassis, Packet Capture, Db Observer, Hardware Module Profile, Remote Management, and Feature Pack are moved under System.

  • APIs listed under Mirror, Mirror Endpoint and Static MAC are moved under Interface.

  • APIs listed under Ip Routing are moved under Routing & Overlays.

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

Table 5: 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

Table 6: 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