Update node

PUT/api/admin/nodes/{id}

Authorization

default

AuthorizationBearer <token>

Application API requests require an application API token, or a client API token, that belongs to a root administrator. Admin API requests require a client API token that belongs to a root administrator, and reject application API tokens. Client API requests require a client API token.

In: header

Path Parameters

id*integer

The resource ID.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

public?boolean

The public.

name*string

The display name. Must match the regex /^([\w .-]{1,100})$/.

description?|

A description for this resource.

location_id*integer

The location ID. Must match an existing stored value.

fqdn*string

The fully qualified domain name.

scheme*string

The scheme.

behind_proxy?boolean

Whether the node is behind a proxy.

maintenance_mode?boolean

The maintenance mode.

memory*number

The memory limit in megabytes. Must be at least 1.

memory_overallocate*number

The memory overallocate. Must be at least -1.

disk*number

The disk limit in megabytes. Must be at least 1.

disk_overallocate*number

The disk overallocate. Must be at least -1.

upload_size?integer

The upload size. Must be at least 1.

daemon_listen*number

The daemon listen. Must be between 1 and 65535.

daemon_sftp*number

The daemon sftp. Must be between 1 and 65535.

daemon_base?string

The daemon base. Must match the regex /^([/][\d\w.-/]+)$/.

reset_secret?boolean

Whether to rotate the daemon secret.

Response Body

`application/json`

curl -X PUT "https://example.com/api/admin/nodes/1" \  -H "Content-Type: application/json" \  -d '{    "name": "Example Resource",    "location_id": 1,    "fqdn": "node.example.com",    "scheme": "example",    "memory": 1.5,    "memory_overallocate": 1.5,    "disk": 1.5,    "disk_overallocate": 1.5,    "daemon_listen": 1.5,    "daemon_sftp": 1.5  }'

{  "object": "node",  "attributes": {    "id": 13380,    "uuid": "0c8baf15-4a20-49b5-b738-109796b553e1",    "public": true,    "name": "FactoryNode_K98YXFAsPq",    "description": "string",    "location_id": 16046,    "fqdn": "74.174.140.253",    "scheme": "http",    "behind_proxy": false,    "maintenance_mode": false,    "memory": 1024,    "memory_overallocate": 0,    "disk": 10240,    "disk_overallocate": 0,    "upload_size": 100,    "daemon_listen": 8080,    "daemon_sftp": 2022,    "daemon_base": "/var/lib/pterodactyl/volumes",    "created_at": "2026-09-22T14:45:25+00:00",    "updated_at": "2026-09-22T14:45:25+00:00",    "servers_count": 0,    "allocated_resources": {      "memory": 0,      "disk": 0    },    "relationships": {      "location": {        "object": "location",        "attributes": {          "id": 16053,          "short": "yXYh3ig7",          "long": "DtTf5dbTXXUq1fV3VBHWMKFch7pKkxN4",          "nodes_count": 0,          "servers_count": 0,          "created_at": "2026-09-22T14:45:26+00:00",          "updated_at": "2026-09-22T14:45:26+00:00",          "relationships": {            "nodes": {              "object": "list",              "data": [                {}              ]            }          }        },        "meta": {          "resource": "https://panel.example.com/api/admin/locations/1"        }      }    }  },  "meta": {    "resource": "https://panel.example.com/api/admin/nodes/1"  }}

Authorization

Path Parameters

Request Body

Response Body

200application/json

401application/json

403application/json

404application/json

422application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`