API Change Log in April 2026

This topic lists the APIs updated in this release.

New MRT APIs

Table 1: New MRT APIs

Method

Path

Description

Monitoring > Gateways

GET

/network-monitoring/v1/gateways/{serial-number}/uplinks/{link-tag}/probes/{probe}/performance-trends

This API is used to fetch gateway uplink performance trends for the selected probe based on timestamp range.

Monitoring > Client Onboarding

GET

/network-monitoring/v1/client-onboarding-stage/export

This API is used to fetch per-stage onboarding export data, including summary totals and the top five delayed or failed dimensions.

GET

/network-monitoring/v1/client-onboarding-stage/reasons

This API is used to fetch the top reasons for a specific status based on the onboarding stage.

GET

/network-monitoring/v1/client-onboarding-stage/count

This API is used to fetch the top grouped onboarding counts based on stage and status.

Notification > Alerts

GET

/network-notifications/v1/alert-config

This API is used to fetch the list of alerts configurations for a given scope. Each configuration defines the threshold rules, severity mappings, and settings for a specific alert type. Configurations may be locally defined or inherited from a parent scope.

Services > FCO Response Information

GET

/network-services/v1/fco-resp-info/{serial-number}

This API is used to fetch the Automated Frequency Coordination channel and EIRP data for the specific AP serial number.

GET

/network-services/v1/fco-resp-info-all

This API fetch the Automated Frequency Coordination channel and EIRP data for all the access points.

New Configuration APIs

Table 2: New Configuration APIs

Method

Path

Description

Security > Internal User

GET

/network-config/v1alpha1/internal-user

This API is used to fetch the list of Internal User profiles.

The access point's local user database for RADIUS (employee) and captive portal (guest) access. The local database supports up to 512 users on APs. Use this API to retrieve the list of Internal User profiles.This is only applicable for AP.

GET, POST, PATCH, or DELETE

/network-config/v1alpha1/internal-user/{name

These APIs are used to fetch, create, or update the parameters related to Internal User profile configuration grouping.

Modified APIs

MRT APIs

Table 3: Modified MRT APIs

Method

Description

Monitoring > Access Points

GET /network-monitoring/v1/aps

GET /network-monitoring/v1/radios

GET /network-monitoring/v1/bssids

GET /network-monitoring/v1/aps/{serial-number}/radios

A new parameter, clientCount is added to the response body for these APIs. The clientCount parameter displays the total number of wireless clients connected to an Access Point. It is supported on Access Points running on firmware version AOS 10.8 and above, and AOS 8.12 and above.

Monitoring > Site Health

GET /network-monitoring/v1/sites-health

GET /network-monitoring/v1/sites-device-health

GET /network-monitoring/v1/sites-client-health

 

The Site Health, Site Device Health, and Site Client Health list APIs are updated with the following changes:

  • These APIs now fetch up to 1000 entries per request.

  • The default sorting for these API call is changed from site-id to sitename. This change prevents duplicate or missing site entries in the response body. Previously, when sorting by site-id, changes in site health could cause sites to shift across pages between paginated API calls due to small time gaps, resulting in inconsistent results.

  • When these APIs are executed without a sort parameter, the default sorting used site name in ascending order.

Monitoring > Gateway

GET /network-monitoring/v1/gateways

The API is updated to include the following enhancements:

  • In the request body, new filter parameters are added, including: siteId, model, status, deployment, macAddress, siteName, deviceName, firmwareVersion, and serialNumber.

  • In the request body, new sort parameters are added, including: siteId, model, status, deployment, macAddress, siteName, deviceName, firmwareVersion, and serialNumber.

  • In the response body, model, siteName, clusterName fields are added.

GET /network-monitoring/v1/gateways/{serial-number}

In the response body, siteName and clusterName fields are added.

GET /network-monitoring/v1/gateways/{serial-number}/tunnels

The API is updated to include the following enhancements:

  • In the request body new filter parameters are added, including: tunnelName, status, mode, encapsulation, and tunnelType.

  • In the request body new sort parameters are added, including: tunnelName, destinationIpAddress, sourceIpAddress, mode, vni, and encapsulation.

  • In the response body, tunnelType field is added.

GET /network-monitoring/v1/gateways/{serial-number}/tunnels/{tunnel-name}

In the response body, tunnelType field is added.

GET /network-monitoring/v1/gateways/{serial-number}/ports

The API is updated to include the following enhancements:

  • In the request body new filter parameters are added, including: speed, duplex, vlan, macAddress, and portType.

  • In the request body new sort parameters are added, including: mtu, speed, duplex, and vlan.

  • In the response body, macAddress, adminState, operState, connectorType, and portType fields are added.

GET /network-monitoring/v1/gateways/{serial-number}/ports/{port-number}

In the response body, macAddress, adminState, operState, connectorType, and portType fields are added.

GET /network-monitoring/v1/gateways/{serial-number}/uplinks

The API is updated to include wanStatus, linkStatus, and status fields in the response body.

GET /network-monitoring/v1/gateways/{serial-number}/uplinks/{link-tag}

In the response body the wanStatus, linkStatus, and status fields are added.

Configuration APIs

Table 4: Modified Configuration APIs

Method

Description

Interfaces > Interface Ethernet

POST /network-config/v1alpha1/interface-profiles/{name}

PATCH /network-config/v1alpha1/interface-profiles/{name}

These APIs are updated to support editing of the port range.

Deprecated APIs

Table 5: Deprecated APIs

Deprecated API

Alternate APIs

All alpha MRT APIs (v1alpha1, and v1alpha2) are marked as deprecated. You must use the corresponding v1 APIs.

Removed APIs

Table 6: Removed APIs

Removed APIs

Alternate APIs

Services > Location

POST /v1alpha1/sitemaps/{site-id}/floors/{floor-id}/ap-ranging-scans/start

This API is removed and is no longer available for use. Executing this API call returns a 404 error.