Submit a request

Nerdio Help Center

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.

mceclip0.png

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.

mceclip1.png

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

mceclip2.png

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. mceclip3.png

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.

mceclip4.png

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.

mceclip5.png

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

mceclip6.png

 

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. 

 

Was this article helpful?
0 out of 0 found this helpful

Comments

Please sign in to leave a comment.