NinjaOne icon

NinjaOne

Interact with the NinjaOne API

Overview

The node interacts with the NinjaOne API to retrieve multiple device records. Specifically, the "Device" resource with the "Get Many" operation allows users to fetch a list of devices from their NinjaOne account. This is useful for scenarios where you want to process or analyze multiple devices at once, such as inventory management, monitoring device status, or integrating device data into other workflows.

For example, an IT administrator could use this node to pull a paginated list of all managed devices to generate reports or trigger alerts based on device attributes.

Properties

Name Meaning
Limit Max number of device results to return. Must be at least 1. Default is 50.
Offset Offset to start retrieving devices from, useful for pagination. Must be 0 or higher.

Output

  • The output contains a JSON array of device objects retrieved from the NinjaOne API.
  • Each device object includes detailed information about a device managed in NinjaOne (such as device ID, name, status, and other metadata).
  • The node does not explicitly mention binary data output for this operation.

Dependencies

  • Requires an API key credential for authenticating with the NinjaOne API.
  • The base URL for API requests defaults to https://api.ninjaone.com but can be overridden by credentials configuration.
  • No additional external dependencies are indicated.

Troubleshooting

  • Common issues:

    • Invalid or missing API authentication token will cause authorization errors.
    • Requesting a limit value less than 1 or negative offset may result in validation errors.
    • Network connectivity problems can prevent successful API calls.
  • Error messages:

    • Authorization errors typically indicate invalid or expired API credentials; re-authenticate or update credentials.
    • Validation errors on parameters like limit or offset require adjusting input values to valid ranges.
    • API rate limiting or server errors should be handled by retrying after some delay.

Links and References

Discussion