Scheduled Purge issues
Why a purge deleted nothing, too little, or more than you expected — and how to recover.
Last updated July 17, 2026
#Purge isn't deleting files
- Nothing old enough yet. Purge only removes files older than the configured age — check modified times against your cutoff (months/years use calendar-aware math, so “1 month” isn't always 30 days).
- Pattern doesn't match. A run reporting “no files” matched nothing. Test with
*to confirm the target has the files you expect, then narrow (mind case, e.g.*.CSVvs*.csv). - Permissions. Remote targets need list and delete rights — re-test the credential.
- Root target rejected. FileAgent refuses to purge a bare drive, share, bucket, or container — point at a folder inside the location.
#Deleted more or fewer files than expected
Open the purge run in Logs first — the detail records what was scanned, deleted, and skipped, the fastest way to see exactly what the rule matched.
- Too many? The pattern was broader than intended (the default
*matches everything) or the age threshold was larger than you meant. - Too few? The pattern was too narrow (wrong extension or case) or the files simply weren't old enough.
- Confirm the target path. Make sure the job points at the folder/prefix you intended, not a parent or sibling.
#Recovering purged files
Purge deletion is permanent. If you configured archive-before-delete or have a separate backup, restore from there — FileAgent cannot undo a purge on its own.
Going forward, validate a purge with a narrow pattern and a manual run before scheduling it, and keep archive or backup behavior in place for anything you might need back. See Scheduled Purge.