NinjaOne icon

NinjaOne

Consume NinjaOne API

Actions158

Devices → Get Device Pending Failed Rejected Software Patches

AI-generated

Overview

This node operation retrieves software patches for a specific device that are in one of the following states: pending, failed, or rejected. It allows filtering these patches by various criteria such as status, product identifier, type, and impact. This is useful for IT administrators or support teams who want to monitor and manage patch compliance and issues on devices managed through NinjaOne.

Practical examples include:

  • Fetching all failed patches on a device to troubleshoot update problems.
  • Listing pending patches filtered by patch type to prioritize deployment.
  • Reviewing rejected patches with a specific impact level to assess risk.

Properties

Name Meaning
Id The unique identifier of the device for which to retrieve patch information (required).
Status Filter patches by their status (e.g., pending, failed, rejected).
Product Identifier Filter patches by the product identifier associated with the patch.
Type Filter patches by the type of patch (e.g., security, feature update).
Impact Filter patches by their impact level (e.g., critical, moderate, low).

Output

The output is an array of JSON objects where each object represents a software patch matching the specified filters for the given device. Each JSON object contains details about the patch such as its status, product identifier, type, impact, and other relevant metadata returned by the NinjaOne API.

The node does not output binary data for this operation.

Dependencies

  • Requires an active connection to the NinjaOne API using OAuth2 authentication.
  • The node depends on the NinjaOne API endpoint /v2/devices/{id}/patches (implied from context) to fetch patch data.
  • Proper configuration of the NinjaOne OAuth2 API credentials within n8n is necessary.

Troubleshooting

  • Missing or invalid device Id: The Id property is required. Ensure it is provided and corresponds to a valid device in NinjaOne.
  • API authentication errors: Verify that the OAuth2 credentials are correctly configured and have sufficient permissions.
  • Empty results: If no patches are returned, check filter values; overly restrictive filters may exclude all patches.
  • Network or API errors: These will be surfaced as error messages. Check network connectivity and NinjaOne service status.

Links and References

Discussion