NinjaOne icon

NinjaOne

Consume NinjaOne API

Actions158

Queries → Get Custom Fields Report

AI-generated

Overview

This node interacts with the NinjaOne API to retrieve a custom fields report under the "Queries" resource with the "Get Custom Fields Report" operation. It fetches detailed information about custom fields, potentially filtered by device, updated date, and other parameters. This is useful for IT administrators or support teams who want to generate reports on custom field data across devices managed in NinjaOne.

Practical examples include:

  • Generating a report of all custom fields updated after a certain date.
  • Filtering custom fields by specific devices.
  • Paginating through large sets of custom field data using cursors and page size limits.
  • Retrieving secure values either encrypted or as plain text based on user preference.

Properties

Name Meaning
Df Device filter — filter results by a specific device identifier or criteria.
Cursor Cursor name — used for pagination to continue fetching from a specific point in the dataset.
Page Size Limit number of records per page — controls how many records are returned in one API call.
Updated After Custom fields updated after specified date — filters results to only those updated after this date.
Fields Comma-separated list of fields — specify which fields to include in the response.
Show Secure Values Flag indicating if secure values should be returned as plain text (true) or encrypted (false).

Output

The output is an array of JSON objects representing the custom fields report data retrieved from the NinjaOne API. Each item corresponds to a record matching the query parameters.

  • The json property contains the API response data structured according to the requested fields.
  • If secure values are included, they will appear either as plain text or encrypted depending on the Show Secure Values flag.
  • No binary data output is indicated for this operation.

Dependencies

  • Requires an active NinjaOne API OAuth2 credential configured in n8n for authentication.
  • Uses NinjaOne's REST API endpoints to fetch data.
  • No additional external dependencies beyond the NinjaOne API and n8n core modules.

Troubleshooting

  • No binary data exists on item!: This error does not apply here since this operation does not handle binary data.
  • API Authentication Errors: Ensure that the NinjaOne OAuth2 credentials are correctly set up and have sufficient permissions.
  • Empty or incomplete results: Check filter parameters such as Df, Updated After, and Fields to ensure they are valid and match existing data.
  • Pagination issues: When using Cursor and Page Size, verify that the cursor value is correct and that the page size is within allowed limits.
  • Secure values visibility: If secure values are expected but not visible, confirm the Show Secure Values flag is set appropriately.

Links and References

Discussion