Update build

Updates the server build information

PATCH/api/application/servers/{id}/build

Authorization

ApplicationToken

AuthorizationBearer <token>

Application API key (generated at /admin/api)

In: header

Path Parameters

id*integer

Server ID (internal numeric ID)

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

allocation*integer

ID of primary allocation

memory*integer

The maximum amount of memory allowed for this container. Setting this to 0 will allow unlimited memory in a container.

swap*integer

Setting this to 0 will disable swap space on this server. Setting to -1 will allow unlimited swap.

io*integer

IO performance of this server relative to other running containers

cpu*integer

Each physical core on the system is considered to be 100%. Setting this value to 0 will allow a server to use CPU time without restrictions.

disk*integer

This server will not be allowed to boot if it is using more than this amount of space. If a server goes over this limit while running it will be safely stopped and locked until enough space is available. Set to 0 to allow unlimited disk usage.

feature_limits.databases?integer

The total number of databases a user is allowed to create for this server.

feature_limits.backups?integer

The total number of allocations a user is allowed to create for this server.

Response Body

`application/json`

curl -X PATCH "https://example.com/api/application/servers/5/build" \  -H "Content-Type: application/json" \  -d '{    "allocation": 1,    "memory": 512,    "swap": 0,    "disk": 200,    "io": 500,    "cpu": 0,    "threads": null,    "feature_limits": {      "databases": 5,      "allocations": 5,      "backups": 2    }  }'

{  "object": "server",  "attributes": {    "id": 5,    "external_id": "RemoteID1",    "uuid": "1a7ce997-259b-452e-8b4e-cecc464142ca",    "identifier": "1a7ce997",    "name": "Gaming",    "description": "Matt from Wii Sports",    "suspended": false,    "limits": {      "memory": 512,      "swap": 0,      "disk": 200,      "io": 500,      "cpu": 0,      "threads": null    },    "feature_limits": {      "databases": 5,      "allocations": 5,      "backups": 2    },    "user": 1,    "node": 1,    "allocation": 1,    "nest": 1,    "egg": 5,    "container": {      "startup_command": "java -Xms128M -Xmx2014M -jar server.jar",      "image": "quay.io/pterodactyl/core:java",      "installed": true,      "environment": {        "SERVER_JARFILE": "server.jar",        "VANILLA_VERSION": "latest",        "STARTUP": "java -Xms128M -Xmx2048M -jar server.jar",        "P_SERVER_LOCATION": "GB",        "P_SERVER_UUID": "1a7ce997-259b-452e-8b4e-cecc464142ca",        "P_SERVER_ALLOCATION_LIMIT": 5      }    },    "updated_at": "2020-11-04T21:11:26+00:00",    "created_at": "2019-12-23T06:46:27+00:00"  }}

Authorization

Path Parameters

Request Body

Response Body

200application/json

`application/json`