Actions22
- Agent Actions
- Alert Actions
- Client Actions
- Software Actions
Overview
This node interacts with the Tactical RMM API to perform operations related to various resources, including agents. Specifically, the "Shutdown" operation for the "Agent" resource allows you to remotely shut down a specified agent machine managed by Tactical RMM. This is useful in scenarios where you need to power off a device for maintenance, security, or energy-saving purposes.
Practical examples:
- Remotely shutting down a workstation after hours.
- Powering off an agent machine before performing hardware upgrades.
- Automating shutdowns as part of incident response workflows.
Properties
| Name | Meaning |
|---|---|
| Agent ID | The unique identifier of the agent machine to shut down. This is required to specify which agent should be powered off. |
Output
The node outputs JSON data representing the result of the shutdown request sent to the Tactical RMM API. This typically includes confirmation of the action or any error messages returned by the API. The exact structure depends on the API response but generally confirms whether the shutdown command was successfully issued.
No binary data output is involved in this operation.
Dependencies
- Requires an active connection to the Tactical RMM API.
- Needs an API authentication token or key configured in n8n credentials to authorize requests.
- The node relies on the Tactical RMM service being accessible and the agent ID being valid within that system.
Troubleshooting
- Invalid Agent ID: If the provided agent ID does not exist or is incorrect, the API will likely return an error indicating the agent was not found. Verify the agent ID before running the node.
- Authentication Errors: Missing or invalid API credentials will cause authorization failures. Ensure the API key/token is correctly set up in n8n.
- Network Issues: Connectivity problems between n8n and the Tactical RMM API can cause timeouts or failed requests. Check network access and API endpoint availability.
- Agent Offline: If the agent is offline or unreachable, the shutdown command may fail or have no effect. Confirm the agent's status before attempting shutdown.
Links and References
- Tactical RMM Official Documentation
- Tactical RMM API Reference (for details on agent shutdown endpoints)