Actions158
- System Actions
- Organization Actions
- Devices Actions
- Get Device
- Get Device Active Jobs
- Get Device Activities
- Get Device Alerts
- Get Device Disk Drives
- Get Device Installed OS Patches
- Get Device Installed Software Patches
- Get Device Last Logged On User
- Get Device Network Interfaces
- Get Device Pending Failed Rejected OS Patches
- Get Device Pending Failed Rejected Software Patches
- Get Device Processors
- Get Device Services
- Get Device Software
- Get Device Volumes
- Get Node Custom Fields
- Update Node Attribute Values
- Get Policy Overrides
- Groups Actions
- Queries Actions
- Get Antivirus Status Report
- Get Antivirus Threats
- Get Computer Systems
- Get Custom Fields Detailed Report
- Get Custom Fields Report
- Get Device Health Report
- Get Device Usage
- Get Disk Drives
- Get Installed OS Patches
- Get Installed Software Patches
- Get Last Logged On Users Report
- Get Network Interfaces
- Get Operating Systems
- Get Pending Failed Rejected OS Patches
- Get Pending Failed Rejected Software Patches
- Get Policy Overrides 1
- Get Processors
- Get RAID Controller Report
- Get RAID Drive Report
- Get Scoped Custom Fields Detailed Report
- Get Scoped Custom Fields Report
- Get Software
- Get Volumes
- Get Windows Services Report
- Management Actions
- Get Custom Fields Policy Conditions
- Create Custom Fields Policy Condition
- Get Windows Event Policy Conditions
- Create Windows Event Policy Condition
- Delete Policy Condition
- Get Custom Fields Policy Condition
- Get Windows Event Policy Condition
- Create Organization
- Node Approval Operation
- Reset Alert
- Reset Alert Set Activity Data
- Update Device Maintenance
- Cancel Device Maintenance
- Control Windows Service
- Update Device
- Get Device Link
- Reset Policy Overrides
- Reboot Devices
- Remove Device Owner
- Request Scripting Options
- Run Script On Device
- Set Device Owner
- Set Windows Service Configuration
- Submit OS Patch Apply
- Submit OS Patch Scan
- Submit Software Patch Apply
- Submit Software Patch Scan
- Create Location For Organization
- Get Installer
- Get Installer For Location
- Update Organization
- Update Location
- Update Node Role Policy Assignment For Organization
- Create Policy
- Ticketing Actions
- Webhooks Actions
- Related Items Actions
- Location Actions
- Backup Actions
- Knowledge Base Articles Actions
- Upload Temp Attachments
- Download Knowledge Base Article
- Get Client Knowledge Base Articles
- Get Global Knowledge Base Articles
- Get Knowledge Base Article Signed Urls
- Get Knowledge Base Folder Content
- Get Knowledge Base Folder Path Content
- Download Related Item Attachment
- Get Related Item Attachments Signed Urls
- Organization Documents Actions
- Document Templates Actions
- Checklist Templates Actions
- Custom Fields Actions
- Organization Checklists Actions
Queries → Get Computer Systems
AI-generatedOverview
This node interacts with the NinjaOne API to retrieve computer system data based on specified query parameters. It is designed to fetch paginated lists of computer systems, optionally filtered by device identifiers and monitoring timestamps. This functionality is useful for IT administrators or automation workflows that need to monitor or analyze computer system inventories and statuses within an organization.
Practical examples include:
- Retrieving a list of all monitored computer systems with pagination support.
- Filtering computer systems by specific device filters (e.g., device IDs or types).
- Querying computer systems updated or monitored at a particular timestamp.
Properties
| Name | Meaning |
|---|---|
| Df | Device filter: a string used to filter the computer systems by device criteria. |
| Ts | Monitoring timestamp filter: a string representing a timestamp to filter monitoring data. |
| Cursor | Cursor name: a string used for pagination to indicate the position in the result set. |
| Page Size | Limit number of records per page: a number specifying how many records to return per page. |
Output
The node outputs JSON data containing the response from the NinjaOne API for the "Get Computer Systems" query. The structure typically includes an array of computer system objects with their details as returned by the API. Pagination information may also be included depending on the API response.
No binary data output is produced by this operation.
Dependencies
- Requires an API key credential configured for authenticating with the NinjaOne API via OAuth2.
- The node uses the NinjaOne API endpoint
/v2/computer-systems(inferred from context) with GET requests. - No additional external dependencies beyond the NinjaOne API and n8n's HTTP request helper.
Troubleshooting
- Missing or invalid credentials: Ensure the API key or OAuth2 token is correctly configured and has sufficient permissions.
- Invalid query parameters: Passing incorrect values for filters like
df,ts, orcursormay result in empty responses or errors. Validate parameter formats. - Pagination issues: If using cursor-based pagination, ensure the cursor value is correctly obtained from previous responses.
- API rate limits: Frequent requests might hit NinjaOne API rate limits; handle errors gracefully and consider adding delays or retries.
- Binary data errors: Not applicable here since this operation does not process binary data.
Common error messages will generally come from the NinjaOne API and should be interpreted according to their documentation, e.g., unauthorized access, bad request due to invalid parameters, or server errors.
Links and References
- NinjaOne API Documentation (for detailed API endpoints and parameters)
- n8n HTTP Request Node Documentation (for understanding request handling)
- OAuth2 Authentication in n8n