retention_put
Set history.keep_days and/or history.files_keep_days: saved to the daemon’s config file and applied without a restart. A shorter period starts a cleanup at once. Local, and decide scope on paired devices.
Request Body required
Section titled “Request Bodyrequired”PUT /v1/storage/retention: the “keep for” control. Omitted fields keep
their value; 0 keeps forever (files: as long as their request).
object
Responses
Section titled “Responses”object
Retention for resolved requests (decision history). The daemon prunes at start and hourly; 0 disables a cap. Pending requests are never pruned.
object
Delete resolved requests older than this many days (0 = no age cap).
Keep at most this many resolved requests (0 = no count cap).
Best-effort live database/WAL/blob byte cap, excluding free database pages (0 = unlimited).
Remove files belonging only to resolutions older than N days (0 = request lifetime).
The cleanup that applies a shorter period now; null when nothing shrank or another cleanup is running (hourly retention then applies it).
object
What a cleanup removes.
0 = every resolved request.
Newest resolved requests kept; 0 = no count limit.
Items to process, counted at the start: requests (history) or files (files).
Items processed so far.
Bytes freed: removed files plus database pages released by deleted rows.
Returning freed database pages to the filesystem (incremental vacuum).
Unix milliseconds.
Set when state is failed.
Out of range, or the daemon has no config file
Remote device without decide scope