Actions53
- Account Actions
- Device Actions
- Site Actions
- Alert Actions
- Job Actions
- Audit Actions
- System Actions
- Filter Actions
Overview
The node interacts with the Datto RMM API to retrieve information about devices associated with a specific site. The "Get Devices" operation under the "Site" resource fetches device data for a selected site, optionally applying filters such as hostname, device type, operating system, or a specific device filter ID. It supports pagination and can automatically retrieve all devices across multiple pages.
This node is beneficial in scenarios where you need to monitor, audit, or manage devices within a particular site remotely. For example, an IT administrator could use it to generate reports on all devices at a site, filter devices by operating system to target updates, or integrate device data into other workflows for automated alerting or inventory management.
Properties
| Name | Meaning |
|---|---|
| Site | Select the site from which to retrieve devices. |
| Retrieve All | Whether to automatically retrieve all devices using pagination (true) or manually specify page and max results (false). |
| Page | The page number to retrieve when not retrieving all results automatically. |
| Max Results | Maximum number of devices to return per page when not retrieving all results automatically. |
| Filter ID | Device filter ID to apply; overrides other filters if specified. |
| Hostname Filter | Filter devices by hostname; partial matches allowed. |
| Device Type Filter | Filter devices by device type; partial matches allowed. |
| Operating System Filter | Filter devices by operating system; partial matches allowed. |
| Fields to Return | Select which fields to include in the response for each device. |
Output
The output contains a JSON array where each item represents a device matching the query parameters. Each device object includes fields as specified by the "Fields to Return" property, such as hostname, device type, operating system, IP address, and other device-specific details.
If binary data were involved (e.g., device images or logs), it would be summarized here, but this operation returns only JSON data describing devices.
Dependencies
- Requires an active connection to the Datto RMM API via an API key credential.
- The node depends on proper configuration of the API base URL and authentication credentials within n8n.
- Pagination support relies on the API's ability to return paged results and the helper methods to handle multiple requests transparently.
Troubleshooting
Common Issues:
- Invalid or missing site selection will cause the node to fail to retrieve devices.
- Incorrect API credentials or network issues may result in authentication errors or timeouts.
- Using incompatible filter values (e.g., non-existent filter IDs) might return empty results or errors.
Error Messages:
- "Resource site is not supported yet." — This indicates an unsupported resource was selected; ensure "site" is chosen.
- API request failures typically return HTTP error codes; verify API credentials and network connectivity.
- Pagination errors may occur if page numbers or max results are set incorrectly; ensure these are positive integers.