Skip to main content
PATCH
/
api
/
admin
/
nodes
/
:id
curl -X PATCH "https://panel.example.com/api/admin/nodes/node-uuid" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "name": "US-East-1-Updated",
    "memory": 32768,
    "disk": 512000,
    "maintenanceMode": false
  }'

{
  "data": {
    "id": "node-uuid",
    "name": "US-East-1-Updated",
    "memory": 32768,
    "disk": 512000,
    "maintenanceMode": false
  }
}

​
Authentication

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

​
Path Parameters

​
id
string
required
Node ID

​
Request Body

​
name
string
Node name
​
description
string
Node description
​
fqdn
string
Fully qualified domain name or IP address
​
scheme
string
Connection scheme: http or https
​
public
boolean
Whether the node is publicly accessible
​
maintenanceMode
boolean
Whether the node is in maintenance mode
​
behindProxy
boolean
Whether the node is behind a proxy
​
memory
integer
Total memory in MB
​
memoryOverallocate
integer
Memory overallocation percentage
​
disk
integer
Total disk space in MB
​
diskOverallocate
integer
Disk overallocation percentage
​
uploadSize
integer
Maximum upload size in MB
​
daemonListen
integer
Wings daemon listen port
​
daemonSftp
integer
SFTP port
​
daemonBase
string
Base directory for server files

​
Response

​
data
object
Updated node object with all properties
curl -X PATCH "https://panel.example.com/api/admin/nodes/node-uuid" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "name": "US-East-1-Updated",
    "memory": 32768,
    "disk": 512000,
    "maintenanceMode": false
  }'

{
  "data": {
    "id": "node-uuid",
    "name": "US-East-1-Updated",
    "memory": 32768,
    "disk": 512000,
    "maintenanceMode": false
  }
}

​
Notes

  • Only fields provided in the request body will be updated
  • At least one field must be provided
  • Maximum request body size is 32 KB
  • Changes may require Wings daemon restart to take full effect

Build docs developers (and LLMs) love

Get started for freeTalk to us