API Change Log in August 2025

This topic lists the APIs updated in this release.

New MRT APIs

Table 1: New MRT APIs

Method

Path

Description

Monitoring > Switch

GET

/network-monitoring/v1alpha1/switch/{serial}/vlans

 

This API is used to fetch the list of all the VLANs associated to the specified AOS-S switch.

Monitoring > Gateways

GET

/network-monitoring/v1alpha1/gateways/{serial-number}/uplinks/modem-stats

This API is used to fetch information about the modem stats for the specified gateway.

GET

/network-monitoring/v1alpha1/gateways/{serial-number}/uplinks/{link-tag}/wan-availability-trends

This API is used to fetch information about the WAN availability trends of the specified gateway uplink. The fetched data is based on the timestamp range provided in the filter. If no timestamp range is specified in the filter, data for the last 3 hours is displayed. The null value represents no data.

GET

/network-monitoring/v1alpha1/gateways/{serial-number}/uplinks/{vlan-id}/vpn-availability-trends

This API is used to fetch information about the VPN availability trends of the specified gateway uplink. The fetched data is based on the timestamp range provided in the filter. If no timestamp range is specified in the filter, data for the last 3 hours is displayed. The null value represents no data.

Troubleshooting > Access Points

POST

/network-troubleshooting/v1alpha1/aps/{serial-number}/nslookup

This API is used to initiate an asynchronous Nslookup test on the specified AP.

GET

/network-troubleshooting/v1alpha1/aps/{serial-number}/nslookup/async-operations/{task-id}

This API is used to fetch the result of the asynchronous Nslookup test on the specified AP.

POST

/network-troubleshooting/v1alpha1/aps/{serial-number}/aaa

This API is used to initiate an asynchronous AAA test on the specified AP.

GET

/network-troubleshooting/v1alpha1/aps/{serial-number}/aaa/async-operations/{task-id}

This API is used to fetch the result of the asynchronous AAA test on the specified AP.

POST

/network-troubleshooting/v1alpha1/aps/{serial-number}/disconnectUserAll

This API is used to initiate a disconnect action for all users connected to the specified Access Point.

POST

/network-troubleshooting/v1alpha1/aps/{serial-number}/disconnectUserByMacAddress

This API is used to initiate a disconnect action for a specific user connected to the specified Access Point, identified by their MAC address.

POST

/network-troubleshooting/v1alpha1/aps/{serial-number}/disconnectUserByNetwork

This API is used to initiate a disconnect action for all users connected to a specific network (SSID) on the specified Access Point.

Troubleshooting > Gateways

POST

/network-troubleshooting/v1alpha1/gateways/{serial-number}/disconnectClientAll

This API is used to initiate a disconnect action for all users connected to the specified Gateway.

POST

/network-troubleshooting/v1alpha1/gateways/{serial-number}/disconnectClientByMacAddress

This API is used to initiate a disconnect action for a specific client connected to the specified Gateway, identified by its MAC address.

POST

/network-troubleshooting/v1alpha1/gateways/{serial-number}/halt

This API is used to initiate a shutdown operation on the specified Gateway.

Modified APIs

Table 2: Modified APIs

Method

Description

Reporting > Reporting

[POST] /network-reporting/v1alpha1/reports

The created report API call supports Custom Report type.

Monitoring > Device Location

All API paths under Device location category are updated from v1alpha1 to v1alpha2.

Example update.

Old API path—[Get] /network-monitoring/v1alpha1/sites/{site-id}/device-locations

New API path—[Get] /network-monitoring/v1alpha2/sites/{site-id}/device-locations

Troubleshooting > PVOS Switches

In the Troubleshooting section, PVOS Switches category is renamed to AOS-S Switches. All API paths previously listed under the PVOS Switches category are updated to reflect the new category name.

Example of the API path

Old API path—/network-troubleshooting/v1alpha1/pvos/{serial-number}/ping

New API path—/network-troubleshooting/v1alpha1/aos-s/{serial-number}/ping