# Datto RMM

> 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.

App · 25 actions. Web page: https://docs.lodol.com/docs/integrations/datto-rmm

## Actions

### Create site

Create a site for a new customer or location, ready for its devices' agents.

**Inputs**

- Name (`name`, text, required): The site's name, usually the customer's name.
- Description (`description`, text): A short description of the site.
- Notes (`notes`, text): Notes for technicians.
- On-demand site (`on_demand`, true/false): Make it an on-demand site, whose devices are supported only when asked.
- Install Splashtop automatically (`splashtop_auto_install`, true/false): Install Splashtop remote access on the site's devices.

**Outputs**

- `site` (object): The new site

**Example output**

```json
{
  "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_uid`, text, required): The site (a customer or location). Pick one, or give its UID.
- Name (`name`, text, required): The variable's name, as components refer to it.
- Value (`value`, text, required): The variable's value.
- Hide value (`masked`, true/false): Hide the value in Datto RMM, for a password or key.

**Outputs**

- `site_uid` (text): The site's UID
- `variable` (object): The new variable, with its id

**Example output**

```json
{
  "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_uid`, text, required): The site (a customer or location). Pick one, or give its UID.
- Variable (`variable_id`, text, required): The site variable. Pick one, or give its id from an earlier step.

**Outputs**

- `deleted` (true/false): True once Datto RMM accepted it
- `site_uid` (text): The site's UID
- `variable_id` (number): The variable deleted

**Example output**

```json
{
  "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_uid`, text, required): The alert's UID, from 'List alerts', a trigger or an earlier step.

**Outputs**

- `alert` (object): The alert

**Example output**

```json
{
  "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_uid`, text, required): The device. Pick one, or give its UID (or numeric id) from an earlier step.

**Outputs**

- `device` (object): The device

**Example output**

```json
{
  "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_uid`, text, required): The device. Pick one, or give its UID (or numeric id) from an earlier step.

**Outputs**

- `audit` (object): The audit. A printer's or ESXi host's has the fields Datto RMM keeps for that kind of device.
- `device_class` (text): device, printer or esxihost
- `device_uid` (text): The device's UID
- `hostname` (text): The device's host name

**Example output**

```json
{
  "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_uid`, text, required): The job's UID, from 'Run quick job' or an earlier step.

**Outputs**

- `job` (object): The job

**Example output**

```json
{
  "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_uid`, text, required): The job's UID, from 'Run quick job' or an earlier step.
- Device (`device_uid`, text, required): The device the job ran on. Pick one, or give its UID.
- Include output (`include_output`, true/false): Also return what each component wrote to its output and error streams.

**Outputs**

- `results` (object): The job's results on the device
- `status` (text): The job's status on the device, such as Success or Failure
- `stderr` (list): What each component wrote to its errors
- `stdout` (list): What each component wrote to its output

**Example output**

```json
{
  "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_uid`, text, required): The site (a customer or location). Pick one, or give its UID.

**Outputs**

- `site` (object): The site

**Example output**

```json
{
  "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 (`since`, date and time): The start of the window. Defaults to 24 hours ago.
- Until (`until`, date and time): The end of the window. Defaults to now.
- Activity type (`entities`, list): Only device activity, user activity, or both when left empty. One or more of: `device` (Device activity), `user` (User activity).
- Categories (`categories`, list): Only these categories, as the activity log names them, such as job or remote.
- Actions (`log_actions`, list): Only these actions, as the activity log names them, such as deployment.
- Site (`site_uid`, text): Only activity in this site.
- Search (`search`, text): Words to look for, as in the activity log's own search box.
- Order (`order`, text): Newest or oldest first. One of: `desc` (Newest first), `asc` (Oldest first). Default: `desc`.
- How many (`page_size`, number): How many to return, 1 to 250. Defaults to 50. From 1 to 250.

**Outputs**

- `activities` (list): The activities
- `count` (number): How many came back
- `has_more` (true/false): True when more matched; narrow the window to read them

**Example output**

```json
{
  "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 (`status`, text): Open or resolved alerts. One of: `open`, `resolved`. Default: `open`.
- Site (`site_uid`, text): Only this site's alerts. Leave empty for the whole account.
- Device (`device_uid`, text): Only this device's alerts, instead of a site's.
- Page size (`page_size`, number): How many to return, 1 to 250. Defaults to 50. From 1 to 250.
- Page (`page`, number): Which page to return, counting from 0. Use 'next_page' from an earlier result to read on. At least 0.

**Outputs**

- `alerts` (list): The alerts on this page
- `count` (number): How many are on this page
- `has_more` (true/false): True when another page follows
- `next_page` (number): The page to ask for next, when has_more is true
- `page` (number): This page's number, from 0
- `status` (text): open or resolved
- `total` (number): How many there are in all

**Example output**

```json
{
  "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_size`, number): How many to return, 1 to 250. Defaults to 50. From 1 to 250.
