Tactical RMM icon

Tactical RMM

Get data from the TacticalRMM API

Overview

This node integrates with the Tactical RMM API to perform various operations on different resources such as agents, alerts, clients, and software. Specifically, for the Agent - Add Note operation, it allows users to add a textual note to a specified agent within the Tactical RMM system. This is useful for maintaining logs, comments, or additional information related to an agent directly from an automated workflow.

Practical examples include:

  • Automatically adding notes to an agent after running maintenance scripts.
  • Logging incident details or troubleshooting steps taken on an agent.
  • Adding reminders or status updates for team members managing the agent.

Properties

Name Meaning
Agent ID The unique identifier of the agent to which the note will be added.
Note The content of the note that you want to add to the specified agent.

Output

The node outputs JSON data representing the result of the "Add Note" operation. This typically includes confirmation of the note being added, possibly with metadata such as the note ID, timestamp, and the agent ID it was attached to.

If the node supports binary data output (not indicated here), it would represent any file or media associated with the note, but in this case, the output is purely JSON-based.

Dependencies

  • Requires an active connection to the Tactical RMM API.
  • Needs an API authentication token configured in n8n credentials to authorize requests.
  • The node depends on the Tactical RMM API endpoint that handles agent notes.

Troubleshooting

  • Common issues:

    • Invalid or missing Agent ID: Ensure the Agent ID provided exists and is correctly formatted.
    • Authentication errors: Verify that the API key or token credential is valid and has sufficient permissions.
    • Network or API downtime: Check connectivity and Tactical RMM service status.
  • Error messages:

    • "Agent not found": The specified Agent ID does not exist; double-check the ID.
    • "Unauthorized" or "Authentication failed": The API credentials are incorrect or expired; update them.
    • "Note content required": The note field is empty; provide valid text to add.

Resolving these usually involves verifying input parameters, refreshing credentials, and ensuring the Tactical RMM API is accessible.

Links and References

Discussion