> ## Documentation Index
> Fetch the complete documentation index at: https://altostrat.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# MikroTik API

> Run a real-time API command on a specific site.

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.