Tactical RMM Agents icon

Tactical RMM Agents

Interact with the Tactical RMM API for Agents

Overview

This node interacts with the Tactical RMM API specifically for managing agents. The "Delete Pending Actions" operation deletes all pending actions queued for a specified agent. This is useful in scenarios where you want to clear any outstanding commands or tasks that have not yet been executed on an agent, for example, if the agent is being decommissioned or if you want to reset its action queue.

Practical examples:

  • Clearing pending maintenance tasks before rebooting an agent.
  • Removing outdated or erroneous commands that were scheduled but should no longer run.
  • Resetting the agent's state by deleting all pending actions after troubleshooting.

Properties

Name Meaning
Agent ID The unique identifier of the agent whose pending actions you want to delete.

Output

The output is a JSON array containing the response from the Tactical RMM API after attempting to delete the pending actions. The exact structure depends on the API response but typically confirms success or failure of the deletion request.

No binary data is output by this operation.

Dependencies

  • Requires an API key credential for authenticating with the Tactical RMM API.
  • The node expects the base URL of the Tactical RMM API to be configured in the credentials.
  • Network access to the Tactical RMM API endpoint is necessary.

Troubleshooting

  • Common issues:

    • Invalid or missing Agent ID will cause the API call to fail.
    • Incorrect or expired API key will result in authentication errors.
    • Network connectivity problems can prevent reaching the API endpoint.
  • Error messages:

    • Authentication errors typically indicate invalid API credentials; verify and update the API key.
    • 404 Not Found errors may mean the specified Agent ID does not exist.
    • 400 Bad Request errors could indicate malformed requests or missing required parameters.

To resolve these, ensure the Agent ID is correct, the API key is valid, and the Tactical RMM server is reachable.

Links and References

  • Tactical RMM official API documentation (refer to their website or API docs for detailed endpoints and responses).

Discussion