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

Management → Run OS patch scan

AI-generated

Summary

Trigger an operating system patch scan on a specified device by its identifier.

Inputs

  • id (required) — The unique numeric identifier of the device on which to run the OS patch scan.
  • Options — Additional optional settings including custom JSON body fields (overriding defaults), custom HTTP headers, query-string filters, batching parameters to control request grouping and delay, pagination configuration for list results, debug mode to include full request details in the output, and request timeout settings.

Output shape

a single JSON response object containing the results of the OS patch scan request, optionally enriched with debug information if enabled.

The operation sends a POST request to the endpoint /v2/device/{id}/patch/os/scan for the given device id. Optional request body, headers, and query parameters can be provided and are merged appropriately. Supports batching of input items (devices) and detailed debugging output on demand. Pagination parameters are available but typically unnecessary for this single-device scan operation.

Examples

Example 1: Run OS patch scan on device 123

Set the Id parameter to 123, leave other options at default. On execution, triggers scan on device 123.

Links

Discussion