The CloudRadial AutomationAI Datto RMM extension lets a workflow or agent work with your Datto RMM account: inventory devices and their audits, read patch status and user-defined fields (UDFs), triage and resolve alerts, run components as quick jobs and read their output, and manage sites and variables. This article covers what the extension can do, the API user and secrets it needs, which tools require approval, and the skills that ship with it. It is for workspace users who build automations (Admin or Owner Role).
- What the Extension Covers
- Creating the API User
- Providing the Credentials to Your Runner
- Reads and Approval-Gated Changes
- Skills
- Tips for Working With Datto RMM
What the Extension Covers
The extension calls the Datto RMM API v2 and provides 21 tools across five areas:
| Area | Tools | What you can automate |
| Devices and audits | 6 | List the devices in your account, read one device's record, read its installed-software and hardware audits, and read its UDFs and patch status |
| Sites and variables | 7 | List sites, read a site and the devices in it, read site variables and account-wide variables, create a site, and create a site variable |
| Alerts | 3 | Read the open alerts on a device or a site, and resolve an alert |
| Components and jobs | 4 | Run a component on a device as a quick job, check the job's status, and read the output and errors the component produced |
| Device UDFs | 1 | Set one or more UDFs (UDF 1-30) on a device |
Install it from Extensions like any other catalog extension. See Browsing and installing extensions for the general install flow.
Creating the API User
The extension signs in to Datto RMM with the API keys of a Datto RMM user. The runner exchanges the key and secret for a short-lived access token and sends that token on every call, so you store only the key and secret.
- If API access isn't on yet, an administrator turns on Enable API Access under Setup > Global Settings > Access Control.
- Go to Setup > Users, click the user, and click Generate API Keys.
- Choose the user's API Security Level and API Component Level. The security level sets what the extension can do through the API, so it must allow the reads and changes the tools you plan to use need.
- Copy the API Key and the API Secret Key, note the API URL, and click Save User. The API Secret Key is hidden once you leave the page and can't be retrieved, and generating keys again invalidates the old ones.
For details, see Datto's Datto RMM API documentation.
Providing the Credentials to Your Runner
Store three secrets in your runner's Key Vault with these exact names:
| Secret | Value |
Datto-ApiUrl |
Your platform-specific API host, in the form https://{platform}-api.centrastage.net, for example https://merlot-api.centrastage.net. Platforms include merlot, syrah, vidal, pinotage, concord, and zinfandel. Use the API URL shown on the user's page after you generate the keys. Enter the host only; the extension adds the /api path itself. |
Datto-ApiKey |
The API user's API key (its public key) |
Datto-ApiSecret |
The same API user's secret key |
For how to add secrets, see Accessing and updating your runner's Key Vault. The agent reads the credentials from the runner and never asks you for them.
Reads and Approval-Gated Changes
Of the 21 tools, 16 only read data and run without interruption. The other five create, run, resolve, or set something in Datto RMM, and every one of them pauses the run for approval. The request appears as an Action Required item in the Inbox until someone approves it. See Handling Action Required items in the Inbox.
| Tool behavior | Tools |
| Approval-gated | Create a site; create a site variable; resolve an alert; run a component on a device as a quick job; set device UDFs |
| Read-only | List and read devices; read software and hardware audits, UDFs, and patch status; list and read sites, site devices, site variables, and account variables; read open device and site alerts; read job status, output, and errors |
A quick job runs a component, which is a script, on a real device. Before you approve one, check the device and the component the agent names.
Skills
The extension ships six skills that guide an agent through common Datto RMM tasks:
| Skill | Use it to |
| Inventory Datto RMM Devices and Audits | List devices, look up one device, or read its software, hardware, UDF, or patch data. Read-only. |
| Manage Datto RMM Sites and Site Variables | List or inspect sites and their devices, read site variables, and create a site or a site variable. Creates are approval-gated. |
| Read Datto RMM Account Variables | Read the account-level variables that apply across all sites. Read-only. |
| Run Components and Track Datto RMM Jobs | Run a component on a device as a quick job, then track its progress and read its output. Running the job is approval-gated. |
| Set Datto RMM Device UDFs | Set one or more UDFs (UDF 1-30) on a device. Approval-gated. |
| Triage and Resolve Datto RMM Alerts | Review the open alerts on a device or site, then resolve them. Resolving is approval-gated. |
Tips for Working With Datto RMM
- Refer to sites and devices by name. The agent resolves each name to its Datto RMM id before any change.
- The device and site list tools return the complete list in one call, so you don't need to page through results
- To run a component as a quick job, give its component id. You can see it in the component's URL in the Datto RMM web interface. The extension can't list the components in your account.
- The Datto RMM API v2 doesn't support muting alerts or moving a device between sites, so the extension doesn't offer them
- Masked variable values are redacted in the results
- Timestamps in Datto RMM results are Unix epoch milliseconds
- Datto RMM allows about 600 reads and 100 writes per 60 seconds. If a call is rate limited (HTTP 429), wait about a minute before trying again.
If you are still having trouble, we’re here to help! Submit a ticket here for assistance, and don’t forget to check our status page to ensure there are no outages in your area.
Comments
0 comments
Please sign in to leave a comment.