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

NodeRoles → Delete node roles

AI-generated

Summary

Delete one or more custom Node Roles in NinjaOne by specifying their IDs. System Default Device Roles cannot be deleted.

Inputs

  • Ids (required) — A JSON array of IDs representing the custom device roles to delete.
  • Custom Body — Optional JSON object to send arbitrary data in the request body; its fields take priority over other specified fields.
  • Custom Headers — Optional custom HTTP headers to include in the API request.
  • Query Filters — Optional query-string filters to refine the API request.
  • Batching — Optional settings to batch input items for deletion with configurable batch size and interval to help avoid rate limits.
  • Debug — Optionally include detailed debug information of the API request in the node output.
  • Timeout — Optional timeout in milliseconds for the API response before aborting.

Output shape

a single JSON object representing the API response confirming deletion success or failure

The response typically contains confirmation of which custom node roles were deleted; system default roles cannot be deleted and should not be included in the IDs. If debugging is enabled, the output also contains request details. Errors are surfaced as node execution failures.

Links

Discussion