How do I recover a document deleted by accident?
Restore a soft-deleted document from FormKiQ Trash or the supported API while it remains recoverable. Recovery depends on the deletion operation and configured trash retention; a permanently purged document is different. AWS backups and storage versions can provide additional recovery paths, but they require a tested restore procedure and do not automatically recreate the complete application record.
Identify what happened
Check the document's site, identifier, deletion state, and the operation used. A document hidden by a filter or permission change may still exist. Soft deletion, permanent deletion, and storage lifecycle expiry have different recovery implications.
Review softDeleteRetentionInDays in the v1.19.2 configuration. A value of -1 keeps soft-deleted documents until trash is cleared manually; a positive interval can permit automatic removal. Do not change production retention simply to attempt a recovery.
Restore through the supported path
Use the soft-delete tutorial and the caller's authorized restore operation. Confirm file content, metadata, site membership, and access after restoration. Check indexes and derived processing separately if the restored document is not immediately searchable.
If the item was purged, follow the organization's backup runbook. Coordinate content and metadata restoration and validate references, versions, permissions, and processing state. Test recovery with disposable records before relying on a backup plan for business-critical content.
Edition and configuration
Soft-delete/restore behavior requires the relevant installed backend capabilities and configuration. Confirm edition, retention settings, and the operation used; recovery is not guaranteed after permanent purge or expiry.