> ## 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.

# API Trigger (Synchronous)

> Trigger this workflow via API call with synchronous execution.

Triggers start workflow execution. A valid workflow should have exactly one trigger node. This trigger is the entry point for a workflow run and should be connected to the first downstream action or condition.

## When To Use

* Trigger validation and return immediate pass/fail results.
* Provide an internal API endpoint that wraps multi-step automation.

## Configuration Checklist

1. Use this trigger to expose a synchronous HTTP entry point.
2. Map incoming request data to downstream action inputs.
3. Set a response node or termination path for clear API outcomes.
4. Test from an API client using realistic payloads and timeouts.

## Inputs

* Node metadata in `node.data`: `uiId` and `componentId`.
* Trigger-specific configuration from the node form (for example schedule or API trigger settings).
* No upstream node input is required because this is the workflow entrypoint.

## Outputs

* Produces the initial workflow context (the `trigger` payload) for downstream nodes.
* Exposes trigger/event data that subsequent actions and conditions can reference.
* Starts execution flow for connected nodes.

## Failure Modes

* Missing or invalid trigger configuration fields.
* Workflow disabled/inactive, so the trigger does not execute.
* Event payload missing fields expected by downstream nodes.
* Permission/integration issues that prevent trigger invocation.

## Best Practices

* Place this as the first node and connect it to the first action or condition.
* Keep synchronous flows short to avoid client timeout issues.