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

# Run automation (manual API)

> Dispara uma execução produtiva de automação no gu1 via API; apenas para fluxos com trigger manual_execution, com suporte completo a standby.

## Endpoint

```
POST https://api.gu1.ai/automations/:id/run
Content-Type: application/json
```

**Only** automations with **`triggerType: "manual_execution"`** are allowed. Uses **`runAutomationById`** — creates an execution row when the workflow has **wait** steps, and may return **`waiting: true`**.

## Body

<ParamField body="entityId" type="string">
  Optional UUID — loads entity into `event.data`
</ParamField>

<ParamField body="transactionId" type="string">
  Optional UUID — sets transaction context (`entityType: transaction`)
</ParamField>

<ParamField body="data" type="object">
  Merged into `event.data` (custom fields, `phone`, `email` for notifications, etc.)
</ParamField>

## Response

**200 (completed)** — `{ "success": true, "message": "Automation run completed.", "automationId": "..." }`

**200 (standby)** — includes `waiting: true`, `executionId`, `callbackToken`, `pausedAtStep`, `totalSteps`, `pausedAtNodeId`, `nextNodeId` as applicable

**403** — trigger is not `manual_execution`

**404** — not found or archived