Skip to main content
Actions do the actual work in a workflow: API calls, transformations, notifications, flow control, and integrations. Use this action when your workflow needs to perform an operation, call an external service, or transform data for downstream nodes.

When To Use

  • Run read-only diagnostics on a failing edge router.
  • Collect immediate interface statistics during incidents.

Configuration Checklist

  1. Set target site and command to execute.
  2. Use conservative command scopes for live systems.
  3. Capture command output and branch on success indicators.
  4. Record outputs needed for auditing or troubleshooting.

Inputs

  • Required node.data metadata: uiId, componentId, and operation (for actions that define an operation).
  • Action-specific configuration fields from the node editor.
  • Upstream context values from triggers or previous nodes (for example trigger.* or prior action outputs).

Outputs

  • Adds action result data to the workflow context for downstream nodes.
  • May produce external side effects (API updates, notifications, scripts, SSH commands, etc.).
  • Can emit structured values consumed by conditions or subsequent actions.

Failure Modes

  • Missing required configuration or invalid parameter values.
  • Missing/invalid context variable references from upstream nodes.
  • External dependency failures (HTTP errors, auth failures, timeouts, rate limits).
  • Payload validation/parsing errors during request or response handling.

Best Practices

  • Prefer read-only commands unless a clear change-control path exists.