topic Re: IMPORTANT: Notice on API requests to undocumented paths in Network Platform API

IMPORTANT: Notice on API requests to undocumented paths

John-on-API — Thu, 30 Jan 2025 18:59:24 GMT

Hello folks,

In our OpenAPI spec we name the operation paths to use when making API requests. These are the only paths that should be used for dashboard API requests. Making API requests to undocumented paths can mean your application suddenly stops working, the fix for which would be to change your path to one that's documented for your region.

Call to action: developers

If you have developed and/or maintain an integration that uses dashboard API, please ensure you're using only the documented paths for your region. If you already only use the documented paths, then no action is required.

Call to action: non-developer users or consumers of integrations

If you leverage integrations but are not involved in the development, please check with your integration's developer that they are only using the documented paths for your region. They should be able to affirm which paths they are using and affirm whether or not they are documented in OAS, as well as advise on a remediation plan.

Re: IMPORTANT: Notice on API requests to undocumented paths

GreenMan — Fri, 31 Jan 2025 12:26:55 GMT

An example of the kind of undocumented path you're referring to might help here. I'm assuming, for example, that addressing a particular shard directly would be the most common?

Re: IMPORTANT: Notice on API requests to undocumented paths

John-on-API — Tue, 04 Feb 2025 17:26:22 GMT

If we take getNetworkClients as an example. There's only one documented path for this operation, which is {baseUri}/networks/{networkId}/clients.

Using undocumented base URIs is a separate issue, and covered in this notice.

Re: IMPORTANT: Notice on API requests to undocumented paths

afrazer — Thu, 06 Mar 2025 08:19:09 GMT

are there undocumented 'features' in the api?

Re: IMPORTANT: Notice on API requests to undocumented paths

John-on-API — Mon, 24 Mar 2025 17:07:46 GMT

We don't maintain any concept of an undocumented feature.