NinjaOne icon

NinjaOne

Consume NinjaOne API

Actions158

Devices → Get Device Network Interfaces

AI-generated

Overview

This node integrates with the NinjaOne API to retrieve information about devices and their network interfaces. Specifically, the "Get Device Network Interfaces" operation fetches the network interface details of a specified device by its identifier. This is useful in IT management scenarios where you need to audit or monitor device connectivity, gather IP addresses, MAC addresses, or other network-related data for inventory, troubleshooting, or compliance purposes.

Practical examples:

  • Automatically retrieving all network interfaces of a device before performing remote management tasks.
  • Collecting network interface data for asset tracking or reporting.
  • Integrating device network info into a CMDB (Configuration Management Database).

Properties

Name Meaning
Id The unique numeric identifier of the device whose network interfaces you want to retrieve. This is a required input.

Output

The node outputs an array of JSON objects, each representing the response from the NinjaOne API for the requested device's network interfaces. The json field contains the detailed network interface data as returned by the API, which typically includes properties such as interface names, IP addresses, MAC addresses, status, and other relevant network details.

No binary data output is produced by this operation.

Dependencies

  • Requires an active NinjaOne API OAuth2 authentication credential configured in n8n.
  • The node uses the NinjaOne REST API endpoints under /v2/devices/{id}/network-interfaces (inferred from the operation context).
  • Proper API permissions are needed to access device network interface information.

Troubleshooting

  • Missing or invalid device Id: Ensure that the "Id" property is provided and corresponds to a valid device in NinjaOne.
  • Authentication errors: Verify that the NinjaOne API credentials are correctly set up and have not expired.
  • API rate limits or permission issues: Check NinjaOne account permissions and API usage limits.
  • No network interfaces returned: Confirm that the device has network interfaces configured and accessible via the API.

Common error messages may include:

  • "No binary data exists on item!" or "No binary data property ... does not exist" — these do not apply to this operation since it does not handle binary data.
  • API errors returned from NinjaOne will be passed through; check the error message for details such as unauthorized access, resource not found, or bad request.

Links and References

Discussion