Datto RMM

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

Actions53

Overview

This node interacts with the Datto RMM API to update site information within a managed environment. It allows users to modify details of an existing site such as its name, description, notes, and deployment settings. This is useful for IT administrators or managed service providers who need to keep site metadata current or adjust deployment configurations dynamically.

Practical examples include:

  • Renaming a site to reflect organizational changes.
  • Adding descriptive notes to a site for better documentation.
  • Enabling or disabling on-demand deployment for specific sites.
  • Activating automatic installation of Splashtop remote access software on devices within the site.

Properties

Name Meaning
Site Select the target site from a list of available sites to update.
Site Name The new or updated name for the site (required).
Description A textual description providing additional context about the site.
Notes Additional notes related to the site for internal reference.
On Demand Boolean flag to enable or disable on-demand deployment for the site.
Splashtop Auto Install Boolean flag to enable or disable automatic installation of Splashtop on site devices.
Fields to Return Allows selection of which fields should be included in the response after the update.

Output

The node outputs JSON data representing the updated site object as returned by the Datto RMM API. The structure includes all site properties, potentially filtered by the "Fields to Return" property if specified. This output can be used downstream in workflows for logging, conditional logic, or further processing.

No binary data output is involved.

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 endpoint for sites (/api/v2/account/sites and related).
  • Proper permissions on the API key are necessary to perform update operations on sites.

Troubleshooting

  • Common Issues:

    • Invalid or missing site UID: Ensure the selected site exists and the UID is correct.
    • Insufficient API permissions: Verify that the API key has rights to update site information.
    • Network or connectivity errors: Confirm network access to the Datto RMM API endpoint.
    • Validation errors on required fields like "Site Name": Make sure mandatory fields are provided.

  • Error Messages:

    • "Resource site is not supported yet." — This would indicate a misconfiguration or unsupported resource; however, site resource is supported here.
    • API error responses typically include HTTP status codes and messages; check these for clues (e.g., 400 Bad Request for invalid input).

  • Resolution Tips:

    • Double-check all required parameters before execution.
    • Review API credentials and their scopes.
    • Use the "Fields to Return" property carefully to avoid requesting unsupported fields.

Links and References

Discussion