Process to migrate to v1

[Keelyn]

I am working with a customer to migrate to v1 and I cannot find the exact process to do so. Can anyone please help me out with the exact steps I need to take?

[alemabrahao]

Take  look at this.

Network Reformation with Cisco Meraki Dashboard API

[KH]

You can also see the new calls in this path changes article

[Keelyn]

Thanks for the links! So I think I got it but I am running into an issue with my path and operationID. Here is an example of the output I am seeing.

"adminId": "XXXXXXXX",
"method": "GET",
"host": "n532.meraki.com",
"path": "/api/v0/organizations/XXXXXX/licenseState",
"queryString": "",
"userAgent": "Java/11.0.18",
"ts": "2024-01-29T19:41:29.015935Z",
"responseCode": 200,
"sourceIp": "X.X.X.X",
"version": 0,
"operationId": "getOrganizationLicenseState"

[Ryan_Miles]

That appears to be a version 0 request. You should only be using v1 calls.

https://developer.cisco.com/meraki/api-v1/get-organization-licenses-overview/

[sungod]

As @PhilipDAth says you need to look at the details for all the endpoints you are using, even if the name/parameters are the same, do not just assume it works exactly the same, the v1 responses can be far richer (and continue to evolve).

The link @KH posted is probably the best way to speed up identifying the v0-v1 mapping.

Then use the respective endpoint pages to compare v0 with v1...

https://developer.cisco.com/meraki/api-v0/overview/

https://developer.cisco.com/meraki/api-v1/overview/

With v1 there are many more endpoints, in particular there may be v1 ways to get org-wide info that would have required iterating over networks in v0. I would take some time to look at the full set of v1 endpoints and see what opportunity there is to improve rather than simply replicate a v0 approach in v1.

You don't mention what environment your customer is using, the Meraki Python library is good, it handles a lot of the low-level work for you and tracks API updates pretty closely...

https://github.com/meraki/dashboard-api-python/blob/main/README.md

Also there's the official Ansible collection...

https://blogs.cisco.com/developer/merakiansiblecollectio01

[PhilipDAth]

You'll need to search for the replacement function here:
https://developer.cisco.com/meraki/api-v1/ 

And then change to using that (and you may need to change the parameters as well).

[Keelyn]

Thank you everyone for the responses! I think I got this one figured out.