NinjaOne icon

NinjaOne

Ninja One Public API documentation. <br><br>See also: <br> <a href="https://resources.ninjarmm.com/API/Ninja+RMM+Public+API+v2.0.5+Device+Filter+Syntax.pdf">Device Filter syntax</a><br><a href="https://app.ninjarmm.com/apidocs-beta/core-resources/articles/webhooks/overview">Webhooks</a>

Actions309

Devices → Pending, Failed and Rejected Software patches for device

AI-generated

Summary

Retrieve a list of pending, failed, and rejected software patches for a specific device identified by its ID, optionally filtering by patch status, product identifier, type, or impact. Supports pagination, batch processing, custom query parameters, headers, and request customization.

Inputs

  • id (required) — Device identifier to specify which device's software patches to retrieve.
  • returnAll — Whether to return all results across all pages or only a single page of results.
  • additionalFields — Optional filters including Patch Status, Product Identifier, Patch Type, and Patch Impact to refine the results.
  • options — Additional request options such as custom JSON body fields, custom HTTP headers, query-string filters, batching settings, debug flag, pagination configuration (mode, page parameter names, cursor path, max pages, etc.), and request timeout in milliseconds.

Output shape

a list of software patch records for the specified device that are pending, failed, or rejected, with pagination support

The output contains the data array of patches. If debug is enabled, output includes the full request details (URL, headers, body). Pagination options allow retrieval of multiple pages; setting 'returnAll' returns all results automatically. Batching settings control request pacing when processing multiple input items.

Examples

Example 1: Fetch all failed patches for device with ID 123

Set 'id' to 123, 'returnAll' to true, and 'additionalFields.status' to 'failed'.

Links

Discussion