RoboShadow n8n Node

API documentation for organisation-related endpoints in the RoboShadow cybersecurity platform

Table of Contents

• Installation
• Authentication
• Resources & Operations
• Compatibility
• License

Installation

Follow the n8n community node installation guide.

Or install directly via npm:

npm install @avantguardllc/n8n-nodes-roboshadow

Authentication

This node authenticates using a Bearer Token.

| Setting | Value | |---------|-------| | Type | Bearer Token | | Format | JWT | | Base URL | https://api.roboshadow.com (editable in credentials) |

Tip: The Base URL can be changed in the credential settings if your instance uses a different host.

Resources & Operations

Base URL: https://api.roboshadow.com

Authentication

| | Endpoint | Description | |---|----------|-------------| | 🟢 POST | /identity/bearertoken | Generate bearer token from refresh token |

Identity

| | Endpoint | Description | |---|----------|-------------| | 🔵 GET | /identity/organisation | Get Organisations for the Authenticated User | | 🔵 GET | /identity/organisation/{organisation_id}/users | Get Users for a Specific Organisation |

Users

| | Endpoint | Description | |---|----------|-------------| | 🔵 GET | /identity/organisation | Get Organisations for the Authenticated User | | 🔵 GET | /identity/organisation/{organisation_id}/users | Get Users for a Specific Organisation | | 🔵 GET | /windows/organisation/{organisationId}/device/{deviceId}/userprofiles | Get device user profiles | | 🔵 GET | /windows/organisation/{organisationId}/device/{deviceId}/users | Get device users |

Applications

| | Endpoint | Description | |---|----------|-------------| | 🔵 GET | /windows/organisation/{organisationId}/applications/groups | Get application groups | | 🔵 GET | /windows/organisation/{organisationId}/applications/groups/{group_id} | Get application group details | | 🔵 GET | /windows/organisation/{organisationId}/device/{deviceId}/applications | Get device applications |

Devices

| | Endpoint | Description | |---|----------|-------------| | 🔵 GET | /windows/organisation/{organisationId}/device | Get all devices | | 🔵 GET | /windows/organisation/{organisationId}/device/{deviceId} | Get device details | | 🔵 GET | /windows/organisation/{organisationId}/device/{deviceId}/antivirus | Get device antivirus information | | 🔵 GET | /windows/organisation/{organisationId}/device/{deviceId}/applications | Get device applications | | 🔵 GET | /windows/organisation/{organisationId}/device/{deviceId}/disks | Get device disks | | 🔵 GET | /windows/organisation/{organisationId}/device/{deviceId}/disks/{diskId}/shares | Get disk shares | | 🔵 GET | /windows/organisation/{organisationId}/device/{deviceId}/report/vulnerabilities/summary | Get device vulnerability summary | | 🔵 GET | /windows/organisation/{organisationId}/device/{deviceId}/services | Get device services | | 🔵 GET | /windows/organisation/{organisationId}/device/{deviceId}/updates | Get device updates | | 🔵 GET | /windows/organisation/{organisationId}/device/{deviceId}/userprofiles | Get device user profiles | | 🔵 GET | /windows/organisation/{organisationId}/device/{deviceId}/users | Get device users |

Antivirus

| | Endpoint | Description | |---|----------|-------------| | 🔵 GET | /windows/organisation/{organisationId}/device/{deviceId}/antivirus | Get device antivirus information | | 🔵 GET | /windows/organisation/{organisationId}/reports/antivirus/bydevice | Get antivirus report by device | | 🔵 GET | /windows/organisation/{organisationId}/reports/antivirus/ransomware | Get ransomware protection report | | 🔵 GET | /windows/organisation/{organisationId}/reports/antivirus/summary | Get antivirus summary report | | 🔵 GET | /windows/organisation/{organisationId}/reports/antivirus/threats | Get threats report | | 🔵 GET | /windows/organisation/{organisationId}/reports/antivirus/windowsdefenders | Get Windows Defender report |

Disks

| | Endpoint | Description | |---|----------|-------------| | 🔵 GET | /windows/organisation/{organisationId}/device/{deviceId}/disks | Get device disks | | 🔵 GET | /windows/organisation/{organisationId}/device/{deviceId}/disks/{diskId}/shares | Get disk shares | | 🔵 GET | /windows/organisation/{organisationId}/reports/disks | Get disk usage report | | 🔵 GET | /windows/organisation/{organisationId}/reports/disks/bydevice | Get disk report by device | | 🔵 GET | /windows/organisation/{organisationId}/reports/disks/summary | Get disk summary report |

Vulnerabilities

| | Endpoint | Description | |---|----------|-------------| | 🔵 GET | /windows/organisation/{organisationId}/device/{deviceId}/report/vulnerabilities/summary | Get device vulnerability summary | | 🔵 GET | /windows/organisation/{organisationId}/reports/vulnerabilities/applications | Get vulnerable applications report | | 🔵 GET | /windows/organisation/{organisationId}/reports/vulnerabilities/cpes | Get CPE vulnerabilities report | | 🔵 GET | /windows/organisation/{organisationId}/reports/vulnerabilities/cves | Get CVE vulnerabilities report | | 🔵 GET | /windows/organisation/{organisationId}/reports/vulnerabilities/cves/{cveId}/fixes | Get fixes for specific CVE | | 🔵 GET | /windows/organisation/{organisationId}/reports/vulnerabilities/devices | Get vulnerable devices report | | 🔵 GET | /windows/organisation/{organisationId}/reports/vulnerabilities/summary | Get vulnerabilities summary |

Services

| | Endpoint | Description | |---|----------|-------------| | 🔵 GET | /windows/organisation/{organisationId}/device/{deviceId}/services | Get device services |

Updates

| | Endpoint | Description | |---|----------|-------------| | 🔵 GET | /windows/organisation/{organisationId}/device/{deviceId}/updates | Get device updates | | 🔵 GET | /windows/organisation/{organisationId}/reports/updates/bydevice | Get missing updates report by device | | 🔵 GET | /windows/organisation/{organisationId}/reports/updates/summary | Get updates summary report |

Defender

| | Endpoint | Description | |---|----------|-------------| | 🔵 GET | /windows/organisation/{organisationId}/reports/antivirus/windowsdefenders | Get Windows Defender report |

Firewall

| | Endpoint | Description | |---|----------|-------------| | 🔵 GET | /windows/organisation/{organisationId}/reports/firewalls | Get firewall report |

Hardware

| | Endpoint | Description | |---|----------|-------------| | 🔵 GET | /windows/organisation/{organisationId}/reports/hardware/bydevice | Get hardware report by device | | 🔵 GET | /windows/organisation/{organisationId}/reports/hardware/summary | Get hardware summary report |

Remediation

| | Endpoint | Description | |---|----------|-------------| | 🔵 GET | /windows/organisation/{organisationId}/reports/remediation-report | Get remediation report | | 🔵 GET | /windows/organisation/{organisationId}/reports/remediation-report/{attemptId}/cves | Get CVEs for remediation attempt |

Compatibility

• n8n version: 1.0+ (tested on 2.x)
• Node.js version: 18+

License

MIT