Legal holds

A legal hold keeps backups beyond their expiry until an operator lifts it. It covers one backup, every backup of a plan, or every backup in a project. While a hold is active, expiry skips what it covers. Deleting a held backup, or a plan together with its backups, is refused.

📄️ List legal holds

Operator only: needs a system-scoped token.

📄️ Place a legal hold

Keeps one backup, or every backup of a plan or a project, past its expiry date, and stops it being deleted until the hold is lifted. `scope` is `point`, `plan` or `project`, and `target_id` names what is held. `reason` is required.

📄️ Lift a legal hold

The backups it held go back to their own expiry dates.