NinjaOne icon

NinjaOne

Consume NinjaOne API

Actions158

Devices → Get Device Installed OS Patches

AI-generated

Overview

This node operation retrieves the list of installed operating system patches on a specific device managed by NinjaOne. It allows filtering patches based on their installation status and installation date ranges. This is useful for IT administrators who want to audit patch compliance, verify security updates, or troubleshoot patch-related issues on devices.

Practical examples:

  • Fetch all installed patches on a device to verify it meets security standards.
  • Retrieve only failed patches to identify update problems.
  • List patches installed within a certain timeframe to track recent changes.

Properties

Name Meaning
Id The unique identifier of the device for which to retrieve installed OS patches.
Status Filter patches by their status; options include FAILED or INSTALLED.
Installed Before Include only patches installed before the specified date (date string).
Installed After Include only patches installed after the specified date (date string).

Output

The output is an array of JSON objects where each object represents the response from the NinjaOne API containing details about the installed OS patches on the specified device. The exact structure depends on the API response but typically includes patch identifiers, names, statuses, installation dates, and other metadata related to each patch.

No binary data output is produced by this operation.

Dependencies

  • Requires an active connection to the NinjaOne API using OAuth2 authentication.
  • The node expects the NinjaOne API credentials to be configured in n8n.
  • Network access to the NinjaOne service endpoint is necessary.

Troubleshooting

  • Missing or invalid device Id: Ensure the device identifier is correct and exists in NinjaOne.
  • Authentication errors: Verify that the OAuth2 credentials are valid and have not expired.
  • Empty results: Check filter parameters such as status and date ranges; overly restrictive filters may return no data.
  • API request failures: Network issues or NinjaOne service outages can cause errors; retry later or check service status.
  • Invalid date formats: Dates for "Installed Before" and "Installed After" must be valid date strings recognizable by the API.

Links and References

Discussion