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 → Schedule maintenance

AI-generated

Summary

Set a maintenance window on a specific device by its ID, optionally specifying start/end times, disabled features during maintenance, and a reason message.

Inputs

  • id (required) — Device identifier for which the maintenance window will be scheduled.
  • Additional Fields — Optional parameters including 'start' (maintenance window start time, ISO-8601 or epoch ms), 'end' (maintenance window end time), 'disabledFeatures' (features to disable during maintenance such as ALERTS, PATCHING, AVSCANS, TASKS), and 'reasonMessage' (reason for maintenance).
  • Options — Optional advanced settings like sending a custom JSON body merged with other fields, adding custom HTTP headers, query filters, batching inputs, debug output, pagination for list responses, and request timeout configuration.

Output shape

a JSON object representing the API response confirming the scheduled maintenance state for the device

The output includes the response from the NinjaOne API for the maintenance window update. If 'debug' is enabled, additional request details are included. This operation works on single device inputs; batching settings control multiple items processing if multiple inputs are provided.

Links

Discussion