delete_form

Delete a form and all its destinations.

Parameters

Name Type Required Validation Description
formId string Yes -- Form ID (UUID)

Response Example

Form a1b2c3d4-... deleted.

Error Cases

Error Cause
Form not found. Invalid form ID or form belongs to a different organization
401 Unauthorized Invalid or expired secret key

Example Prompt

"Delete the feedback form, I don't need it anymore."

WARNING

Deletion is permanent and immediate. All destinations attached to the form are deleted. The form's public key stops accepting submissions. There is no undo.

TIP

CLI equivalent: npx formdata-dev forms delete <formId> (prompts for confirmation before deleting).