Skip to main content
DELETE
/
form
/
{form_id}
Delete Form
curl --request DELETE \
  --url https://management.scanova.io/form/{form_id}/ \
  --header 'Authorization: <api-key>'
{
  "detail": "Invalid token."
}

Documentation Index

Fetch the complete documentation index at: https://docs.scanova.io/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Permanently deletes a form and all associated data. This action cannot be undone.

​
Path Parameters

ParameterTypeRequiredDescriptionExample
form_idstringYesForm ID (form_id)Fecb6be7be43b4724

​
Response

Returns a 204 No Content status on successful deletion.

​
Examples

​
Delete Form

curl -X DELETE "https://management.scanova.io/form/Fecb6be7be43b4724/" \
  -H "Authorization: YOUR_API_KEY"

​
Important Considerations

​
Before Deleting

  • Check Linked QR Codes: Ensure no active QR codes are using this form
  • Backup Data: Export any important submission data before deletion
  • Notify Team: Inform team members about the deletion
  • Consider Deactivation: Use the update endpoint to deactivate instead of delete

​
What Gets Deleted

  • Form configuration
  • All collected form submissions
  • Form settings and styling

​
What Remains

  • QR codes that were linked to this form (they will have no form attached)
  • Historical analytics data (if any)

​
Use Cases

  • Cleanup: Remove unused or test forms
  • Data Privacy: Delete forms containing sensitive information
  • Account Management: Clean up old forms to stay within limits
  • Compliance: Remove forms for GDPR or other compliance requirements
Permanent Action: Deleting a form is irreversible. All submission data and configurations will be permanently lost. Consider deactivating the form instead if you might need it later.
If you need to preserve the submission data, consider exporting it first or simply deactivating the form using the update endpoint.

Authorizations

​
Authorization
string
header
required

API key authentication. Enter your API key directly in the Authorization header.

Path Parameters

​
form_id
string
required

Form ID (form_id)

Response

Form deleted successfully