Skip to content

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

AnnotationValue
readOnlyHintfalse
destructiveHinttrue
openWorldHinttrue

Parameters

NameTypeRequiredDescription
idstringYesThe deployment ID to delete
confirmbooleanNoSet 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:

  1. Calls teardown with the deployment ID (without confirm).
  2. Shows the user which site will be deleted.
  3. After the user agrees, calls teardown again with confirm: true.
  4. 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).

Deploy apps from conversation.