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

UnmanagedDevices → Decommission an Unmanaged Device List

AI-generated

Summary

Decommission a list of unmanaged devices by sending their device IDs to the NinjaOne API, optionally customizing the request with additional headers, query parameters, or body content.

Inputs

  • nodeIds (required) — JSON array containing the IDs of the unmanaged devices to decommission.
  • options — Optional parameters including Custom Body (arbitrary JSON to merge with the request body), Custom Headers (HTTP headers to include), Query Filters (query string parameters), Batching (control request batch size and interval), Debug (whether to include detailed request information in output), Pagination (settings for handling paginated responses), and Timeout (milliseconds to wait for server response before aborting).

Output shape

a JSON response from the NinjaOne API reflecting the result of the decommission request, potentially including debug information if enabled.

Since this operation performs an API POST call to decommission devices, the output will contain the API response object. If Debug option is enabled, output includes request details (URL, headers, body). Batching options affect how multiple input items are grouped into requests, but do not change the fundamental response shape.

Examples

Example 1: Decommission a single unmanaged device

Set nodeIds to a JSON array containing one device ID; leave options empty or default.

Example 2: Decommission multiple unmanaged devices in batches with debug information

Set nodeIds to an array of multiple device IDs; configure batching to group requests; enable debug option to capture request data in outputs.

Links

Discussion