Datto RMM

Interact with Datto RMM API to manage devices, sites, alerts, and monitoring

Actions53

Overview

The node interacts with the Datto RMM API to retrieve detailed results of a specific job executed on a device. It is useful for IT administrators and managed service providers who want to programmatically access job execution outcomes, including standard output and error logs, for monitoring, auditing, or automation purposes.

Typical use cases include:

  • Fetching the results of a software deployment or script execution job on a particular device.
  • Automating the collection of job outputs for reporting or alerting.
  • Integrating job result data into other workflows or systems for further processing.

For example, after triggering a patch management job on multiple devices, this node can be used to gather the success/failure details and logs from each job run.

Properties

Name Meaning
Job Select the specific job to retrieve results from. The list is dynamically loaded from available jobs.
Device Select the device for which to retrieve the job results. The list is dynamically loaded from available devices.
Retrieve All Boolean flag indicating whether to automatically retrieve all pages of results using pagination (true), or manually specify page number and max results per page (false).
Page When Retrieve All is false, specifies the 1-based page number of results to fetch.
Max Results When Retrieve All is false, specifies the maximum number of results to return per page.
Include Output Details Whether to include the standard output (stdout) and standard error (stderr) logs in the results. Including these may increase the response size.
Fields to Include Allows selecting which fields to include in the response. This supports fine-grained control over the returned data, potentially reducing payload size by excluding unnecessary fields.

Output

The node outputs JSON data representing the job results for the specified job and device. The structure includes:

  • Metadata about the job and device.
  • Result entries detailing execution status, timestamps, and other relevant information.
  • Optionally, the standard output and standard error logs if "Include Output Details" is enabled.

If the job produces binary data (not typical for this operation), it would be included as binary output, but this node primarily returns structured JSON data.

Dependencies

  • Requires an active connection to the Datto RMM API via an API key credential configured in n8n.
  • The node depends on the Datto RMM API endpoints for jobs and devices.
  • Pagination support requires handling API pagination parameters.
  • Dynamic loading of options (jobs, devices) depends on successful API calls to list those resources.

Troubleshooting

  • Common Issues:

    • Invalid or expired API credentials will cause authentication errors.
    • Selecting a job or device that no longer exists or is inaccessible will result in not found or permission errors.
    • Large result sets without pagination may lead to timeouts or memory issues.
    • Including output details may increase response size significantly; consider disabling if performance is impacted.

  • Error Messages:

    • "Resource job is not supported yet." — indicates an unsupported resource selection; ensure the correct resource and operation are chosen.
    • API errors related to permissions or invalid parameters should be resolved by verifying API credentials and input values.
    • Network or connectivity errors require checking the API URL and network access.

Links and References

This summary is based solely on static analysis of the provided source code and property definitions.

Discussion