Delete VPS

Delete a VPS at the provider and remove it from the database. This is a destructive operation that requires explicit confirmation.

Required scope: vps:provision

Path Parameters

Parameter	Type	Description
`id`	string	The VPS ID

Headers

Header	Required	Value
`Authorization`	Yes	`Bearer YOUR_API_KEY`
`Content-Type`	Yes	`application/json`

Request Body

Parameter	Required	Description
`confirm`	Yes	Must be `true` to confirm the destructive operation

Response

{
  "data": {
    "id": "507f1f77bcf86cd799439011",
    "name": "Production Server",
    "deleted": true
  }
}

Response Fields

Field	Type	Description
`id`	string	The VPS ID
`name`	string	The VPS display name
`deleted`	boolean	Always `true` after successful deletion

Error Responses

Status	Code	Description
400	`CONFIRMATION_REQUIRED`	The `confirm` field must be `true`
403	`INSUFFICIENT_SCOPE`	API key lacks `vps:provision` scope
404	`NOT_FOUND`	VPS not found or you do not have owner access
502	`PROVIDER_ERROR`	Failed to delete VPS at provider

Example

curl -X DELETE https://hosting.site.quest/api/v1/vps/507f1f77bcf86cd799439011 \
  -H "Authorization: Bearer sq_live_a94ecfca096d..." \
  -H "Content-Type: application/json" \
  -d '{"confirm": true}'

MCP

This action is also available via the delete_vm MCP tool.