- Page (`page`, number): Which page to return, counting from 0. Use 'next_page' from an earlier result to read on. At least 0.

**Outputs**

- `components` (list): The components on this page
- `count` (number): How many are on this page
- `has_more` (true/false): True when another page follows
- `next_page` (number): The page to ask for next, when has_more is true
- `page` (number): This page's number, from 0
- `total` (number): How many there are in all

**Example output**

```json
{
  "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_uid`, text, required): The device. Pick one, or give its UID (or numeric id) from an earlier step.
- Status (`install_status`, text): 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_size`, number): How many to return, 1 to 250. Defaults to 50. From 1 to 250.
- Page (`page`, number): Which page to return, counting from 0. Use 'next_page' from an earlier result to read on. At least 0.

**Outputs**

- `count` (number): How many are on this page
- `device_uid` (text): The device's UID
- `has_more` (true/false): True when another page follows
- `next_page` (number): The page to ask for next, when has_more is true
- `page` (number): This page's number, from 0
- `patches` (list): The patches on this page
- `total` (number): How many there are in all

**Example output**

```json
{
  "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_uid`, text, required): The device. Pick one, or give its UID (or numeric id) from an earlier step.
- Page size (`page_size`, number): How many to return, 1 to 250. Defaults to 50. From 1 to 250.
- Page (`page`, number): Which page to return, counting from 0. Use 'next_page' from an earlier result to read on. At least 0.

**Outputs**

- `count` (number): How many are on this page
- `device_uid` (text): The device's UID
- `has_more` (true/false): True when another page follows
- `next_page` (number): The page to ask for next, when has_more is true
- `page` (number): This page's number, from 0
- `software` (list): The programs on this page
- `total` (number): How many there are in all

**Example output**

```json
{
  "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 (`hostname`, text): Only devices whose host name contains this.
- Operating system contains (`operating_system`, text): Only devices whose operating system contains this, such as Windows 11.
- Device type contains (`device_type`, text): Only devices whose type contains this, such as Server or Laptop.
- Device filter (`filter_id`, text): Only devices matching this Datto RMM device filter. When chosen, it alone decides which devices come back.
- Page size (`page_size`, number): How many to return, 1 to 250. Defaults to 50. From 1 to 250.
- Page (`page`, number): Which page to return, counting from 0. Use 'next_page' from an earlier result to read on. At least 0.

**Outputs**

- `count` (number): How many are on this page
- `devices` (list): The devices on this page
- `has_more` (true/false): True when another page follows
- `next_page` (number): The page to ask for next, when has_more is true
- `page` (number): This page's number, from 0
- `total` (number): How many there are in all

**Example output**

```json
{
  "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_uid`, text, required): The site (a customer or location). Pick one, or give its UID.
- Device filter (`filter_id`, text): Only devices matching this Datto RMM device filter, such as all servers. Leave empty for every device.
- Page size (`page_size`, number): How many to return, 1 to 250. Defaults to 50. From 1 to 250.
- Page (`page`, number): Which page to return, counting from 0. Use 'next_page' from an earlier result to read on. At least 0.

**Outputs**

- `count` (number): How many are on this page
- `devices` (list): The devices on this page
- `has_more` (true/false): True when another page follows
- `next_page` (number): The page to ask for next, when has_more is true
- `page` (number): This page's number, from 0
- `total` (number): How many there are in all

**Example output**

```json
{
  "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_uid`, text, required): The site (a customer or location). Pick one, or give its UID.
- Page size (`page_size`, number): How many to return, 1 to 250. Defaults to 50. From 1 to 250.
- Page (`page`, number): Which page to return, counting from 0. Use 'next_page' from an earlier result to read on. At least 0.

**Outputs**

- `count` (number): How many are on this page
- `has_more` (true/false): True when another page follows
- `next_page` (number): The page to ask for next, when has_more is true
- `page` (number): This page's number, from 0
- `site_uid` (text): The site's UID
- `total` (number): How many there are in all
- `variables` (list): The variables on this page

**Example output**

```json
{
  "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_name`, text): Only sites whose name contains this.
