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
Backup → Get Backup Jobs
AI-generatedOverview
This node interacts with the NinjaOne API to retrieve backup job information. Specifically, the "Get Backup Jobs" operation under the "Backup" resource fetches a list of backup jobs filtered by various criteria such as device, status, plan type, and time. This is useful for IT administrators or automation workflows that need to monitor backup statuses, audit backup activities, or integrate backup job data into other systems.
Practical examples include:
- Automatically retrieving recent backup jobs to verify successful backups.
- Filtering backup jobs by device or status to generate reports or trigger alerts.
- Paginating through large sets of backup jobs using cursor and page size parameters.
Properties
| Name | Meaning |
|---|---|
| Df | Device filter: filter backup jobs by specific device identifier or name. |
| Ddf | Deleted device filter: filter backup jobs related to deleted devices. |
| Sf | Backup job status filter: filter jobs by their status (e.g., success, failed). |
| Ptf | Backup job planType filter: filter jobs by the type of backup plan used. |
| Stf | Backup job startTime filter: filter jobs based on their start time. |
| Include | Which devices to include in results: options are active, deleted, or all. Default is active. |
| Cursor | Cursor name: used for pagination to continue fetching from a specific point. |
| Page Size | Limit number of records per page: controls how many backup job records are returned per request. Default is 10000. |
Output
The node outputs an array of JSON objects representing backup jobs matching the specified filters. Each item in the output contains the raw JSON response from the NinjaOne API for backup jobs.
The structure of each JSON object corresponds directly to the NinjaOne API's backup job schema, including details such as job ID, device info, status, plan type, start time, and other metadata.
No binary data output is produced by this operation.
Dependencies
- Requires an active NinjaOne API OAuth2 credential configured in n8n for authentication.
- The node uses the NinjaOne REST API endpoint
/v2/backup/jobs(implied by query parameters) to fetch backup job data. - No additional external dependencies beyond the NinjaOne API and n8n's HTTP request capabilities.
Troubleshooting
Common issues:
- Invalid or expired API credentials will cause authentication failures.
- Providing invalid filter values may result in empty responses or API errors.
- Large page sizes might lead to timeouts or performance issues depending on the API limits.
Error messages:
- Authentication errors typically indicate misconfigured or missing API credentials; re-authenticate or update credentials.
- Request errors due to invalid parameters should be resolved by verifying filter values conform to expected formats.
- Network or timeout errors can be mitigated by reducing page size or retrying later.
Links and References
- NinjaOne API Documentation (general reference for backup job endpoints)
- n8n Documentation - Creating Custom Nodes