Delete Node

Delete a Wings node

DELETE /api/admin/nodes/:id

cURL

curl -X DELETE "https://panel.example.com/api/admin/nodes/node-uuid" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Response

{
  "data": {
    "success": true,
    "message": "Node deleted successfully"
  }
}

Node deletion is typically done through the Wings-specific endpoints. This documentation is provided for reference.

Authentication

This endpoint requires admin authentication and the nodes:write permission.

Path Parameters

id · string · required

Node ID

Restrictions

• Cannot delete a node that has active servers
• All servers must be deleted or transferred to another node first
• Allocations on the node will also be deleted

Response

data · object

Show Success Object

success · boolean

Whether the deletion was successful

message · string

Success message

cURL

curl -X DELETE "https://panel.example.com/api/admin/nodes/node-uuid" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Response

{
  "data": {
    "success": true,
    "message": "Node deleted successfully"
  }
}