teardown
Permanently delete a deployment. The URL immediately returns 404 and the slug becomes available for reuse.
bash
npx based-page teardown --id <id>Options
| Flag | Description |
|---|---|
--id <id> | Deployment ID to delete (required) |
--yes | Skip the confirmation prompt |
Example
bash
npx based-page teardown --id dep_abc123You'll see a confirmation prompt:
You are about to permanently delete:
URL: https://my-site.based.page
Title: My Site
ID: dep_abc123
This cannot be undone. Continue? [y/N]Type y to confirm.
Skip confirmation
bash
npx based-page teardown --id dep_abc123 --yesFinding the ID
bash
npx based-page listNotes
- Permanent. There is no undo. The URL goes to 404 immediately.
- Frees up a deployment slot on the free plan.
- If you might want to restore the page later, use
updateto replace it with a "coming soon" message instead.