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

ActionWhat it does
Create siteCreate a site for a new customer or location, ready for its devices' agents.
Create site variableAdd a variable to a site for its components and scripts to read, optionally with its value hidden.
Delete site variableDelete a variable from a site.
Get alertGet one alert: its priority, diagnostics, device, ticket and whether it is resolved.
Get deviceGet 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 auditGet 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 jobGet a job's name, when it was created and whether it is still active or completed.
Get job resultsGet how a job went on one device (Success, Failure, Running and so on), each component's result and, optionally, what it wrote.
Get siteGet one site's name, description, notes and device counts.
List activity logRead 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 alertsList 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 componentsList the components (scripts and installers) in the account's library, with the values each one takes.
List device patchesList a device's operating system patches: installed, approved and waiting, or not approved, with severity and whether they need a reboot.
List device softwareList the programs installed on a computer, with their versions, from its latest audit.
List devicesFind 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 devicesList the devices in one site, optionally only those matching a device filter.
List site variablesList a site's variables, which its components and scripts read.
List sitesList the account's sites (each customer or location), with their device counts and linked Autotask company.
Move device to siteMove a device to another site.
Resolve alertMark an alert resolved, as a technician would once the problem is fixed.
Run quick jobRun a component on a device now, as a quick job, with the values you give its variables.
Set device user-defined fieldsSet or clear a device's user-defined fields (udf1 to udf300).
Set device warranty dateSet the date a device's warranty ends, or clear it.
Update siteChange a site's name, description, notes or settings.
Update site variableChange 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

NamenametextRequired
The site's name, usually the customer's name.
Descriptiondescriptiontext
A short description of the site.
Notesnotestext
Notes for technicians.
On-demand siteon_demandtrue/false
Make it an on-demand site, whose devices are supported only when asked.
Install Splashtop automaticallysplashtop_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

Sitesite_uidtextRequired
The site (a customer or location). Pick one, or give its UID.
NamenametextRequired
The variable's name, as components refer to it.
ValuevaluetextRequired
The variable's value.
Hide valuemaskedtrue/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

Sitesite_uidtextRequired
The site (a customer or location). Pick one, or give its UID.
Variablevariable_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 UIDalert_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

Devicedevice_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

Devicedevice_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 UIDjob_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 UIDjob_uidtextRequired
The job's UID, from 'Run quick job' or an earlier step.
Devicedevice_uidtextRequired
The device the job ran on. Pick one, or give its UID.
Include outputinclude_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

Sitesite_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

Fromsincedate and time
The start of the window. Defaults to 24 hours ago.
Untiluntildate and time
The end of the window. Defaults to now.
Activity typeentitieslist
Only device activity, user activity, or both when left empty.One or more of: device (Device activity), user (User activity).
Categoriescategorieslist
Only these categories, as the activity log names them, such as job or remote.
Actionslog_actionslist
Only these actions, as the activity log names them, such as deployment.
Sitesite_uidtext
Only activity in this site.
Searchsearchtext
Words to look for, as in the activity log's own search box.
Orderordertext
Newest or oldest first.One of: desc (Newest first), asc (Oldest first). Default: desc.
How manypage_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

Statusstatustext
Open or resolved alerts.One of: open, resolved. Default: open.
Sitesite_uidtext
Only this site's alerts. Leave empty for the whole account.
Devicedevice_uidtext
Only this device's alerts, instead of a site's.
Page sizepage_sizenumber
How many to return, 1 to 250. Defaults to 50.From 1 to 250.
Pagepagenumber
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 sizepage_sizenumber
How many to return, 1 to 250. Defaults to 50.From 1 to 250.
Pagepagenumber
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

Devicedevice_uidtextRequired
The device. Pick one, or give its UID (or numeric id) from an earlier step.
Statusinstall_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 sizepage_sizenumber
How many to return, 1 to 250. Defaults to 50.From 1 to 250.
Pagepagenumber
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

Devicedevice_uidtextRequired
The device. Pick one, or give its UID (or numeric id) from an earlier step.
Page sizepage_sizenumber
How many to return, 1 to 250. Defaults to 50.From 1 to 250.
Pagepagenumber
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 containshostnametext
Only devices whose host name contains this.
Operating system containsoperating_systemtext
Only devices whose operating system contains this, such as Windows 11.
Device type containsdevice_typetext
Only devices whose type contains this, such as Server or Laptop.
Device filterfilter_idtext
Only devices matching this Datto RMM device filter. When chosen, it alone decides which devices come back.
Page sizepage_sizenumber
How many to return, 1 to 250. Defaults to 50.From 1 to 250.
Pagepagenumber
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

Sitesite_uidtextRequired
The site (a customer or location). Pick one, or give its UID.
Device filterfilter_idtext
Only devices matching this Datto RMM device filter, such as all servers. Leave empty for every device.
Page sizepage_sizenumber
How many to return, 1 to 250. Defaults to 50.From 1 to 250.
Pagepagenumber
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

Sitesite_uidtextRequired
The site (a customer or location). Pick one, or give its UID.
Page sizepage_sizenumber
How many to return, 1 to 250. Defaults to 50.From 1 to 250.
Pagepagenumber
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 containssite_nametext
Only sites whose name contains this.
Page sizepage_sizenumber
How many to return, 1 to 250. Defaults to 50.From 1 to 250.
Pagepagenumber
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

Devicedevice_uidtextRequired
The device. Pick one, or give its UID (or numeric id) from an earlier step.
Sitesite_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 UIDalert_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

Devicedevice_uidtextRequired
The device. Pick one, or give its UID (or numeric id) from an earlier step.
Componentcomponent_uidtextRequired
The component to run. Pick one, or give its UID.
Variablesvariablesobject
A value for each of the component's variables. Leave one empty to use its default.
Job namejob_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

Devicedevice_uidtextRequired
The device. Pick one, or give its UID (or numeric id) from an earlier step.
FieldsvaluesobjectRequired
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

Devicedevice_uidtextRequired
The device. Pick one, or give its UID (or numeric id) from an earlier step.
Warranty endswarranty_datedate
The day the warranty ends.
Clear warranty datecleartrue/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

Sitesite_uidtextRequired
The site (a customer or location). Pick one, or give its UID.
Namenametext
A new name. Leave empty to keep it as it is.
Descriptiondescriptiontext
A short description of the site. Leave empty to keep it as it is.
Notesnotestext
Notes for technicians. Leave empty to keep it as it is.
On-demand siteon_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 automaticallysplashtop_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

Sitesite_uidtextRequired
The site (a customer or location). Pick one, or give its UID.
Variablevariable_idtextRequired
The site variable. Pick one, or give its id from an earlier step.
ValuevaluetextRequired
The variable's new value.
New namenametext
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"
  }
}

On this page