NMM Partner API - Using Swagger to make API calls

Applies to: Nerdio Manager for MSP (NMM) Partners
Available in v2.1.0+

NMM Partner API allows MSPs to automate various actions in NMM via API that they can do via the NMM portal. For examples, MSPs can create & manage host pools, hosts, desktop images, etc. all via the API.

In this article we will review how you can try out the API and make test calls using Swagger.

Swagger site

To view the Swagger site, first login to your install of Nerdio Manager. Browse to Settings > Integrations and look for the REST API tile.

Click on the link swagger to open Swagger documentation for your install of Nerdio Manager.

Note: If Current status says Disabled, you will need to enable the REST API first. Please visit this KB article and follow instructions to enable REST API for your install.

Authorize

The first thing to do after you navigate to the Swagger site is to authorize the Swagger UI to make API calls. Click the Authorize button.

On the pop-up screen enter the client_id and client_secret you obtained when you enabled API and click the Authorize button.

Once you successfully authorize, you will be returned to the Swagger site and the green lock next to the Authorize button will now show it is locked.

You are now ready to start making API calls.

Test API call

An easy way to get started is to call the Test API. Click the word Test to expand the API's section. Next click the Try it out button.

Note that this API does not accept any parameters. As a result the Parameters section says "No parameters". Once  you click Try it out, you will notice an Execute button is now available. Click Execute to make the API call.

Once the API call completes, you will see the results in the Responses section. Review the information presented.

From here you can try out the other API end points. Each API accepts different parameters and the response for each API will be different.