# POST /automations/:id/actions/:actionId/execute

**Resource:** [Automations](./automations.md)  
**Scopes:** `automations:write`  
**Write operation:** yes

Execute a single action in isolation, skipping all other actions in the chain. Reuses the full executor pipeline: variable substitution, recipient resolution, business-hours scheduling. Use for testing one action against real config (e.g. voice_outbound_call dialling a number) or retrying a single failing step without re-firing the entire automation. Cost is the same as the underlying action (e.g. voice_agent_minute credits for voice_outbound_call). Requires automations-trigger:trigger scope.

## Parameters

| Name | In | Type | Required | Description |
|------|----|------|----------|-------------|
| `id` | path | uuid | yes | Automation ID |
| `actionId` | path | uuid | yes | Action ID |
| `trigger_data` | body | object | no | Optional trigger context for variable substitution. Provide fields the action references via {{variable}} placeholders -- e.g. { contact: { first_name: "Jane", phone: "+61400000001" } }. |

## Request example

```bash
curl -X POST \
  "https://api.trustpager.com/functions/v1/api/v1/automations/auto-uuid/actions/action-uuid/execute" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "trigger_data": { "contact": { "first_name": "Jane", "phone": "+61400000001" } } }'
```

---
Base URL: `https://api.trustpager.com/functions/v1/api/v1` — Auth: `Authorization: Bearer YOUR_API_KEY`