Skip to main content

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.

Continue with the detailed guides​

Privacy settings

Analytics is optional. Your analytics choice is shared with formkiq.com and remembered for up to six months. Change it here at any time.

Essential preferences and search

We remember your privacy choice and display preferences. Search runs in your browser using Pagefind files hosted with the docs. It works whether you accept or reject analytics.

Measure page views and installation-link clicks. This does not enable advertising on the docs. Existing marketing choices for the main website are kept unchanged.

Read the docs privacy notice or manage other main-website privacy choices.