API Deprecation Notes

Continued evolution of the NetCloud Manager API requires the deprecation of both endpoints and of data fields used in endpoints that no longer return accurate information.

This page lists the NetCloud Manager API endpoints and endpoint fields that have been deprecated.

References to the following endpoints and fields must be removed from your code by their deprecation date. Continuing to reference these endpoints and fields after their deprecation date will result in your code failing.

 

Deprecated Endpoints, Fields and other Functionality

 

Description: NetCloud Manager Web and API traffic is updating to a new Certificate Authority (CA) on August 15, 2024, and the following must be addressed by August 1st, 2024:
Deprecation Date: 08/01/2024
How does this affect me?

  • If you are not using one of the Supported Browsers, you may not be able to login and use NetCloud Manager.
  • API clients must trust the CA Google Trust Services. Most modern API clients will work without issue, but some older clients may need to be updated to continue working.

Additional Detail:

  • NetCloud Manager leverages Cloudflare for protecting the site from potentially malicious traffic. This provider is deprecating support from the current CA in use, DigiCert, so NetCloud Manager is updating to a supported CA, Google Trust Services.
  • To test whether your API client works with this CA ahead of the official migration, you can leverage
    https://validate-gts.cradlepointecm.com
  • API clients that do not trust the new CA would report an "SSL verification error" (or similar).

Endpoint: routers
Deprecation Date: 09/30/2024
Fields: overlay_network_binding
Reason: Deprecated
Actions to take:

If you reference the overlay_network_binding data field in scripts when using the routers endpoint, you must remove those references by September 30, 2024, or your script may encounter unexpected errors.

The endpoint base path for the routers endpoint remains: 

https://www.cradlepointecm.com/api/v2/routers/
given NetCloud API v2.

Endpoint: overlay_network_bindings
Deprecation Date: 09/30/2024
Fields: All
Reason: Deprecated
Actions to take: If you reference the overlay_network_bindings endpoint in your scripts, you must remove those references by September 30, 2024, or your script may encounter unexpected errors.
Endpoint: forwarding_lan_details
Deprecation Date: 09/30/2024
Fields: All
Reason: Deprecated
Actions to take: If you reference the forwarding_lan_details endpoint in your scripts, you must remove those references by September 30, 2024, or your script may encounter unexpected errors.
Endpoint: net_devices
Deprecation Date: 12/31/2023
Fields: is_upgrade_available
Reason: This field no longer returns accurate information.
Actions to take: Remove any references you have to this field in your code. Note that this field still displays in responses but does not contains accurate information.