NinjaOne icon

NinjaOne

Consume NinjaOne API

Actions158

System → Get Active Jobs

AI-generated

Overview

This node interacts with the NinjaOne API to retrieve information about active jobs in the system. Specifically, the "Get Active Jobs" operation under the "System" resource fetches a list of currently active jobs, optionally filtered by job type, device, language, or time zone.

Use cases include monitoring ongoing tasks within an IT management environment, auditing job statuses, or integrating job data into workflows for reporting or alerting purposes.

For example, you might use this node to:

  • Retrieve all active backup jobs running on devices.
  • Filter active jobs by language preference or time zone to localize reports.
  • Track specific job types to trigger downstream automation when certain jobs are active.

Properties

Name Meaning
Job Type Filter active jobs by their type (e.g., backup, scan).
Df Filter active jobs by device identifier or name.
Lang Language tag to filter or localize the job data returned.
Tz Time zone to adjust or filter job timestamps accordingly.

Output

The node outputs JSON data representing the list of active jobs matching the specified filters. Each item in the output array corresponds to one active job and includes details as provided by the NinjaOne API.

No binary data is output by this operation.

Dependencies

  • Requires an API authentication token credential configured in n8n to access the NinjaOne API.
  • The node uses HTTP requests with OAuth2 authentication to communicate with the NinjaOne service.
  • No additional external dependencies beyond the NinjaOne API and n8n's built-in HTTP request capabilities.

Troubleshooting

  • Common issues:

    • Missing or invalid API credentials will cause authentication failures.
    • Providing invalid filter values (e.g., unknown job types or device identifiers) may result in empty responses or errors.
    • Network connectivity problems can prevent successful API calls.
  • Error messages:

    • Authentication errors typically indicate misconfigured or expired API tokens; re-authenticate or update credentials.
    • Validation errors from the API may occur if filter parameters are malformed; verify input values.
    • If no active jobs are found, the output will be an empty array rather than an error.

Links and References

Discussion