Submit a request

Nerdio Help Center

NMM Partner API - getting started


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 all via the API.

Follow these steps to start building out an integration with Nerdio Manager via APIs:

I. Check your Nerdio Manager version

Partner API is available starting with v2.1.

  1. Log in to your install of Nerdio Manager
  2. Navigate to the Updates screen
  3. Check if the install is v2.1 or higher
  4. Upgrade to the latest version or at least v2.1. See this KB article for upgrade instructions.

II. Enable API for your install

You must enable from Settings in order to allow API calls to your NMW install.

  1. Log in to your install of Nerdio Manager
  2. Navigate to the Settings - Integrations screen
  3. Scroll down until you view the "REST API" tile
  4. Click the link "Disabled" to start process of enabling API
    mceclip0.png

The process of enabling API is itself a multi-step process. Follow the steps below in the pop-up once you click the "Disable" link.

  1. Click the "Run" button under step #1 Create API client. This will create a new Azure application  under the "nerdio-nmm-app" app registration that currently exists in your Azure tenant.
    mceclip1.png
  2. Next, you need to grant admin consent and assign permissions to application. On step #2, click the "Grant" button, which will take you to Azure portal. 
    mceclip3.png
  3. In the Azure portal, click the "Grant admin consent for Nerdio" button.
    mceclip4.png
  4. Navigate back to Nerdio Manager and click refresh to confirm the permissions have been granted correctly.
  5. Lastly, on step #3, click the "Generate" button to generate client secret and other details you will need to make API calls.
    mceclip0.png
  6. Optionally, on step #4 you can download a Postman collection to quickly start making API calls using Postman.
    mceclip2.png

Click Close button and the API status will now say enabled. You are now ready to start making API calls.

From here you can review the API documentation in Swagger by clicking the swagger link. You can also download a Postman collection to start making API calls using Postman.

mceclip3.png

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

Comments

Please sign in to leave a comment.