Datto RMM
App · 25 actions
Work with Datto RMM remote monitoring and management: manage sites, devices, site variables and alerts, run components on devices and read their results, read audits, software, patches and the activity log, and start workflows on new alerts, new or offline devices, reboot, antivirus and patch problems, new sites and new activity.
Actions
| Action | What it does |
|---|---|
| Create site | Create a site for a new customer or location, ready for its devices' agents. |
| Create site variable | Add a variable to a site for its components and scripts to read, optionally with its value hidden. |
| Delete site variable | Delete a variable from a site. |
| Get alert | Get one alert: its priority, diagnostics, device, ticket and whether it is resolved. |
| Get device | Get one device: its site, host name, IP addresses, operating system, whether it is online, when it was last seen, its warranty, antivirus and patch status. |
| Get device audit | Get a device's hardware and software audit: make, model, serial number, BIOS, operating system, memory, disks and network adapters (or a printer's or ESXi host's own audit). |
| Get job | Get a job's name, when it was created and whether it is still active or completed. |
| Get job results | Get how a job went on one device (Success, Failure, Running and so on), each component's result and, optionally, what it wrote. |
| Get site | Get one site's name, description, notes and device counts. |
| List activity log | Read the account's activity log: jobs run, remote sessions, changes made by users and more, newest first, over the last day unless you choose a window. |
| List alerts | List open or resolved alerts for the whole account, one site or one device, with their priority, what the monitor reported and the device it is about. |
| List components | List the components (scripts and installers) in the account's library, with the values each one takes. |
| List device patches | List a device's operating system patches: installed, approved and waiting, or not approved, with severity and whether they need a reboot. |
| List device software | List the programs installed on a computer, with their versions, from its latest audit. |
| List devices | Find devices across the account by host name, operating system, type or device filter, with their site, status, last seen time, antivirus and patch status. |
| List site devices | List the devices in one site, optionally only those matching a device filter. |
| List site variables | List a site's variables, which its components and scripts read. |
| List sites | List the account's sites (each customer or location), with their device counts and linked Autotask company. |
| Move device to site | Move a device to another site. |
| Resolve alert | Mark an alert resolved, as a technician would once the problem is fixed. |
| Run quick job | Run a component on a device now, as a quick job, with the values you give its variables. |
| Set device user-defined fields | Set or clear a device's user-defined fields (udf1 to udf300). |
| Set device warranty date | Set the date a device's warranty ends, or clear it. |
| Update site | Change a site's name, description, notes or settings. |
| Update site variable | Change a site variable's value, and its name if you give a new one. |
Create site
Create a site for a new customer or location, ready for its devices' agents.
Inputs
- Name
nametextRequired - The site's name, usually the customer's name.
- Description
descriptiontext - A short description of the site.
- Notes
notestext - Notes for technicians.
- On-demand site
on_demandtrue/false - Make it an on-demand site, whose devices are supported only when asked.
- Install Splashtop automatically
splashtop_auto_installtrue/false - Install Splashtop remote access on the site's devices.
Outputs
siteobject- The new site
Example output
{
"site": {
"accountUid": "acct-5678",
"autotaskCompanyId": "29683",
"autotaskCompanyName": "Contoso Ltd",
"description": "Head office and branches",
"devicesStatus": {
"numberOfDevices": 42,
"numberOfOfflineDevices": 3,
"numberOfOnlineDevices": 39
},
"id": 1234,
"name": "Contoso Ltd",
"notes": "Main contact: Jo Smith",
"onDemand": false,
"portalUrl": "https://merlot.centrastage.net/csm/site/1234",
"splashtopAutoInstall": true,
"uid": "4a1b0d3e-5c2f-4e8a-9b7d-1f2e3d4c5b6a"
}
}Create site variable
Add a variable to a site for its components and scripts to read, optionally with its value hidden.
Inputs
- Site
site_uidtextRequired - The site (a customer or location). Pick one, or give its UID.
- Name
nametextRequired - The variable's name, as components refer to it.
- Value
valuetextRequired - The variable's value.
- Hide value
maskedtrue/false - Hide the value in Datto RMM, for a password or key.
Outputs
site_uidtext- The site's UID
variableobject- The new variable, with its id
Example output
{
"site_uid": "4a1b0d3e-5c2f-4e8a-9b7d-1f2e3d4c5b6a",
"variable": {
"id": 3301,
"masked": false,
"name": "BackupServer",
"value": "CONTOSO-NAS-01"
}
}Delete site variable
Delete a variable from a site.
Inputs
- Site
site_uidtextRequired - The site (a customer or location). Pick one, or give its UID.
- Variable
variable_idtextRequired - The site variable. Pick one, or give its id from an earlier step.
Outputs
deletedtrue/false- True once Datto RMM accepted it
site_uidtext- The site's UID
variable_idnumber- The variable deleted
Example output
{
"deleted": true,
"site_uid": "4a1b0d3e-5c2f-4e8a-9b7d-1f2e3d4c5b6a",
"variable_id": 3301
}Get alert
Get one alert: its priority, diagnostics, device, ticket and whether it is resolved.
Inputs
- Alert UID
alert_uidtextRequired - The alert's UID, from 'List alerts', a trigger or an earlier step.
Outputs
alertobject- The alert
Example output
{
"alert": {
"alertContext": {
"@class": "disk_usage_ctx",
"diskName": "C:"
},
"alertMonitorInfo": {
"createsTicket": true,
"sendsEmails": true
},
"alertSourceInfo": {
"deviceName": "CONTOSO-PC-01",
"deviceUid": "8d3f6a2b-1c4e-4f5a-9e7b-2a3b4c5d6e7f",
"siteName": "Contoso Ltd",
"siteUid": "4a1b0d3e-5c2f-4e8a-9b7d-1f2e3d4c5b6a"
},
"alertUid": "9e8d7c6b-5a4f-4e3d-8c2b-1a0f9e8d7c6b",
"autoresolveMins": 0,
"diagnostics": "Disk C: has 4% free space (4.1 GB of 237 GB)",
"muted": false,
"priority": "High",
"resolved": false,
"resolvedBy": "",
"resolvedOn": "",
"responseActions": [
{
"actionReference": "T20261112.0042",
"actionReferenceInt": "",
"actionTime": "2026-11-12T08:30:15.000Z",
"actionType": "TICKET_CREATED",
"description": "Ticket created in Autotask"
}
],
"ticketNumber": "T20261112.0042",
"timestamp": "2026-11-12T08:30:12.000Z"
}
}Get device
Get one device: its site, host name, IP addresses, operating system, whether it is online, when it was last seen, its warranty, antivirus and patch status.
Inputs
- Device
device_uidtextRequired - The device. Pick one, or give its UID (or numeric id) from an earlier step.
Outputs
deviceobject- The device
Example output
{
"device": {
"a64Bit": true,
"antivirus": {
"antivirusProduct": "Microsoft Defender Antivirus",
"antivirusStatus": "RunningAndUpToDate"
},
"cagVersion": "4.4.2215.2215",
"creationDate": "2025-03-04T14:20:00.000Z",
"deleted": false,
"description": "Reception PC",
"deviceClass": "device",
"deviceType": {
"category": "Desktop",
"type": "Desktop"
},
"displayVersion": "4.4.2215",
"domain": "CONTOSO",
"extIpAddress": "203.0.113.10",
"hostname": "CONTOSO-PC-01",
"id": 987654,
"intIpAddress": "10.0.0.25",
"lastAuditDate": "2026-11-12T03:15:00.000Z",
"lastLoggedInUser": "CONTOSO\\jsmith",
"lastReboot": "2026-11-10T07:02:44.000Z",
"lastSeen": "2026-11-12T09:41:05.000Z",
"networkProbe": false,
"onboardedViaNetworkMonitor": false,
"online": true,
"operatingSystem": "Microsoft Windows 11 Pro 10.0.26100",
"patchManagement": {
"patchStatus": "FullyPatched",
"patchesApprovedPending": 0,
"patchesInstalled": 118,
"patchesNotApproved": 2
},
"portalUrl": "https://merlot.centrastage.net/csm/search?qs=uid%3A8d3f6a2b-1c4e-4f5a-9e7b-2a3b4c5d6e7f",
"rebootRequired": false,
"siteId": 1234,
"siteName": "Contoso Ltd",
"siteUid": "4a1b0d3e-5c2f-4e8a-9b7d-1f2e3d4c5b6a",
"snmpEnabled": false,
"softwareStatus": "Compliant",
"suspended": false,
"uid": "8d3f6a2b-1c4e-4f5a-9e7b-2a3b4c5d6e7f",
"warrantyDate": "2028-03-31",
"webRemoteUrl": "https://merlot.centrastage.net/csm/remote/rto/987654"
}
}Get device audit
Get a device's hardware and software audit: make, model, serial number, BIOS, operating system, memory, disks and network adapters (or a printer's or ESXi host's own audit).
Inputs
- Device
device_uidtextRequired - The device. Pick one, or give its UID (or numeric id) from an earlier step.
Outputs
auditobject- The audit. A printer's or ESXi host's has the fields Datto RMM keeps for that kind of device.
device_classtext- device, printer or esxihost
device_uidtext- The device's UID
hostnametext- The device's host name
Example output
{
"audit": {
"baseBoard": {
"manufacturer": "Dell Inc.",
"product": "0R4JH6"
},
"bios": {
"instance": "Dell Inc. 1.14.0",
"releaseDate": "2025-06-12T00:00:00.000Z",
"serialNumber": "7XK2Q93",
"smBiosVersion": "3.4"
},
"displays": [
{
"instance": "DELL P2422H",
"screenHeight": 1080,
"screenWidth": 1920
}
],
"logicalDisks": [
{
"description": "Local Fixed Disk",
"diskIdentifier": "C:",
"freespace": 4402341478,
"size": 254476611584
}
],
"nics": [
{
"instance": "Intel(R) Ethernet Connection I219-LM",
"ipv4": "10.0.0.25",
"ipv6": "",
"macAddress": "B0:4F:13:0A:1B:2C",
"type": "Ethernet"
}
],
"osInfo": {
"osArchitecture": "64-bit",
"osDisplayVersion": "24H2",
"osInstallationType": "Client",
"osName": "Microsoft Windows 11 Pro",
"osVersion": "10.0.26100"
},
"physicalMemory": [
{
"bank": "BANK 0",
"module": "DIMM1",
"partNumber": "HMCG78AGBSA095N",
"serialNumber": "1A2B3C4D",
"size": 17179869184,
"speed": "4800",
"type": "DDR5"
}
],
"portalUrl": "https://merlot.centrastage.net/csm/search?qs=uid%3A8d3f6a2b-1c4e-4f5a-9e7b-2a3b4c5d6e7f",
"processors": [
{
"name": "13th Gen Intel(R) Core(TM) i7-13700"
}
],
"systemInfo": {
"dotNetVersion": "4.8.09032",
"manufacturer": "Dell Inc.",
"model": "OptiPlex 7010",
"totalCpuCores": 8,
"totalPhysicalMemory": 17179869184,
"username": "CONTOSO\\jsmith"
},
"videoBoards": [
{
"displayAdapter": "Intel(R) UHD Graphics 770"
}
],
"webRemoteUrl": "https://merlot.centrastage.net/csm/remote/rto/987654"
},
"device_class": "device",
"device_uid": "8d3f6a2b-1c4e-4f5a-9e7b-2a3b4c5d6e7f",
"hostname": "CONTOSO-PC-01"
}Get job
Get a job's name, when it was created and whether it is still active or completed.
Inputs
- Job UID
job_uidtextRequired - The job's UID, from 'Run quick job' or an earlier step.
Outputs
jobobject- The job
Example output
{
"job": {
"dateCreated": "2026-11-12T10:00:00.000Z",
"id": 55501,
"name": "Quick job from Lodol",
"status": "active",
"uid": "2f3e4d5c-6b7a-4c8d-9e0f-1a2b3c4d5e6f"
}
}Get job results
Get how a job went on one device (Success, Failure, Running and so on), each component's result and, optionally, what it wrote.
Inputs
- Job UID
job_uidtextRequired - The job's UID, from 'Run quick job' or an earlier step.
- Device
device_uidtextRequired - The device the job ran on. Pick one, or give its UID.
- Include output
include_outputtrue/false - Also return what each component wrote to its output and error streams.
Outputs
resultsobject- The job's results on the device
statustext- The job's status on the device, such as Success or Failure
stderrlist- What each component wrote to its errors
stdoutlist- What each component wrote to its output
Example output
{
"results": {
"componentResults": [
{
"componentName": "Clear Temp Files",
"componentStatus": "Success",
"componentUid": "7c6b5a4d-3e2f-4a1b-8c9d-0e1f2a3b4c5d",
"hasStdErr": false,
"hasStdOut": true,
"numberOfWarnings": 0
}
],
"deviceUid": "8d3f6a2b-1c4e-4f5a-9e7b-2a3b4c5d6e7f",
"jobDeploymentStatus": "Success",
"jobUid": "2f3e4d5c-6b7a-4c8d-9e0f-1a2b3c4d5e6f",
"ranOn": "2026-11-12T10:01:30.000Z"
},
"status": "Success",
"stderr": [],
"stdout": [
{
"componentName": "Clear Temp Files",
"componentUid": "7c6b5a4d-3e2f-4a1b-8c9d-0e1f2a3b4c5d",
"stdData": "Removed 312 files (1.2 GB)."
}
]
}Get site
Get one site's name, description, notes and device counts.
Inputs
- Site
site_uidtextRequired - The site (a customer or location). Pick one, or give its UID.
Outputs
siteobject- The site
Example output
{
"site": {
"accountUid": "acct-5678",
"autotaskCompanyId": "29683",
"autotaskCompanyName": "Contoso Ltd",
"description": "Head office and branches",
"devicesStatus": {
"numberOfDevices": 42,
"numberOfOfflineDevices": 3,
"numberOfOnlineDevices": 39
},
"id": 1234,
"name": "Contoso Ltd",
"notes": "Main contact: Jo Smith",
"onDemand": false,
"portalUrl": "https://merlot.centrastage.net/csm/site/1234",
"splashtopAutoInstall": true,
"uid": "4a1b0d3e-5c2f-4e8a-9b7d-1f2e3d4c5b6a"
}
}List activity log
Read the account's activity log: jobs run, remote sessions, changes made by users and more, newest first, over the last day unless you choose a window.
Inputs
- From
sincedate and time - The start of the window. Defaults to 24 hours ago.
- Until
untildate and time - The end of the window. Defaults to now.
- Activity type
entitieslist - Only device activity, user activity, or both when left empty.One or more of:
device(Device activity),user(User activity). - Categories
categorieslist - Only these categories, as the activity log names them, such as job or remote.
- Actions
log_actionslist - Only these actions, as the activity log names them, such as deployment.
- Site
site_uidtext - Only activity in this site.
- Search
searchtext - Words to look for, as in the activity log's own search box.
- Order
ordertext - Newest or oldest first.One of:
desc(Newest first),asc(Oldest first). Default:desc. - How many
page_sizenumber - How many to return, 1 to 250. Defaults to 50.From 1 to 250.
Outputs
activitieslist- The activities
countnumber- How many came back
has_moretrue/false- True when more matched; narrow the window to read them
Example output
{
"activities": [
{
"action": "deployment",
"category": "job",
"date": "2026-11-12T10:01:30.000Z",
"details": {
"job.name": "Quick job from Lodol",
"job.status": "success"
},
"deviceId": 987654,
"entity": "DEVICE",
"hasStdErr": false,
"hasStdOut": true,
"hostname": "CONTOSO-PC-01",
"id": "q9vX3ZQBp1Wk2nLr8aYc",
"site": {
"id": 1234,
"name": "Contoso Ltd"
},
"user": {
"firstName": "Jo",
"id": 77,
"lastName": "Smith",
"userName": "jsmith"
}
}
],
"count": 1,
"has_more": false
}List alerts
List open or resolved alerts for the whole account, one site or one device, with their priority, what the monitor reported and the device it is about.
Inputs
- Status
statustext - Open or resolved alerts.One of:
open,resolved. Default:open. - Site
site_uidtext - Only this site's alerts. Leave empty for the whole account.
- Device
device_uidtext - Only this device's alerts, instead of a site's.
- Page size
page_sizenumber - How many to return, 1 to 250. Defaults to 50.From 1 to 250.
- Page
pagenumber - Which page to return, counting from 0. Use 'next_page' from an earlier result to read on.At least 0.
Outputs
alertslist- The alerts on this page
countnumber- How many are on this page
has_moretrue/false- True when another page follows
next_pagenumber- The page to ask for next, when has_more is true
pagenumber- This page's number, from 0
statustext- open or resolved
totalnumber- How many there are in all
Example output
{
"alerts": [
{
"alertContext": {
"@class": "disk_usage_ctx",
"diskName": "C:"
},
"alertMonitorInfo": {
"createsTicket": true,
"sendsEmails": true
},
"alertSourceInfo": {
"deviceName": "CONTOSO-PC-01",
"deviceUid": "8d3f6a2b-1c4e-4f5a-9e7b-2a3b4c5d6e7f",
"siteName": "Contoso Ltd",
"siteUid": "4a1b0d3e-5c2f-4e8a-9b7d-1f2e3d4c5b6a"
},
"alertUid": "9e8d7c6b-5a4f-4e3d-8c2b-1a0f9e8d7c6b",
"autoresolveMins": 0,
"diagnostics": "Disk C: has 4% free space (4.1 GB of 237 GB)",
"muted": false,
"priority": "High",
"resolved": false,
"resolvedBy": "",
"resolvedOn": "",
"responseActions": [
{
"actionReference": "T20261112.0042",
"actionReferenceInt": "",
"actionTime": "2026-11-12T08:30:15.000Z",
"actionType": "TICKET_CREATED",
"description": "Ticket created in Autotask"
}
],
"ticketNumber": "T20261112.0042",
"timestamp": "2026-11-12T08:30:12.000Z"
}
],
"count": 1,
"has_more": false,
"next_page": 0,
"page": 0,
"status": "open",
"total": 1
}List components
List the components (scripts and installers) in the account's library, with the values each one takes.
Inputs
- Page size
page_sizenumber - How many to return, 1 to 250. Defaults to 50.From 1 to 250.
- Page
pagenumber - Which page to return, counting from 0. Use 'next_page' from an earlier result to read on.At least 0.
Outputs
componentslist- The components on this page
countnumber- How many are on this page
has_moretrue/false- True when another page follows
next_pagenumber- The page to ask for next, when has_more is true
pagenumber- This page's number, from 0
totalnumber- How many there are in all
Example output
{
"components": [
{
"categoryCode": "Scripts",
"credentialsRequired": false,
"description": "Deletes temporary files from the Windows temp folders.",
"id": 4321,
"name": "Clear Temp Files",
"uid": "7c6b5a4d-3e2f-4a1b-8c9d-0e1f2a3b4c5d",
"variables": [
{
"defaultVal": "7",
"description": "Only files older than this many days",
"direction": false,
"name": "DaysOld",
"type": "String",
"variablesIdx": 0
}
]
}
],
"count": 1,
"has_more": false,
"next_page": 0,
"page": 0,
"total": 1
}List device patches
List a device's operating system patches: installed, approved and waiting, or not approved, with severity and whether they need a reboot.
Inputs
- Device
device_uidtextRequired - The device. Pick one, or give its UID (or numeric id) from an earlier step.
- Status
install_statustext - Only patches in this state. Leave empty for all of them.One of:
APPROVED_PENDING(Approved, waiting to install),NOT_APPROVED(Not approved),INSTALLED. - Page size
page_sizenumber - How many to return, 1 to 250. Defaults to 50.From 1 to 250.
- Page
pagenumber - Which page to return, counting from 0. Use 'next_page' from an earlier result to read on.At least 0.
Outputs
countnumber- How many are on this page
device_uidtext- The device's UID
has_moretrue/false- True when another page follows
next_pagenumber- The page to ask for next, when has_more is true
pagenumber- This page's number, from 0
patcheslist- The patches on this page
totalnumber- How many there are in all
Example output
{
"count": 1,
"device_uid": "8d3f6a2b-1c4e-4f5a-9e7b-2a3b4c5d6e7f",
"has_more": false,
"next_page": 0,
"page": 0,
"patches": [
{
"category": [
"Security Updates"
],
"description": "Install this update to resolve issues in Windows.",
"installStatus": "APPROVED_PENDING",
"kbArticleId": "5050031",
"manualOverride": false,
"maxSize": 734003200,
"patchId": "c1b2a3d4-0000-4000-8000-000000005031",
"rebootRequired": true,
"releaseDate": "2026-11-11",
"requireUserInput": false,
"severity": "CRITICAL",
"title": "2026-11 Cumulative Update for Windows 11 Version 24H2 (KB5050031)",
"type": "SOFTWARE"
}
],
"total": 1
}List device software
List the programs installed on a computer, with their versions, from its latest audit.
Inputs
- Device
device_uidtextRequired - The device. Pick one, or give its UID (or numeric id) from an earlier step.
- Page size
page_sizenumber - How many to return, 1 to 250. Defaults to 50.From 1 to 250.
- Page
pagenumber - Which page to return, counting from 0. Use 'next_page' from an earlier result to read on.At least 0.
Outputs
countnumber- How many are on this page
device_uidtext- The device's UID
has_moretrue/false- True when another page follows
next_pagenumber- The page to ask for next, when has_more is true
pagenumber- This page's number, from 0
softwarelist- The programs on this page
totalnumber- How many there are in all
Example output
{
"count": 1,
"device_uid": "8d3f6a2b-1c4e-4f5a-9e7b-2a3b4c5d6e7f",
"has_more": false,
"next_page": 0,
"page": 0,
"software": [
{
"name": "Google Chrome",
"version": "131.0.6778.86"
}
],
"total": 1
}List devices
Find devices across the account by host name, operating system, type or device filter, with their site, status, last seen time, antivirus and patch status.
Inputs
- Host name contains
hostnametext - Only devices whose host name contains this.
- Operating system contains
operating_systemtext - Only devices whose operating system contains this, such as Windows 11.
- Device type contains
device_typetext - Only devices whose type contains this, such as Server or Laptop.
- Device filter
filter_idtext - Only devices matching this Datto RMM device filter. When chosen, it alone decides which devices come back.
- Page size
page_sizenumber - How many to return, 1 to 250. Defaults to 50.From 1 to 250.
- Page
pagenumber - Which page to return, counting from 0. Use 'next_page' from an earlier result to read on.At least 0.
Outputs
countnumber- How many are on this page
deviceslist- The devices on this page
has_moretrue/false- True when another page follows
next_pagenumber- The page to ask for next, when has_more is true
pagenumber- This page's number, from 0
totalnumber- How many there are in all
Example output
{
"count": 1,
"devices": [
{
"a64Bit": true,
"antivirus": {
"antivirusProduct": "Microsoft Defender Antivirus",
"antivirusStatus": "RunningAndUpToDate"
},
"cagVersion": "4.4.2215.2215",
"creationDate": "2025-03-04T14:20:00.000Z",
"deleted": false,
"description": "Reception PC",
"deviceClass": "device",
"deviceType": {
"category": "Desktop",
"type": "Desktop"
},
"displayVersion": "4.4.2215",
"domain": "CONTOSO",
"extIpAddress": "203.0.113.10",
"hostname": "CONTOSO-PC-01",
"id": 987654,
"intIpAddress": "10.0.0.25",
"lastAuditDate": "2026-11-12T03:15:00.000Z",
"lastLoggedInUser": "CONTOSO\\jsmith",
"lastReboot": "2026-11-10T07:02:44.000Z",
"lastSeen": "2026-11-12T09:41:05.000Z",
"networkProbe": false,
"onboardedViaNetworkMonitor": false,
"online": true,
"operatingSystem": "Microsoft Windows 11 Pro 10.0.26100",
"patchManagement": {
"patchStatus": "FullyPatched",
"patchesApprovedPending": 0,
"patchesInstalled": 118,
"patchesNotApproved": 2
},
"portalUrl": "https://merlot.centrastage.net/csm/search?qs=uid%3A8d3f6a2b-1c4e-4f5a-9e7b-2a3b4c5d6e7f",
"rebootRequired": false,
"siteId": 1234,
"siteName": "Contoso Ltd",
"siteUid": "4a1b0d3e-5c2f-4e8a-9b7d-1f2e3d4c5b6a",
"snmpEnabled": false,
"softwareStatus": "Compliant",
"suspended": false,
"uid": "8d3f6a2b-1c4e-4f5a-9e7b-2a3b4c5d6e7f",
"warrantyDate": "2028-03-31",
"webRemoteUrl": "https://merlot.centrastage.net/csm/remote/rto/987654"
}
],
"has_more": false,
"next_page": 0,
"page": 0,
"total": 1
}List site devices
List the devices in one site, optionally only those matching a device filter.
Inputs
- Site
site_uidtextRequired - The site (a customer or location). Pick one, or give its UID.
- Device filter
filter_idtext - Only devices matching this Datto RMM device filter, such as all servers. Leave empty for every device.
- Page size
page_sizenumber - How many to return, 1 to 250. Defaults to 50.From 1 to 250.
- Page
pagenumber - Which page to return, counting from 0. Use 'next_page' from an earlier result to read on.At least 0.
Outputs
countnumber- How many are on this page
deviceslist- The devices on this page
has_moretrue/false- True when another page follows
next_pagenumber- The page to ask for next, when has_more is true
pagenumber- This page's number, from 0
totalnumber- How many there are in all
Example output
{
"count": 1,
"devices": [
{
"a64Bit": true,
"antivirus": {
"antivirusProduct": "Microsoft Defender Antivirus",
"antivirusStatus": "RunningAndUpToDate"
},
"cagVersion": "4.4.2215.2215",
"creationDate": "2025-03-04T14:20:00.000Z",
"deleted": false,
"description": "Reception PC",
"deviceClass": "device",
"deviceType": {
"category": "Desktop",
"type": "Desktop"
},
"displayVersion": "4.4.2215",
"domain": "CONTOSO",
"extIpAddress": "203.0.113.10",
"hostname": "CONTOSO-PC-01",
"id": 987654,
"intIpAddress": "10.0.0.25",
"lastAuditDate": "2026-11-12T03:15:00.000Z",
"lastLoggedInUser": "CONTOSO\\jsmith",
"lastReboot": "2026-11-10T07:02:44.000Z",
"lastSeen": "2026-11-12T09:41:05.000Z",
"networkProbe": false,
"onboardedViaNetworkMonitor": false,
"online": true,
"operatingSystem": "Microsoft Windows 11 Pro 10.0.26100",
"patchManagement": {
"patchStatus": "FullyPatched",
"patchesApprovedPending": 0,
"patchesInstalled": 118,
"patchesNotApproved": 2
},
"portalUrl": "https://merlot.centrastage.net/csm/search?qs=uid%3A8d3f6a2b-1c4e-4f5a-9e7b-2a3b4c5d6e7f",
"rebootRequired": false,
"siteId": 1234,
"siteName": "Contoso Ltd",
"siteUid": "4a1b0d3e-5c2f-4e8a-9b7d-1f2e3d4c5b6a",
"snmpEnabled": false,
"softwareStatus": "Compliant",
"suspended": false,
"uid": "8d3f6a2b-1c4e-4f5a-9e7b-2a3b4c5d6e7f",
"warrantyDate": "2028-03-31",
"webRemoteUrl": "https://merlot.centrastage.net/csm/remote/rto/987654"
}
],
"has_more": false,
"next_page": 0,
"page": 0,
"total": 1
}List site variables
List a site's variables, which its components and scripts read.
Inputs
- Site
site_uidtextRequired - The site (a customer or location). Pick one, or give its UID.
- Page size
page_sizenumber - How many to return, 1 to 250. Defaults to 50.From 1 to 250.
- Page
pagenumber - Which page to return, counting from 0. Use 'next_page' from an earlier result to read on.At least 0.
Outputs
countnumber- How many are on this page
has_moretrue/false- True when another page follows
next_pagenumber- The page to ask for next, when has_more is true
pagenumber- This page's number, from 0
site_uidtext- The site's UID
totalnumber- How many there are in all
variableslist- The variables on this page
Example output
{
"count": 1,
"has_more": false,
"next_page": 0,
"page": 0,
"site_uid": "4a1b0d3e-5c2f-4e8a-9b7d-1f2e3d4c5b6a",
"total": 1,
"variables": [
{
"id": 3301,
"masked": false,
"name": "BackupServer",
"value": "CONTOSO-NAS-01"
}
]
}List sites
List the account's sites (each customer or location), with their device counts and linked Autotask company.
Inputs
- Name contains
site_nametext - Only sites whose name contains this.
- Page size
page_sizenumber - How many to return, 1 to 250. Defaults to 50.From 1 to 250.
- Page
pagenumber - Which page to return, counting from 0. Use 'next_page' from an earlier result to read on.At least 0.
Outputs
countnumber- How many are on this page
has_moretrue/false- True when another page follows
next_pagenumber- The page to ask for next, when has_more is true
pagenumber- This page's number, from 0
siteslist- The sites on this page
totalnumber- How many there are in all
Example output
{
"count": 1,
"has_more": false,
"next_page": 0,
"page": 0,
"sites": [
{
"accountUid": "acct-5678",
"autotaskCompanyId": "29683",
"autotaskCompanyName": "Contoso Ltd",
"description": "Head office and branches",
"devicesStatus": {
"numberOfDevices": 42,
"numberOfOfflineDevices": 3,
"numberOfOnlineDevices": 39
},
"id": 1234,
"name": "Contoso Ltd",
"notes": "Main contact: Jo Smith",
"onDemand": false,
"portalUrl": "https://merlot.centrastage.net/csm/site/1234",
"splashtopAutoInstall": true,
"uid": "4a1b0d3e-5c2f-4e8a-9b7d-1f2e3d4c5b6a"
}
],
"total": 1
}Move device to site
Move a device to another site. It then takes that site's policies, monitoring and patching.
Inputs
- Device
device_uidtextRequired - The device. Pick one, or give its UID (or numeric id) from an earlier step.
- Site
site_uidtextRequired - The site to move the device to. Pick one, or give its UID.
Outputs
device_uidtext- The device moved
movedtrue/false- True once Datto RMM accepted it
site_uidtext- The site it was moved to
Example output
{
"device_uid": "8d3f6a2b-1c4e-4f5a-9e7b-2a3b4c5d6e7f",
"moved": true,
"site_uid": "4a1b0d3e-5c2f-4e8a-9b7d-1f2e3d4c5b6a"
}Resolve alert
Mark an alert resolved, as a technician would once the problem is fixed.
Inputs
- Alert UID
alert_uidtextRequired - The alert's UID, from 'List alerts', a trigger or an earlier step.
Outputs
alert_uidtext- The alert resolved
resolvedtrue/false- True once Datto RMM accepted it
Example output
{
"alert_uid": "9e8d7c6b-5a4f-4e3d-8c2b-1a0f9e8d7c6b",
"resolved": true
}Run quick job
Run a component on a device now, as a quick job, with the values you give its variables. Returns the job's UID to check on it with 'Get job results'.
Inputs
- Device
device_uidtextRequired - The device. Pick one, or give its UID (or numeric id) from an earlier step.
- Component
component_uidtextRequired - The component to run. Pick one, or give its UID.
- Variables
variablesobject - A value for each of the component's variables. Leave one empty to use its default.
- Job name
job_nametext - A name to find the job by in Datto RMM. Defaults to Quick job from Lodol.
Outputs
componentslist- The components it runs
device_uidtext- The device it runs on
jobobject- The job started
Example output
{
"components": [
{
"name": "Clear Temp Files",
"uid": "7c6b5a4d-3e2f-4a1b-8c9d-0e1f2a3b4c5d",
"variables": [
{
"name": "DaysOld",
"value": "14"
}
]
}
],
"device_uid": "8d3f6a2b-1c4e-4f5a-9e7b-2a3b4c5d6e7f",
"job": {
"dateCreated": "2026-11-12T10:00:00.000Z",
"id": 55501,
"name": "Quick job from Lodol",
"status": "active",
"uid": "2f3e4d5c-6b7a-4c8d-9e0f-1a2b3c4d5e6f"
}
}Set device user-defined fields
Set or clear a device's user-defined fields (udf1 to udf300). Fields you don't name keep their values.
Inputs
- Device
device_uidtextRequired - The device. Pick one, or give its UID (or numeric id) from an earlier step.
- Fields
valuesobjectRequired - Each field to change, by name (udf1) or number (1), with its new value. Leave a value empty to clear that field.
Outputs
clearedlist- The fields cleared
device_uidtext- The device changed
updatedlist- The fields given a value
Example output
{
"cleared": [],
"device_uid": "8d3f6a2b-1c4e-4f5a-9e7b-2a3b4c5d6e7f",
"updated": [
"udf1",
"udf5"
]
}Set device warranty date
Set the date a device's warranty ends, or clear it.
Inputs
- Device
device_uidtextRequired - The device. Pick one, or give its UID (or numeric id) from an earlier step.
- Warranty ends
warranty_datedate - The day the warranty ends.
- Clear warranty date
cleartrue/false - Remove the device's warranty date instead.
Outputs
device_uidtext- The device changed
warranty_datetext- The warranty end date set (YYYY-MM-DD), empty when cleared
Example output
{
"device_uid": "8d3f6a2b-1c4e-4f5a-9e7b-2a3b4c5d6e7f",
"warranty_date": "2028-03-31"
}Update site
Change a site's name, description, notes or settings. What you leave empty stays as it is.
Inputs
- Site
site_uidtextRequired - The site (a customer or location). Pick one, or give its UID.
- Name
nametext - A new name. Leave empty to keep it as it is.
- Description
descriptiontext - A short description of the site. Leave empty to keep it as it is.
- Notes
notestext - Notes for technicians. Leave empty to keep it as it is.
- On-demand site
on_demandtrue/false - Make it an on-demand site, whose devices are supported only when asked. Leave empty to keep it as it is.
- Install Splashtop automatically
splashtop_auto_installtrue/false - Install Splashtop remote access on the site's devices. Leave empty to keep it as it is.
Outputs
siteobject- The site as it is now
Example output
{
"site": {
"accountUid": "acct-5678",
"autotaskCompanyId": "29683",
"autotaskCompanyName": "Contoso Ltd",
"description": "Head office and branches",
"devicesStatus": {
"numberOfDevices": 42,
"numberOfOfflineDevices": 3,
"numberOfOnlineDevices": 39
},
"id": 1234,
"name": "Contoso Ltd",
"notes": "Main contact: Jo Smith",
"onDemand": false,
"portalUrl": "https://merlot.centrastage.net/csm/site/1234",
"splashtopAutoInstall": true,
"uid": "4a1b0d3e-5c2f-4e8a-9b7d-1f2e3d4c5b6a"
}
}Update site variable
Change a site variable's value, and its name if you give a new one.
Inputs
- Site
site_uidtextRequired - The site (a customer or location). Pick one, or give its UID.
- Variable
variable_idtextRequired - The site variable. Pick one, or give its id from an earlier step.
- Value
valuetextRequired - The variable's new value.
- New name
nametext - A new name. Leave empty to keep it as it is.
Outputs
site_uidtext- The site's UID
variableobject- The variable as it is now
Example output
{
"site_uid": "4a1b0d3e-5c2f-4e8a-9b7d-1f2e3d4c5b6a",
"variable": {
"id": 3301,
"masked": false,
"name": "BackupServer",
"value": "CONTOSO-NAS-01"
}
}