Delete (un-deploy) an endpoint
delete_endpointPermanently removes a deployed endpoint so its URL stops resolving and its configuration is deleted. Preview first without confirm; use withArchived to clear every version of the path.
Instructions
Permanently un-deploys an endpoint — its URL stops resolving and its configuration is removed (unlike toggle_endpoint, this cannot be undone by re-enabling it; deploy_endpoint would be needed to publish it again). Requires confirm=true — first call WITHOUT confirm to preview, then again with confirm:true. A MAIN endpoint whose path still has other versions (the archived, disabled copies each commit leaves — list_endpoints includeArchived shows them) is refused unless withArchived:true, which removes the whole path on that domain in one call (domain owner only). That is how a site moves to another domain: delete withArchived, redeploy.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"endpointId": "<endpointId>"
},
"name": "delete_endpoint"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| confirm | No | Must be true to delete. Omit/false returns a preview only. | |
| endpointId | Yes | The endpoint's id — from list_endpoints. | |
| withArchived | No | Also delete every other version of this path on its domain. |