Delete Automation

Delete an automation permanently.

Use Cases:

• Remove unused draft automations
• Clean up deprecated automations
• Delete test automations
• Remove automations after migration

Behavior:

• Only DRAFT or ARCHIVED automations can be deleted
• Published automations must be archived first
• Automation is permanently removed from the workspace
• Cannot be undone — automation is permanently deleted
• Returns the deleted automation's ID for confirmation

Required Scope: write:automations

Restrictions:

• Cannot delete PUBLISHED automations (archive first)
• Deletion is permanent and cannot be undone

Important:

• Archive published automations before deleting
• Contacts currently in the automation flow may be affected
• Historical automation data is removed