Actions159
- Related Items Actions
- Backup Actions
- Queries Actions
- Get Disk Drives
- Get Operating Systems
- Get RAID Controller Report
- Get Volumes
- Get Computer Systems
- Get Antivirus Status Report
- Get Device Health Report
- Get Custom Fields Report
- Get Installed Software Patches
- Get Custom Fields Detailed Report
- Get Installed OS Patches
- Get Pending Failed Rejected OS Patches
- Get RAID Drive Report
- Get Windows Services Report
- Get Antivirus Threats
- Get Device Usage
- Get Network Interfaces
- Get Processors
- Get Software
- Get Last Logged On Users Report
- Get Policy Overrides 1
- Get Scoped Custom Fields Report
- Get Pending Failed Rejected Software Patches
- Get Scoped Custom Fields Detailed Report
- System Actions
- Knowledge Base Articles Actions
- Get Knowledge Base Article Signed Urls
- Get Related Item Attachments Signed Urls
- Download Knowledge Base Article
- Get Knowledge Base Folder Path Content
- Upload Temp Attachments
- Get Knowledge Base Folder Content
- Get Client Knowledge Base Articles
- Upload Knowledge Base Articles
- Get Global Knowledge Base Articles
- Download Related Item Attachment
- Organization Documents Actions
- Document Templates Actions
- Checklist Templates Actions
- Organization Checklists Actions
- Location Actions
- Management Actions
- Get Custom Fields Policy Condition
- Delete Policy Condition
- Reset Alert
- Update Device
- Request Scripting Options
- Submit OS Patch Scan
- Get Installer For Location
- Get Windows Event Policy Conditions
- Create Organization
- Cancel Device Maintenance
- Reboot Devices
- Set Windows Service Configuration
- Create Location For Organization
- Update Node Role Policy Assignment For Organization
- Create Windows Event Policy Condition
- Node Approval Operation
- Control Windows Service
- Remove Device Owner
- Submit OS Patch Apply
- Get Installer
- Create Policy
- Get Windows Event Policy Condition
- Update Device Maintenance
- Reset Policy Overrides
- Set Device Owner
- Submit Software Patch Scan
- Update Location
- Reset Alert Set Activity Data
- Get Device Link
- Run Script On Device
- Submit Software Patch Apply
- Update Organization
- Create Custom Fields Policy Condition
- Get Custom Fields Policy Conditions
- Custom Fields Actions
- Ticketing Actions
- Organization Actions
- Devices Actions
- Get Device Active Jobs
- Get Device Installed Software Patches
- Get Device Processors
- Update Node Attribute Values
- Get Device Disk Drives
- Get Device Pending Failed Rejected OS Patches
- Get Device Volumes
- Get Device Alerts
- Get Device Network Interfaces
- Get Device Software
- Get Device Activities
- Get Device Last Logged On User
- Get Device Services
- Get Policy Overrides
- Get Device
- Get Device Installed OS Patches
- Get Device Pending Failed Rejected Software Patches
- Get Node Custom Fields
- Groups Actions
- Webhooks Actions
Overview
This node integrates with the AvantGuard NinjaOne API to retrieve an installer package for a specified environment. It is useful in IT management scenarios where automated deployment or distribution of software agents is required across various operating systems and architectures. For example, an IT administrator can use this node to programmatically obtain the correct agent installer (e.g., Windows MSI, Mac DMG, Linux DEB) tailored to a specific organization or location, facilitating streamlined software rollout.
Properties
| Name | Meaning |
|---|---|
| Additional Body Fields | Optional fields to customize the installer request: |
| - Organization Id | Numeric identifier of the organization for which the installer is requested. |
| - Location Id | Numeric identifier of the location within the organization. |
| - Installer Type | The type of installer package to retrieve. Options include: |
| WINDOWS MSI, MAC DMG, MAC PKG, LINUX DEB, LINUX RPM, LINUX ARM 64 DEB, LINUX ARMV 7 A DEB, | |
| LINUX ARM 64 RPM, LINUX ARMV 7 A RPM | |
| - Usage Limit | Numeric limit on how many times the installer can be used. |
| - Content | JSON object specifying additional content details; by default includes "nodeRoleId": "auto". |
Output
The node outputs JSON data representing the installer information retrieved from the API. This typically includes metadata about the installer package such as download URLs, version, and other relevant details needed to deploy the agent. There is no indication that binary data (such as the actual installer file) is output directly by the node.
Dependencies
- Requires an API key credential for authenticating with the AvantGuard NinjaOne service.
- The base URL for the API must be configured in the node credentials.
- Uses the
@avantguardllc/n8n-openapi-nodepackage and an OpenAPI specification (openapi.json) bundled with the node for request construction.
Troubleshooting
- Common issues:
- Incorrect or missing API credentials will cause authentication failures.
- Providing invalid or unsupported installer types may result in errors or empty responses.
- Omitting required identifiers like organization or location IDs when they are necessary could lead to incomplete or failed requests.
- Error messages:
- Authentication errors typically indicate invalid API keys or misconfigured credentials.
- Validation errors may occur if body fields do not conform to expected formats or values.
- Resolution tips:
- Verify API credentials and base URL configuration.
- Ensure all required fields are correctly set according to the API documentation.
- Use supported installer types exactly as listed in the options.
Links and References
- AvantGuard NinjaOne API Documentation (hypothetical link, replace with actual if available)
- n8n Documentation on Creating Custom Nodes
- OpenAPI Specification Reference: https://swagger.io/specification/