Actions19
Overview
This node integrates with the Syncro RMM API to perform various operations on different resources such as assets, alerts, contacts, customers, and tickets. Specifically, for the Asset - Update operation, it updates an existing asset's details in the Syncro RMM system.
Typical use cases include:
- Updating asset information when hardware or software changes occur.
- Modifying asset ownership or classification.
- Adding or changing custom fields related to an asset for better tracking or reporting.
For example, you might update an asset’s serial number after a replacement or assign it to a different customer.
Properties
| Name | Meaning |
|---|---|
| Asset ID | The unique identifier of the asset to update. This is required to specify which asset will be modified. |
| Additional Fields | Optional fields to update on the asset: • Customer ID (number) • Asset Type Name or ID (select from list or expression) • Asset Name (string) • Serial Number (string) |
| Custom Fields | Set values for one or more custom fields associated with the asset type. Each custom field requires: • Field Name or ID (select from list depending on asset type) • Value (string) to assign |
Output
The node outputs JSON data representing the updated asset object returned by the Syncro RMM API. This typically includes all asset properties after the update, reflecting any changes made.
If the node supports binary data output, it would relate to any file attachments or media linked to the asset, but this is not indicated in the provided code or properties.
Dependencies
- Requires an active connection to the Syncro RMM API.
- Needs an API key credential configured in n8n with appropriate permissions to update assets.
- The base URL for API requests is dynamically constructed using the user’s Syncro subdomain.
- Uses internal methods to load options for asset types and custom fields dynamically.
Troubleshooting
- Invalid API Key Error: If the API key is incorrect or expired, the node will fail authentication. Ensure the API key credential is valid and has necessary permissions.
- Asset Not Found: Providing an invalid or non-existent Asset ID will cause the update to fail. Verify the Asset ID before running the node.
- Invalid Custom Field Values: Custom fields must correspond to the selected asset type. Mismatched or missing custom field IDs can cause errors.
- Network Issues: Connectivity problems to the Syncro RMM API endpoint will prevent execution. Check network access and firewall settings.
Links and References
- Syncro RMM API Documentation (for detailed API endpoints and data models)
- n8n Expressions Documentation (for using expressions in property fields)