Actions30
- Billing Actions
- Circuit Actions
- Contact Actions
- Device Actions
- End Customer Actions
- ISP Actions
- Product Actions
- Site Actions
- TOC Actions
- VLAN Actions
Device → Update
AI-generatedOverview
The "Device Update" operation in the STEM Connect node allows users to update details of a network device identified by its serial number. This operation is useful for managing and maintaining accurate device information within telecommunications infrastructure, such as updating MAC addresses or status flags like configured, available, billed, and notified.
Typical use cases include:
- Updating device metadata after hardware changes.
- Reflecting changes in device availability or billing status.
- Synchronizing device information with external systems.
For example, if a device's MAC address changes or it becomes available for use, this operation can update those fields accordingly.
Properties
| Name | Meaning |
|---|---|
| Subsystem | Selects which subsystem API endpoints to use: Main, Portal, or API. |
| Serial Number | The unique serial number identifying the device to update. |
| MAC Address | The MAC address of the device (optional). |
| Configured | Boolean flag indicating whether the device is configured. |
| Available | Boolean flag indicating whether the device is currently available. |
| Billed | Boolean flag indicating whether the device has been billed. |
| Notified | Boolean flag indicating whether notifications related to the device have been sent. |
Output
The output is an array of JSON objects representing the updated device data returned from the STEM Connect API. Each object contains the device properties as stored or updated on the server.
If multiple devices are processed, each device's data appears as a separate JSON item in the output array.
No binary data is produced by this operation.
Dependencies
- Requires an API key credential for authenticating with the STEM Connect API.
- The node must be configured with the appropriate subsystem selection to target the correct API endpoints.
- Network connectivity to the STEM Connect service is required.
Troubleshooting
- Error: Device not found — Ensure the serial number provided matches an existing device in the system.
- Authentication errors — Verify that the API key credential is valid and has sufficient permissions.
- Invalid input data — Check that boolean flags and MAC address formats conform to expected values.
- API endpoint issues — Confirm the selected subsystem corresponds to the correct API environment.
To resolve errors, verify input parameters, credentials, and network access. Enable "Continue On Fail" in n8n to handle individual record errors gracefully.
Links and References
- STEM Connect API Documentation (replace with actual URL)
- n8n documentation on Creating Custom Nodes
- General best practices for API Authentication