Permanently deletes an automation. Pauses any scheduled sends first, then removes the automation.
Behavior:
- DESTRUCTIVE and irreversible — the automation cannot be recovered. No undo.
- Errors when the perspective or automation is not found, or you do not have access. Deleting an already-deleted automation errors as well.
- If pausing the scheduled sender fails, the deletion is aborted and you'll get success: false with "Failed to stop running workflow. Please try again." — the automation stays intact in that case.
When to use this tool:
- The user explicitly asked to remove an automation and confirmed.
- Cleaning up a misconfigured automation that automation_test repeatedly fails on.
When NOT to use this tool:
- The user just wants to pause it temporarily — use automation_update with { enabled: false } instead.
- You're not sure which automation_id is correct — confirm via automation_list first.
Connector