NinjaOne icon

NinjaOne

Consume NinjaOne API

Actions158

Management → Reboot Devices

AI-generated

Overview

This node integrates with the NinjaOne API to perform device management tasks. Specifically, the "Reboot Devices" operation under the "Management" resource allows users to remotely reboot a device identified by its ID. This is useful in IT automation scenarios where administrators need to restart devices for maintenance, updates, or troubleshooting without manual intervention.

Practical examples include:

  • Automatically rebooting a workstation after deploying critical software updates.
  • Forcing a reboot on a device that is unresponsive or stuck.
  • Scheduling reboots as part of routine maintenance workflows.

Properties

Name Meaning
Id The unique identifier of the device to reboot (number).
Mode The reboot mode to use: either "NORMAL" for a standard reboot or "FORCED" for immediate forced reboot.
Reason Optional text describing the reason for the reboot, which can be logged or audited.

Output

The node outputs JSON data representing the response from the NinjaOne API after attempting the reboot operation. This typically includes status information about the reboot request, such as success confirmation or error details.

No binary data output is produced by this operation.

Dependencies

  • Requires an active connection to the NinjaOne API using OAuth2 authentication.
  • The node depends on the ninjaOneOAuth2Api credential configured in n8n to authenticate requests.
  • Network access to the NinjaOne API endpoint is necessary.

Troubleshooting

  • Common issues:

    • Invalid or missing device ID will cause the API call to fail.
    • Insufficient permissions or expired OAuth2 token may result in authentication errors.
    • Network connectivity problems can prevent the node from reaching the NinjaOne API.
  • Error messages and resolutions:

    • "No binary data exists on item!" or similar errors are not relevant here since this operation does not handle binary data.
    • API errors returned in the JSON response should be reviewed; they often indicate invalid parameters or permission issues.
    • To resolve authentication errors, verify the OAuth2 credentials and refresh tokens if needed.
    • Ensure the device ID corresponds to an existing device managed by NinjaOne.

Links and References

Discussion