usage
Disk usage by category (request history, audit log, files, free database pages, other), request counts, the history retention policy and the running or most recent cleanup. Local, and view scope on paired devices.
Responses
Section titled “Responses”GET /v1/storage: usage by category, the retention policy, and the
running or most recent cleanup.
object
Disk space the daemon uses, by category. Categories add up to total_bytes.
object
Database file, write-ahead log, and stored files on disk.
Request rows (with their inline previews) and their indexes.
Audit events.
Stored files (preview blobs) plus their metadata rows.
Free database pages; new requests reuse them before the file grows.
Everything else: devices, tokens, schema, and the write-ahead log.
Stored files on disk.
Unix milliseconds of the oldest resolution still kept.
The database returns freed pages to the filesystem after a history
cleanup (auto_vacuum=incremental, set on databases created by this
version). Otherwise freed pages stay in the file as free_bytes and
are reused.
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).
A background cleanup. The daemon runs one at a time in small batches, so requests and decisions keep working while it runs.
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.