NinjaOne icon

NinjaOne

Consume NinjaOne API

Actions158

Management → Get Installer

AI-generated

Overview

This node interacts with the NinjaOne API to retrieve an agent installer for a specified organization and location. It allows users to request different types of installers (e.g., Windows MSI, Mac DMG, Linux DEB) tailored to their environment and usage needs. This is useful in scenarios where automated deployment or provisioning of NinjaOne agents is required across various operating systems and architectures.

Practical examples include:

  • Automatically fetching the appropriate installer for a new device in a given location.
  • Integrating installer retrieval into a larger automation workflow that provisions devices.
  • Limiting the number of times an installer can be used by specifying a usage limit.

Properties

Name Meaning
Organization Id Numeric identifier of the organization for which the installer is requested.
Location Id Numeric identifier of the location within the organization where the installer will be used.
Installer Type The type of agent installer to retrieve. Options: WINDOWS MSI, MAC DMG, MAC PKG, LINUX DEB, LINUX RPM, LINUX ARM 64 DEB, LINUX ARMV 7 A DEB, LINUX ARM 64 RPM, LINUX ARMV 7 A RPM.
Usage Limit Numeric value specifying how many times the installer can be used.
Content JSON object containing additional content parameters; by default includes "nodeRoleId": "auto".

Output

The node outputs JSON data representing the response from the NinjaOne API call to get the installer. This typically includes metadata about the installer and possibly a download URL or binary data reference depending on the API's response format.

If the API returns binary data (e.g., the actual installer file), it would be handled as binary output, but this is not explicitly shown in the static code. The main output is a JSON object with the installer details.

Dependencies

  • Requires an API authentication token configured via OAuth2 credentials for NinjaOne.
  • Depends on the NinjaOne API being accessible and the user having permissions to request installers.
  • No other external dependencies are indicated.

Troubleshooting

  • Common issues:

    • Missing or invalid organization or location IDs may cause the API to reject the request.
    • Incorrect installer type selection could result in unsupported installer errors.
    • If the usage limit is set improperly (e.g., negative numbers), the API might return validation errors.
    • Network or authentication failures will prevent successful API calls.
  • Error messages:

    • Errors returned from the NinjaOne API will be captured and can appear in the output JSON under an error field if "Continue On Fail" is enabled.
    • Typical error resolution involves verifying input parameters, ensuring valid credentials, and checking network connectivity.

Links and References

Discussion