NinjaOne icon

NinjaOne

Consume NinjaOne API

Actions158

Queries → Get Installed Software Patches

AI-generated

Overview

This node integrates with the NinjaOne API to query installed software patches on devices. It allows users to filter and retrieve detailed information about software patches installed across managed devices, which is useful for IT administrators monitoring patch compliance and security updates.

Common scenarios include:

  • Auditing installed patches on devices to ensure compliance.
  • Filtering patches by type, impact, or installation date.
  • Paginating through large sets of patch data.

For example, an IT admin can use this node to get all critical security patches installed after a certain date on a specific device group.

Properties

Name Meaning
Df Device filter - filter patches by device identifier or name
Type Patch Type filter - filter patches by their type (e.g., security, feature)
Impact Patch Impact filter - filter patches by their impact level (e.g., critical, moderate)
Status Patch Status filter - filter patches by their installation status (e.g., installed, failed)
Product Identifier Product Identifier - filter patches related to a specific product
Installed Before Include patches installed before the specified date (date string)
Installed After Include patches installed after the specified date (date string)
Cursor Cursor name - used for pagination to continue from a previous result set
Page Size Limit number of records per page - controls how many patch records are returned per call

Output

The node outputs JSON data containing the list of installed software patches matching the filters. Each item in the output JSON represents a patch record with details as provided by the NinjaOne API.

If the API supports pagination, the output may also include cursor information to fetch subsequent pages.

No binary data output is indicated for this operation.

Dependencies

  • Requires an API key credential configured for authenticating with the NinjaOne API.
  • The node uses OAuth2 authentication to securely connect to the NinjaOne service.
  • No additional external dependencies beyond the NinjaOne API and n8n's HTTP request helpers.

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 API credentials are correctly configured and valid.
  • Invalid Date Filters: Dates for "Installed Before" and "Installed After" must be in a valid string format recognized by the API.
  • Pagination Issues: If using cursors, ensure the cursor value is correct; otherwise, no further results will be returned.
  • Empty Results: May indicate no patches match the given filters; try broadening filter criteria.

Links and References

Discussion