Delete Form

Delete a form and all its versions permanently.

Use Cases:

• Remove test or deprecated forms
• Clean up unused forms
• Delete forms after migration
• Comply with data retention policies
• Remove accidentally created forms

Behavior:

• Deletes the specified form permanently
• If deleting root form, ALL versions are deleted
• If deleting a version, only that version is deleted
• Form submissions are retained (anonymized)
• Embedded forms will stop working immediately
• Cannot be undone - deletion is permanent

Required Scope: write:forms

Deletion Scope:

• Root Form: Deletes all versions (DRAFT, PUBLISHED, ARCHIVED)
• Specific Version: Deletes only that version

Data Impact:

• Form configuration is permanently deleted
• All versions deleted (if root form)
• Form submissions preserved but form reference removed
• Embedded forms break immediately
• Analytics data for form retained

Important:

• Remove form embeds from your website first
• Export form data if needed before deletion
• Cannot recover deleted forms
• Submissions are retained but disconnected from form
• Consider archiving instead of deleting for audit trails

Warning:

• Embedded forms will immediately stop working
• No confirmation step - deletion is instant
• All versions lost if deleting root form

Note: Form submissions are preserved for analytics but form definition is permanently removed.