Pterodactyl API v1
Nodes

Create node

Creates a new node

POST/api/application/nodes

Authorization

ApplicationToken
AuthorizationBearer <token>

Application API key (generated at /admin/api)

In: header

Request Body

application/json

name*string
location_id*integer
fqdn*string
scheme*string
memory*integer
memory_overallocate*integer
disk*integer
disk_overallocate*integer
upload_size?integer
daemon_sftp*integer
daemon_listen*integer
description?|
public?boolean
behind_proxy?boolean
maintenance_mode?boolean
daemon_base?string

Directory where server files are stored; defaults to /var/lib/pterodactyl/volumes

Response Body

application/json

curl -X POST "https://pterodactyl.file.properties/api/application/nodes" \  -H "Authorization: Bearer ptla_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \  -H "Accept: application/json" \  -H "Content-Type: application/json" \  -d '{  "name": "New Node",  "location_id": 1,  "fqdn": "node2.example.com",  "scheme": "https",  "memory": 10240,  "memory_overallocate": 0,  "disk": 50000,  "disk_overallocate": 0,  "upload_size": 100,  "daemon_sftp": 2022,  "daemon_listen": 8080}'
{
  "object": "node",
  "attributes": {
    "id": 4,
    "uuid": "4158cfe9-2aa8-4812-bf6e-d88beeb08e98",
    "public": true,
    "name": "New Node",
    "description": null,
    "location_id": 1,
    "fqdn": "node2.example.com",
    "scheme": "https",
    "behind_proxy": false,
    "maintenance_mode": false,
    "memory": 10240,
    "memory_overallocate": 0,
    "disk": 50000,
    "disk_overallocate": 0,
    "upload_size": 100,
    "daemon_listen": 8080,
    "daemon_sftp": 2022,
    "daemon_base": "/var/lib/pterodactyl/volumes",
    "created_at": "2020-10-29T01:17:38+00:00",
    "updated_at": "2020-10-29T01:17:38+00:00",
    "allocated_resources": {
      "memory": 0,
      "disk": 0
    }
  },
  "meta": {
    "resource": "https://pterodactyl.file.properties/api/application/nodes/4"
  }
}