Actions53
- Account Actions
- Device Actions
- Site Actions
- Alert Actions
- Job Actions
- Audit Actions
- System Actions
- Filter Actions
Overview
The "Get All Devices" operation under the "Account" resource in this node retrieves a list of devices managed within a Datto RMM account. It supports fetching all devices either by automatic pagination or by specifying page number and maximum results per page. Users can apply various filters to narrow down the device list based on hostname, device type, operating system, site name, or use advanced multi-field filter conditions for more complex queries.
This operation is beneficial for IT administrators and managed service providers who want to automate inventory management, monitor device statuses, or integrate device data into other workflows. For example, it can be used to generate reports of all online devices running a specific OS, or to trigger alerts for devices requiring patches.
Properties
| Name | Meaning |
|---|---|
| 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 (1-based index). |
| Max Results | Maximum number of devices to return per page when not retrieving all results automatically. |
| Filter ID | Apply a specific predefined device filter by its ID; overrides other device filters if set. |
| Hostname Filter | Filter devices by hostname with partial matching supported. When multiple input items are provided, each item's hostname is searched individually. |
| Device Type Filter | Filter devices by device type with partial matching supported. |
| Operating System Filter | Filter devices by operating system with partial matching supported. |
| Site Name Filter | Filter devices by site name with partial matching supported. |
| Use Advanced Filters | Enable advanced filtering to build complex, multi-field filter conditions applied after API results are returned. |
| Filter Conditions | Define multiple filter conditions for advanced filtering. Each condition includes: - Field (e.g., Hostname, Device Type Category, Online Status, UDF fields, Antivirus Status, etc.) - Operator (e.g., equals, contains, greaterThan) - Value (string, numeric, or boolean depending on operator and field) |
| Filter Logic | How to combine multiple filter conditions: "AND" (all must be true) or "OR" (at least one must be true). |
| Fields to Include | Select which device fields to include in the response. Can add or define fields to customize output data. |
Output
The output is a JSON array where each element represents a device object containing the selected fields as specified in the "Fields to Include" property. Typical fields may include hostname, device type, IP addresses, operating system, online status, patch status, antivirus information, user-defined fields, and more.
If binary data were involved (not indicated here), it would typically represent files or attachments related to devices, but this operation focuses on JSON device metadata only.
Dependencies
- Requires an active connection to the Datto RMM API via an API key credential configured in n8n.
- The node uses the base URL and authentication headers from the configured credentials.
- Pagination and filtering rely on the Datto RMM API's support for these features.
- No additional external dependencies beyond the Datto RMM API.
Troubleshooting
Common Issues:
- Incorrect or missing API credentials will cause authentication failures.
- Using an invalid Filter ID may result in no data or errors.
- Overly restrictive filters might return empty results.
- Large datasets without "Retrieve All" enabled may require manual pagination.
Error Messages:
- Authentication errors: Check that the API key credential is valid and has necessary permissions.
- "Resource account is not supported yet": Indicates a misconfiguration or unsupported resource selection.
- API rate limits or timeouts: Consider reducing max results per page or enabling pagination.
Resolutions:
- Verify API credentials and permissions.
- Adjust filters to ensure they match existing device data.
- Enable "Retrieve All" for complete data retrieval or paginate manually.
- Review API usage limits and adjust workflow frequency accordingly.