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 run a site-wide audit on all devices within a selected site. It supports different types of audits—device, software, or hardware—allowing users to gather comprehensive information about device configurations, installed software, or hardware details across their managed environment. This node is beneficial for IT administrators and managed service providers who want to automate inventory checks, compliance audits, or troubleshooting by collecting up-to-date data from multiple devices in one operation.

Practical examples include:

  • Running a Device Audit to get detailed status and configuration info for all devices at a site.
  • Performing a Software Audit to inventory installed applications across all site devices.
  • Executing a Hardware Audit to verify hardware components and configurations for asset management.

Properties

Name Meaning
Site Select the specific site where the audit should be performed on all devices. The list is dynamically loaded from available sites.
Audit Type Choose the type of audit to perform:
• Device Audit — complete device information
• Software Audit — software inventory
• Hardware Audit — hardware configuration details
Device Filters Optional filters to narrow down which devices to audit based on:
• Device Types (Workstation, Server, Laptop, Network Device, Virtual Machine)
• Operating Systems (Windows, macOS, Linux, Other)
• Online Status (All, Online Only, Offline Only)
Execution Options Configure execution behavior:
• Continue on Device Error (boolean) — whether to proceed if one device audit fails
• Max Concurrent Audits (number 1-10) — limits simultaneous audits
• Include Device Summary (boolean) — include summary of audit results
Include Archived Data Boolean option to include archived or historical audit data for all devices during the audit

Output

The node outputs JSON data containing the results of the site audit. The structure includes detailed audit information per device according to the selected audit type (device, software, or hardware). If enabled, it also includes a summary of the entire site audit execution.

The output JSON typically contains:

  • Device-specific audit data arrays or objects.
  • Metadata about the audit execution such as timestamps, status, and any errors encountered.
  • Optionally, archived/historical data if requested.

No binary data output is indicated for this operation.

Dependencies

  • Requires an active connection to the Datto RMM API using a valid API authentication token configured in n8n credentials.
  • The node depends on the Datto RMM API endpoints for sites, devices, and audit operations.
  • Proper permissions on the API key are necessary to read site and device information and to trigger audits.

Troubleshooting

  • Common issues:

    • Invalid or expired API credentials will cause authentication failures.
    • Selecting a site with no devices may result in empty audit results.
    • Setting max concurrent audits too high might lead to rate limiting or API throttling.
    • Device filters that exclude all devices will produce no audit data.

  • Error messages:

    • "Resource audit is not supported yet" — indicates an unsupported resource selection; ensure "Audit" resource is chosen.
    • API request errors such as 401 Unauthorized or 403 Forbidden suggest credential or permission problems.
    • Network timeouts or connectivity errors indicate issues reaching the Datto RMM API endpoint.

  • Resolutions:

    • Verify API credentials and permissions.
    • Confirm the selected site has devices matching filter criteria.
    • Adjust concurrency settings to avoid API rate limits.
    • Check network connectivity and API base URL configuration.

Links and References

Discussion