CLI reference
x402-hosting delete: command reference.
delete permanently removes a project — its deployments, its URL, and its record. It costs $0.01, paid in USDC from the owner wallet.
Synopsis
$ npx x402-hosting@latest delete --yes
Run it from the directory holding x402-hosting.json. The command is irreversible, so without --yes it asks for confirmation — type yes at the prompt — and refuses to run at all from a non-interactive shell.
Flags and facts
--yes— skip the interactive confirmation--payer/--payer-cmd— how the $0.01 is signed, as on every paid command- Cost: $0.01 from the project owner wallet
- Deletion is a queued operation; the CLI polls until it settles
- Irreversible — there is no undelete
What gets removed
Deletion takes the URL offline and removes the project and its deployment history on the platform. Any prepaid time that remains is not refunded — prepaid hosting is spent when it is bought, which is why the pricing model stays this simple. The local x402-hosting.json remains on disk; remove it yourself if the directory will be reused for something else.
Deletion versus expiry
Deleting is usually unnecessary. A prepaid project ends on its own: when the paid days run out, the site goes offline, a 30-day grace window passes, and the platform removes the project — for free. Cancelling by not renewing costs nothing and is the right choice when you simply want the site gone at the end of its term. Pay for delete only when the project must come down now, before its prepaid time expires.
Why deletion is paid
On x402-hosting there is no account and no password — the only proof of ownership is the wallet that paid the first upload. Every paid mutation must settle from that wallet, and a payment attempted from any other wallet is rejected before settlement. Requiring the owner wallet to sign the $0.01 deletion is what prevents anyone else from taking your site down; the charge is the authentication.