teardown
Delete a deployment permanently. The URL will stop serving and return a 404.
This tool uses a two-step confirmation flow to prevent accidental deletion.
Annotations
| Annotation | Value |
|---|---|
readOnlyHint | false |
destructiveHint | true |
openWorldHint | true |
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Yes | The deployment ID to delete |
confirm | boolean | No | Set to true to confirm deletion. If omitted or false, returns a preview of what will be deleted without taking action. |
Confirmation Flow
Calling teardown without confirm: true returns a preview:
You are about to permanently delete this deployment:
ID: dep_abc123
URL: https://my-site.based.page
Title: My Landing Page
This will permanently delete the live site at https://my-site.based.page.
This action cannot be undone. To proceed, call this tool again with confirm: true.Only after calling teardown again with confirm: true is the deployment deleted.
Return Format
After confirmation:
Deployment deleted.
ID: dep_abc123
Deployment deleted successfully.Example
User prompt:
"Take down my old landing page, I don't need it anymore"
What Claude does:
- Calls
teardownwith the deployment ID (withoutconfirm). - Shows the user which site will be deleted.
- After the user agrees, calls
teardownagain withconfirm: true. - Confirms the deployment has been deleted.
Notes
- This action is permanent. The live URL immediately returns 404. The slug becomes available for reuse.
- The deployment record is soft-deleted (kept for analytics), but the site is taken offline immediately.
- Abuse reports, if any, are retained for trust and safety purposes.
- Deleting a deployment frees up a slot on the free plan (which allows up to 5 active deployments).