- Page size (`page_size`, number): How many to return, 1 to 250. Defaults to 50. From 1 to 250.
- Page (`page`, number): Which page to return, counting from 0. Use 'next_page' from an earlier result to read on. At least 0.

**Outputs**

- `count` (number): How many are on this page
- `has_more` (true/false): True when another page follows
- `next_page` (number): The page to ask for next, when has_more is true
- `page` (number): This page's number, from 0
- `sites` (list): The sites on this page
- `total` (number): How many there are in all

**Example output**

```json
{
  "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_uid`, text, required): The device. Pick one, or give its UID (or numeric id) from an earlier step.
- Site (`site_uid`, text, required): The site to move the device to. Pick one, or give its UID.

**Outputs**

- `device_uid` (text): The device moved
- `moved` (true/false): True once Datto RMM accepted it
- `site_uid` (text): The site it was moved to

**Example output**

```json
{
  "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_uid`, text, required): The alert's UID, from 'List alerts', a trigger or an earlier step.

**Outputs**

- `alert_uid` (text): The alert resolved
- `resolved` (true/false): True once Datto RMM accepted it

**Example output**

```json
{
  "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_uid`, text, required): The device. Pick one, or give its UID (or numeric id) from an earlier step.
- Component (`component_uid`, text, required): The component to run. Pick one, or give its UID.
- Variables (`variables`, object): A value for each of the component's variables. Leave one empty to use its default.
- Job name (`job_name`, text): A name to find the job by in Datto RMM. Defaults to Quick job from Lodol.

**Outputs**

- `components` (list): The components it runs
- `device_uid` (text): The device it runs on
- `job` (object): The job started

**Example output**

```json
{
  "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_uid`, text, required): The device. Pick one, or give its UID (or numeric id) from an earlier step.
- Fields (`values`, object, required): Each field to change, by name (udf1) or number (1), with its new value. Leave a value empty to clear that field.

**Outputs**

- `cleared` (list): The fields cleared
- `device_uid` (text): The device changed
- `updated` (list): The fields given a value

**Example output**

```json
{
  "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_uid`, text, required): The device. Pick one, or give its UID (or numeric id) from an earlier step.
- Warranty ends (`warranty_date`, date): The day the warranty ends.
- Clear warranty date (`clear`, true/false): Remove the device's warranty date instead.

**Outputs**

- `device_uid` (text): The device changed
- `warranty_date` (text): The warranty end date set (YYYY-MM-DD), empty when cleared

**Example output**

```json
{
  "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_uid`, text, required): The site (a customer or location). Pick one, or give its UID.
- Name (`name`, text): A new name. Leave empty to keep it as it is.
- Description (`description`, text): A short description of the site. Leave empty to keep it as it is.
- Notes (`notes`, text): Notes for technicians. Leave empty to keep it as it is.
- On-demand site (`on_demand`, true/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_install`, true/false): Install Splashtop remote access on the site's devices. Leave empty to keep it as it is.

**Outputs**

- `site` (object): The site as it is now

**Example output**

```json
{
  "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_uid`, text, required): The site (a customer or location). Pick one, or give its UID.
- Variable (`variable_id`, text, required): The site variable. Pick one, or give its id from an earlier step.
- Value (`value`, text, required): The variable's new value.
- New name (`name`, text): A new name. Leave empty to keep it as it is.

**Outputs**

- `site_uid` (text): The site's UID
- `variable` (object): The variable as it is now

**Example output**

```json
{
  "site_uid": "4a1b0d3e-5c2f-4e8a-9b7d-1f2e3d4c5b6a",
  "variable": {
    "id": 3301,
    "masked": false,
    "name": "BackupServer",
    "value": "CONTOSO-NAS-01"
  }
}
```
