NinjaOne icon

NinjaOne

Consume NinjaOne API

Actions158

Queries → Get Network Interfaces

AI-generated

Overview

This node interacts with the NinjaOne API to retrieve network interface information based on specified query parameters. It is useful for IT administrators or automation engineers who want to programmatically fetch details about network interfaces from devices managed by NinjaOne. For example, you can filter network interfaces by device name, paginate through results using a cursor, or limit the number of returned devices.

Properties

Name Meaning
Df Device filter: Filter network interfaces by device identifier or name (string).
Cursor Cursor name: Used for pagination to specify the position in the result set (string).
Page Size Limit number of devices to return: Controls how many network interface records are fetched (number).

Output

The output is an array of JSON objects representing the network interfaces retrieved from the NinjaOne API. Each item contains detailed information about a network interface as returned by the API. The exact structure depends on the NinjaOne API response but typically includes fields such as interface name, status, IP addresses, MAC address, and related device info.

No binary data output is produced by this operation.

Dependencies

  • Requires an active NinjaOne API OAuth2 credential configured in n8n.
  • Depends on the NinjaOne API being accessible and the user having appropriate permissions to query network interfaces.
  • Uses the built-in HTTP request helper with authentication to communicate with the NinjaOne API.

Troubleshooting

  • Common issues:
    • Invalid or expired API credentials will cause authentication failures.
    • Incorrect device filter values may result in empty responses.
    • Pagination cursors that are outdated or invalid may cause errors or no results.
  • Error messages:
    • Errors from the NinjaOne API will be returned in the json.error field if "Continue On Fail" is enabled.
    • Typical errors include authorization errors, invalid parameters, or rate limiting.
  • Resolutions:
    • Verify and refresh API credentials.
    • Double-check filter values and pagination parameters.
    • Handle API rate limits by adding delays or retries.

Links and References

Discussion