Archiving & Deleting Documents

Soft delete (default)

Moves the document to Trash. Original file is removed from storage. Existing signing links stop working.

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

Permanent delete

Permanently deletes the document and all associated data (fields, submissions, audit events):

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

Warning: Permanent deletion cannot be undone.

The delete:documents scope is required for both operations.