system

List device roles

Changed on Oct 1, 2026

Returns list of device roles

get/v2/roles

Request

Base URL
https://app.ninjarmm.com (the document declares no server; this is the origin it was published from)
Auth
- HTTP bearer
- or API key in cookie sessionKey
TypeScript
https://skmtc.dev/ninjarmm/apis/ninjaone-public-api-2-0/docs/v2/roles/get.ts
A function with typed inputs. Its response is checked against the schema.

Response

default response

idinteger

Device Role identifier

namestring

Name

descriptionstring

Description

nodeClass'WINDOWS_SERVER' | 'WINDOWS_WORKSTATION' | 'LINUX_WORKSTATION' | 'MAC' | 'ANDROID' | 'APPLE_IOS' | 'APPLE_IPADOS' | 'AOSP' | 'CHROMEOS' | 'VMWARE_VM_HOST' | 'VMWARE_VM_GUEST' | 'HYPERV_VMM_HOST' | 'HYPERV_VMM_GUEST' | 'LINUX_SERVER' | 'MAC_SERVER' | 'CLOUD_MONITOR_TARGET' | 'NMS_SWITCH' | 'NMS_ROUTER' | 'NMS_FIREWALL' | 'NMS_PRIVATE_NETWORK_GATEWAY' | 'NMS_PRINTER' | 'NMS_SCANNER' | 'NMS_DIAL_MANAGER' | 'NMS_WAP' | 'NMS_IPSLA' | 'NMS_COMPUTER' | 'NMS_VM_HOST' | 'NMS_APPLIANCE' | 'NMS_OTHER' | 'NMS_SERVER' | 'NMS_PHONE' | 'NMS_VIRTUAL_MACHINE' | 'NMS_NETWORK_MANAGEMENT_AGENT' | 'UNMANAGED_DEVICE' | 'MANAGED_DEVICE'

Node Class

customboolean

Is custom node role?

chassisType'UNKNOWN' | 'DESKTOP' | 'LAPTOP' | 'MOBILE'

Chassis Type

creatednumber double

Date created

nodeRoleParentIdinteger

Node Role Parent Id

iconstring

Icon

Changes

Oct 1, 20265932b93aea2a Revision changes
- warning
  added the new CHROMEOS enum value to the / response property for the response status
Jul 26, 2026753f26d46650 Revision changes
- warning
  added the new AOSP enum value to the / response property for the response status

Operation history