Xcellerate.app icon

Xcellerate.app

Consume the Xcellerate.app API

Actions7

Agent → Send Action

AI-generated

Overview

This node sends a specified action command to an agent identified by its UUID. It is useful for remotely controlling or managing agents by issuing commands such as deploying applications, updating packages, or other agent-specific actions. For example, an administrator can use this node to trigger an application deployment or update packages on a remote agent.

Use Case Examples

  1. Sending a restart command to an agent identified by its UUID.
  2. Deploying an application update to a specific agent.
  3. Updating specific packages on an agent using the APPDEPLOYUPD command.

Properties

Name Meaning
Agent UUID The UUID of the agent to fetch data from and send the action to.
Action The specific action command to send to the agent(s). Options are dynamically loaded via the getCommands method.
Properties Additional JSON-formatted properties to include with the action command, except when the command is APPDEPLOYUPD.
Packages A collection of specific packages to update when the action command is APPDEPLOYUPD. If left empty, all packages will be updated.

Output

JSON

  • success - Indicates whether the action was successfully sent to the agent.
  • message - Additional information or response message from the agent after sending the action.

Dependencies

  • Requires an API key credential or authentication token to communicate with the Xcellerate.app API.

Troubleshooting

  • Ensure the Agent UUID is correct and the agent is reachable; otherwise, the action will fail.
  • Verify that the selected action command is supported and correctly spelled.
  • When using the APPDEPLOYUPD command, ensure package details are correctly specified if updating specific packages.
  • Check API authentication credentials if the node fails to connect to the Xcellerate.app API.

Discussion