Actions19
Overview
This node integrates with the Syncro RMM API to retrieve multiple asset records based on specified filters or saved searches. It is useful for IT administrators and managed service providers who want to programmatically query their asset inventory within Syncro RMM, enabling automation of asset management tasks such as reporting, auditing, or synchronization with other systems.
Typical use cases include:
- Fetching all assets or a limited number of assets matching certain criteria.
- Filtering assets by customer, asset type, SNMP status, or free-text search queries.
- Using a saved asset search ID to quickly retrieve predefined asset sets.
Properties
| Name | Meaning |
|---|---|
| Return All | Whether to return all matching assets or limit the number of results returned. |
| Limit | Maximum number of assets to return when "Return All" is false (minimum 1). |
| Asset Search ID | ID of a saved asset search that overrides all other filters if provided. |
| Filters | Collection of optional filters to narrow down the asset search: |
| - Search Query | Free-text search string to match against asset data (e.g., hostname, user). |
| - Customer ID | Numeric ID to filter assets belonging to a specific customer. |
| - Asset Type ID | Numeric ID to filter assets of a particular asset type. |
| - SNMP Enabled | Boolean flag to filter assets based on whether SNMP is enabled or not. |
Output
The node outputs an array of asset objects in the json field of the output data. Each object represents an asset record retrieved from Syncro RMM, containing details such as asset identifiers, types, customer associations, and SNMP status.
If binary data were involved (not indicated here), it would typically represent files or attachments related to assets, but this node focuses on JSON asset data only.
Dependencies
- Requires an active connection to the Syncro RMM API.
- Needs an API key credential configured in n8n with appropriate permissions to read asset data.
- The base URL for API requests is dynamically constructed using the user's Syncro RMM subdomain.
Troubleshooting
- Invalid API Key: If the API key is incorrect or lacks necessary permissions, the node will fail authentication. Ensure the API key is valid and has read access to assets.
- Empty Results: Providing an invalid or non-existent Asset Search ID or overly restrictive filters may result in no assets being returned. Verify filter values and saved search IDs.
- Limit vs Return All: Setting "Return All" to false but not specifying a reasonable limit may cause unexpected truncation of results.
- API Rate Limits: Excessive requests might be throttled by Syncro RMM; consider adding delays or handling retries.
Links and References
- Syncro RMM API Documentation (for detailed API endpoints and parameters)
- n8n documentation on creating custom nodes