Elements API: new "restart" remote operations
We have added two new remote operations to the Elements API device operations endpoint that enable programmatic system and agent restarts.
Operations Overview
The new operations "restartSystem" and "restartProduct" are available via the POST /devices/v1/operations endpoint.
New Operations
restartProduct
Restarts the WithSecure agent software on a device without restarting the entire system.
restartSystem
Restarts the entire device (full system reboot).
Batch Capability
Both operations support batch execution on up to 5 devices per request.
Benefits
- Agent Troubleshooting: Restart the WithSecure agent without disrupting the user's work by avoiding a full system reboot.
- Maintenance Automation: Integrate system restarts into automated maintenance workflows following software updates or configuration changes.
- User Communication: Provide advance notice to users with custom messages before system restarts, improving user experience.
- Efficient Remediation: Quickly restart multiple devices as part of incident response or troubleshooting procedures.
- Granular Control: Choose between agent-only or full system restarts based on the specific troubleshooting or maintenance requirement.
- Operation Tracking: Track restart operations using returned operation IDs to verify execution on remote hosts.
Read more from the Elements API specification under "Trigger remote operations on devices".