NinjaOne icon

NinjaOne

Consume NinjaOne API

Actions158

Management → Update Device

AI-generated

Overview

This node integrates with the NinjaOne API to update device information within the Management resource. It allows users to modify various attributes of a device such as its display name, custom user data, assigned roles, policies, organizational and location identifiers, and warranty details.

Typical use cases include:

  • Updating device metadata after hardware or software changes.
  • Assigning or changing device policies for compliance or management purposes.
  • Organizing devices by location or organization unit.
  • Adding or modifying custom attributes relevant to business processes.

For example, an IT administrator could use this node to update the display name of a device after it has been reassigned to a new user, or to change the policy applied to a device based on updated security requirements.

Properties

Name Meaning
Id Device identifier (required)
Display Name User-assigned display name for the device
User Data Custom attributes in JSON format to store additional device-specific information
Node Role Id Identifier for the node role assigned to the device
Policy Id Assigned policy ID that overrides the organization's default policy mapping; can revert to default if null
Organization Id Identifier of the organization the device belongs to
Location Id Identifier of the physical or logical location of the device
Warranty Warranty information in JSON format related to the device

Output

The node outputs a JSON object representing the response from the NinjaOne API after updating the device. This typically includes the updated device details reflecting the changes made.

No binary data output is produced by this operation.

Dependencies

  • Requires an active connection to the NinjaOne API using OAuth2 authentication.
  • The node expects the NinjaOne OAuth2 API credentials to be configured in n8n.
  • Network access to the NinjaOne API endpoint is necessary.

Troubleshooting

  • Missing or invalid device Id: The "Id" property is required. Ensure it is provided and corresponds to an existing device.
  • Invalid JSON in User Data or Warranty: These fields expect valid JSON strings. Malformed JSON will cause errors.
  • API authentication errors: Verify that the OAuth2 credentials are correctly set up and have not expired.
  • Permission issues: The authenticated user must have rights to update device information.
  • Network or API downtime: Check connectivity and NinjaOne service status if requests fail.

Common error messages may include:

  • "Device not found": The specified device Id does not exist.
  • "Unauthorized" or "Authentication failed": Issues with API credentials.
  • "Invalid input": One or more properties contain invalid values or formats.

Resolving these usually involves verifying input parameters, refreshing credentials, and ensuring proper permissions.

Links and References

Discussion