MCP tool · Domains

delete_subdomain

Delete a subdomain.

delete_subdomain

D Destructive

DestructiveIdempotent

Description

Delete a subdomain. This can take down a live entry point and, with delete_contents, remove its document root, so it does not delete on this call: it confirms the subdomain exists, then returns {status:"confirmation_required", confirmationUrl, …}. Show the human the confirmationUrl to approve in the client area; do not approve it yourself. Then poll get_pending_action.

Input

Name	Type	Description
`input` required	string	A domain, email address, website URL, numeric service id, or hosting-account username the customer actually owns. Resolved to the owning account automatically; the resolved `target` is echoed back in the response.
`label` required	string	The subdomain label to delete — one DNS label like `blog`, not a full hostname.
`delete_contents`	boolean	Whether to also delete the subdomain's document root and its files. Defaults to false (files kept).
`attempt_key`	string	An idempotency key you choose. Reusing it within an hour returns the same held deletion.

inputSchema

{3 keys}

:{4 keys},

:{2 keys},

:"A domain, email address, website URL, numeric service id, or hosting-account username the customer actually owns. Resolved to the owning account automatically; the resolved `target` is echoed back in the response.",

:"string"

:{2 keys},

:"The subdomain label to delete — one DNS label like `blog`, not a full hostname.",

:"string"

:{2 keys},

:"Whether to also delete the subdomain's document root and its files. Defaults to false (files kept).",

:"boolean"

:{2 keys}

:"An idempotency key you choose. Reusing it within an hour returns the same held deletion.",

:"string"

}

:"object",

:[2 items]

"input",

"label"

]

}

Click a key to copy its jq path.

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "delete_subdomain",
    "arguments": {
      "input": "example.se",
      "label": "example.se"
    }
  }
}

A representative call with its required arguments filled.