Skip to main content
A delete is permanent. You cannot resume, fork or get back a deleted sandbox. There is no list of deleted sandboxes.
If you want to use the data later, stop the sandbox. Do not delete it. A stopped sandbox costs nothing and keeps its disk for at least 14 days. Save a saved snapshot before day 14 to keep it longer. Read Stop a sandbox.

Delete a sandbox

A delete of a running sandbox stops it at once. It takes no last snapshot. Billing for the sandbox ends at the delete. Every sandbox or snapshot delete needs the header X-Ascii-Confirm-Delete. Its value must be exactly the target id. If it is not, boat refuses the request with 409 and deletes nothing. The header keeps its old name. The CLI and the dashboard set it for you.
$BOAT_API_BASE is https://boat.dev/api/v1. In the dashboard, open Sandboxes. Open the ⋯ menu on the row of the sandbox and choose Delete permanently….

How a delete works

  1. You send a delete request.
  2. boat returns 202 Accepted with an operation.
  3. The sandbox or snapshot disappears from lists, resumes and forks at once.
  4. boat erases the stored data in the background, when nothing reads it any more.
  5. You poll the operation until its status is completed.
boat never refuses a delete because the data is still in use. The stage of the operation tells you where the deletion is.
You cannot cancel a deletion operation.

Poll the operation

A delete returns an operation id (bdop_…). Poll it until status is completed.
boat delete already polls for you. It prints the operation when it finishes. Use boat deletion status to check later on an operation that you started elsewhere.

Delete one snapshot

You can also delete snapshots on the Snapshots tab of the dashboard. Deletion and retention responses use Cache-Control: no-store.

What a delete keeps

Sandboxes can share snapshot data. A fork, a resume and a deploy from a saved snapshot read the same data as their source. So a delete erases only the data that nothing else uses. boat keeps:
  • The data that a fork of this sandbox still needs.
  • Your saved snapshots from this sandbox. They exist to outlive it. To remove one, run boat snapshot rm <name>.
boat frees the storage when no sandbox and no saved snapshot uses it. When you remove a saved snapshot, it becomes unavailable at once. boat erases its data six hours later at the earliest. Upload links for snapshots stay valid for six hours. This delay stops an upload that already started from making the data again after the delete. If you enable zero data retention, boat removes your saved snapshots and queues their data for deletion. You cannot save a saved snapshot while ZDR is on.