NinjaOne icon

NinjaOne

Consume NinjaOne API

Actions158

System → Get Device Global Custom Fields

AI-generated

Overview

This node interacts with the NinjaOne API to retrieve device global custom fields filtered by specified scopes. It is useful when you want to fetch metadata or custom attributes associated with devices across different organizational levels such as nodes, locations, or organizations.

A practical example would be automating asset management workflows where you need to pull custom field data for devices to enrich reports or trigger further automation based on those fields.

Properties

Name Meaning
Scopes Comma-separated list of scopes to filter the custom fields. The only available option is: "All Node Location Organization" (value: all,node,location,organization).

Output

The node outputs JSON data containing the device global custom fields retrieved from the NinjaOne API. The structure corresponds to the API response and includes details about each custom field within the specified scopes.

No binary data output is produced by this operation.

Dependencies

  • Requires an API authentication token credential configured in n8n to authenticate requests against the NinjaOne API.
  • The node uses the NinjaOne OAuth2 API credential for authorization.
  • Network access to the NinjaOne API endpoint is necessary.

Troubleshooting

  • Common issues:

    • Missing or invalid API credentials will cause authentication failures.
    • Providing unsupported scope values may result in empty or error responses.
    • Lack of network connectivity to the NinjaOne API will cause request failures.
  • Error messages:

    • Errors returned from the NinjaOne API are passed through; typical errors include unauthorized access or invalid parameters.
    • If no binary data is found when expected (not applicable here), a specific error is thrown, but this operation does not handle binary data.

To resolve errors:

  • Verify that the API key or OAuth2 credentials are correctly set up.
  • Ensure the scopes parameter is correctly formatted and valid.
  • Check network connectivity and NinjaOne service status.

Links and References

Discussion