Skip to main content

Run the retention purge now, and reclaim the space it frees

POST 
/api/settings/logs/purge

Start a purge immediately, on the current Log Retention Days rule.

The run has two phases: deleting the records, then compacting the archive so the freed space goes back to the filesystem. On a SQLite archive that has never been compacted, that second phase is a full rebuild and stops the Log Archiver instances for its duration — GET .../purge/preview says so in advance, in compaction_mode and compaction_stops_archiver.

Returns as soon as the purge is under way rather than when it finishes: a first purge on a large archive deletes millions of rows and runs for minutes. Poll GET /api/settings/logs/purge for progress. A purge already running is left alone and reported as-is.

Responses​

Successful Response