NinjaOne Device Management

Overview

Devices in NinjaOne represent endpoints with installed RMM agents. Each device belongs to an organization and can have policies, custom fields, and maintenance windows configured.

API Base URLs

Device Endpoints

Get Device Details

GET /api/v2/device/{id}
Authorization: Bearer {token}

Returns comprehensive device information including:

• •System info (hostname, OS, IP addresses)
• •Hardware specs (CPU, RAM, storage)
• •Agent status and version
• •Applied policies
• •Custom field values

Update Device

PATCH /api/v2/device/{id}
Content-Type: application/json

{
  "displayName": "Updated Display Name",
  "nodeRoleId": 2,
  "policyId": 123,
  "userData": {
    "customField1": "value1"
  }
}

Reboot Device

POST /api/v2/device/{id}/reboot/{mode}

Modes:

• •NORMAL - Graceful reboot with user notification
• •FORCED - Immediate reboot without warning

Get Device Alerts

GET /api/v2/device/{id}/alerts

Returns active alerts and conditions for the device.

Get Device Activities

GET /api/v2/device/{id}/activities

Returns recent activity log entries.

Windows Services Management

List Windows Services

GET /api/v2/device/{id}/windows-services

Returns all Windows services on the device.

Control Windows Service

POST /api/v2/device/{id}/windows-service/{serviceId}/control
Content-Type: application/json

{
  "action": "START"
}

Actions: START, STOP, RESTART

Hardware Inventory

Get Disks

GET /api/v2/device/{id}/disks

Get Volumes

GET /api/v2/device/{id}/volumes

Get Processors

GET /api/v2/device/{id}/processors

Get Installed Software

GET /api/v2/device/{id}/software

Maintenance Windows

Schedule Maintenance

PUT /api/v2/device/{id}/maintenance
Content-Type: application/json

{
  "start": "2024-02-15T02:00:00Z",
  "end": "2024-02-15T06:00:00Z"
}

Cancel Maintenance

DELETE /api/v2/device/{id}/maintenance

Device Roles

Device Approval

For new devices pending approval:

POST /api/v2/devices/approval/{mode}
Content-Type: application/json

Modes: APPROVE, REJECT

{
  "devices": [123, 456, 789]
}

Common Workflows

Find Offline Devices

1. •List all devices
2. •Filter by offline: true status
3. •Check last contact time
4. •Review device alerts

Check Server Health

1. •Get device details
2. •Review disk space via volumes endpoint
3. •Check service status
4. •Review active alerts

Schedule Patch Window

1. •Identify target devices
2. •Schedule maintenance window
3. •Configure reboot policy
4. •Monitor patch results

Error Handling

Related Skills

• •Organizations - Organization management
• •Alerts - Alert monitoring
• •API Patterns - Authentication