Archiving & Deleting Forms

Soft delete (default)

By default, DELETE /api/v1/forms/{id} soft-deletes the form — it moves it to Trash and can be restored from the dashboard. Existing recipient links and responses are preserved.

curl -X DELETE https://formalingo.com/api/v1/forms/FORM_ID \
  -H "Authorization: Bearer af_live_YOUR_KEY"

Archive first

You can also archive a form without deleting it by updating its status:

curl -X PUT https://formalingo.com/api/v1/forms/FORM_ID \
  -H "Authorization: Bearer af_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "status": "archived" }'

Archived forms are still accessible to existing recipients but closed for new submissions.

Permanent delete

Add ?permanent=true to irreversibly delete the form and all its data:

curl -X DELETE "https://formalingo.com/api/v1/forms/FORM_ID?permanent=true" \
  -H "Authorization: Bearer af_live_YOUR_KEY"

Warning: Permanent deletion cannot be undone. All questions, sections, recipients, and responses are permanently removed.

The delete:forms scope is required for both operations.