Servers

PreviousUnits NextCargo

Was this helpful?

Get server

get

Get server details by ID

Authorizations

Path parameters

idstring · uuidRequired

Responses

200

Server details

application/json

403

Forbidden

application/json

404

Server not found

application/json

500

Server error

application/json

get

GET /api/servers/{id} HTTP/1.1
Host: localhost:3000
Authorization: Bearer JWT
Accept: */*

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "internalId": "text",
  "name": "text",
  "nodeId": "123e4567-e89b-12d3-a456-426614174000",
  "unitId": "123e4567-e89b-12d3-a456-426614174000",
  "userId": "123e4567-e89b-12d3-a456-426614174000",
  "allocationId": "123e4567-e89b-12d3-a456-426614174000",
  "memoryMiB": 1,
  "diskMiB": 1,
  "cpuPercent": 1,
  "state": "text",
  "status": {
    "state": "text"
  },
  "node": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "fqdn": "text",
    "port": 1,
    "regionId": "123e4567-e89b-12d3-a456-426614174000",
    "isOnline": true,
    "lastChecked": "2025-05-20T02:46:50.679Z",
    "allocations": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "nodeId": "123e4567-e89b-12d3-a456-426614174000",
        "bindAddress": "text",
        "port": 1,
        "alias": "text",
        "notes": "text",
        "assigned": true,
        "serverId": "123e4567-e89b-12d3-a456-426614174000",
        "createdAt": "2025-05-20T02:46:50.679Z",
        "updatedAt": "2025-05-20T02:46:50.679Z"
      }
    ],
    "region": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "identifier": "text",
      "countryId": "text",
      "fallbackRegionId": "123e4567-e89b-12d3-a456-426614174000",
      "serverLimit": 1,
      "stats": {
        "serverCount": 1,
        "nodeCount": 1,
        "onlineNodeCount": 1,
        "atCapacity": true
      },
      "nodes": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "name": "text",
          "fqdn": "text",
          "port": 1,
          "regionId": "123e4567-e89b-12d3-a456-426614174000",
          "isOnline": true,
          "lastChecked": "2025-05-20T02:46:50.679Z",
          "allocations": [
            {
              "id": "123e4567-e89b-12d3-a456-426614174000",
              "nodeId": "123e4567-e89b-12d3-a456-426614174000",
              "bindAddress": "text",
              "port": 1,
              "alias": "text",
              "notes": "text",
              "assigned": true,
              "serverId": "123e4567-e89b-12d3-a456-426614174000",
              "createdAt": "2025-05-20T02:46:50.679Z",
              "updatedAt": "2025-05-20T02:46:50.679Z"
            }
          ],
          "region": {
            "id": "123e4567-e89b-12d3-a456-426614174000",
            "name": "text",
            "identifier": "text",
            "countryId": "text",
            "fallbackRegionId": "123e4567-e89b-12d3-a456-426614174000",
            "serverLimit": 1,
            "stats": {
              "serverCount": 1,
              "nodeCount": 1,
              "onlineNodeCount": 1,
              "atCapacity": true
            },
            "nodes": "[Circular Reference]",
            "createdAt": "2025-05-20T02:46:50.679Z",
            "updatedAt": "2025-05-20T02:46:50.679Z"
          },
          "createdAt": "2025-05-20T02:46:50.679Z",
          "updatedAt": "2025-05-20T02:46:50.679Z"
        }
      ],
      "createdAt": "2025-05-20T02:46:50.679Z",
      "updatedAt": "2025-05-20T02:46:50.679Z"
    },
    "createdAt": "2025-05-20T02:46:50.679Z",
    "updatedAt": "2025-05-20T02:46:50.679Z"
  },
  "unit": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "shortName": "text",
    "description": "text",
    "dockerImages": [
      {
        "image": "text",
        "displayName": "text"
      }
    ],
    "defaultDockerImage": "text",
    "dockerImage": "text",
    "defaultStartupCommand": "text",
    "configFiles": [
      {
        "path": "text",
        "content": "text"
      }
    ],
    "environmentVariables": [
      {
        "name": "text",
        "description": "text",
        "defaultValue": "text",
        "required": true,
        "userViewable": true,
        "userEditable": true,
        "rules": "text"
      }
    ],
    "installScript": {
      "dockerImage": "text",
      "entrypoint": "text",
      "script": "text"
    },
    "startup": {
      "userEditable": true,
      "readyRegex": "text",
      "stopCommand": "text"
    },
    "features": [
      {
        "name": "text",
        "description": "text",
        "iconPath": "text",
        "type": "required",
        "uiData": {
          "component": "text",
          "props": {}
        }
      }
    ],
    "meta": {
      "version": "text",
      "author": "text",
      "website": "text",
      "supportUrl": "text"
    },
    "recommendedRequirements": {
      "memoryMiB": 1,
      "diskMiB": 1,
      "cpuPercent": 1
    },
    "createdAt": "2025-05-20T02:46:50.679Z",
    "updatedAt": "2025-05-20T02:46:50.679Z"
  },
  "allocation": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "nodeId": "123e4567-e89b-12d3-a456-426614174000",
    "bindAddress": "text",
    "port": 1,
    "alias": "text",
    "notes": "text",
    "assigned": true,
    "serverId": "123e4567-e89b-12d3-a456-426614174000",
    "createdAt": "2025-05-20T02:46:50.679Z",
    "updatedAt": "2025-05-20T02:46:50.679Z"
  },
  "user": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "username": "text",
    "permissions": [
      "text"
    ],
    "createdAt": "2025-05-20T02:46:50.679Z",
    "updatedAt": "2025-05-20T02:46:50.679Z"
  },
  "validationToken": "text",
  "projectId": "123e4567-e89b-12d3-a456-426614174000",
  "project": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "description": "text",
    "userId": "123e4567-e89b-12d3-a456-426614174000",
    "serverCount": 1,
    "createdAt": "2025-05-20T02:46:50.679Z",
    "updatedAt": "2025-05-20T02:46:50.679Z"
  },
  "createdAt": "2025-05-20T02:46:50.679Z",
  "updatedAt": "2025-05-20T02:46:50.679Z"
}

Delete server

delete

Delete a server

Authorizations

Path parameters

idstring · uuidRequired

Responses

204

Server deleted successfully

403

Forbidden

application/json

404

Server not found

application/json

500

Server error

application/json

delete

DELETE /api/servers/{id} HTTP/1.1
Host: localhost:3000
Authorization: Bearer JWT
Accept: */*

No content

Send power action

post

Send a power command to the server (start, stop, restart)

Authorizations

Path parameters

idstring · uuidRequired

actionstring · enumRequiredPossible values:

Responses

204

Power action sent successfully

400

Invalid action

application/json

403

Forbidden

application/json

404

Server not found

application/json

500

Server error

application/json

post

POST /api/servers/{id}/power/{action} HTTP/1.1
Host: localhost:3000
Authorization: Bearer JWT
Accept: */*

No content

Reinstall server

post

Reinstall the server

Authorizations

Path parameters

idstring · uuidRequired

Responses

204

Reinstall initiated successfully

403

Forbidden

application/json

404

Server not found

application/json

500

Server error

application/json

post

POST /api/servers/{id}/reinstall HTTP/1.1
Host: localhost:3000
Authorization: Bearer JWT
Accept: */*

No content

Get server Docker images

get

Get available Docker images for a server

Authorizations

Path parameters

idstring · uuidRequired

Responses

200

Available Docker images

application/json

403

Forbidden

application/json

404

Server not found

application/json

500

Server error

application/json

get

GET /api/servers/{id}/docker-images HTTP/1.1
Host: localhost:3000
Authorization: Bearer JWT
Accept: */*

{
  "availableImages": [
    {
      "image": "text",
      "displayName": "text"
    }
  ],
  "currentImage": "text"
}

Ship cargo to server

post

Ship cargo files to the server

Authorizations

Path parameters

idstring · uuidRequired

Responses

204

Cargo shipped successfully

403

Forbidden

application/json

404

Server not found

application/json

500

Server error

application/json

post

POST /api/servers/{id}/cargo/ship HTTP/1.1
Host: localhost:3000
Authorization: Bearer JWT
Accept: */*

No content

Get server cargo files

get

Get all cargo files associated with a server

Authorizations

Path parameters

serverIdstring · uuidRequired

Query parameters

tokenstringOptional

Optional validation token for daemon requests

Responses

200

Server cargo files

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Server not found

application/json

500

Server error

application/json

get

GET /api/servers/{serverId}/cargo-files HTTP/1.1
Host: localhost:3000
Authorization: Bearer JWT
Accept: */*

{
  "cargoFiles": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "url": "text",
      "targetPath": "text",
      "properties": {
        "hidden": true,
        "readonly": true,
        "noDelete": true,
        "customProperties": {}
      }
    }
  ]
}

Get server configuration

get

Get server configuration for daemon

Authorizations

Path parameters

internalIdstringRequired

Responses

200

Server configuration

application/json

404

Server not found

application/json

500

Server error

application/json

get

GET /api/servers/{internalId}/config HTTP/1.1
Host: localhost:3000
Authorization: Bearer JWT
Accept: */*

{
  "dockerImage": "text",
  "availableImages": [
    {
      "image": "text",
      "displayName": "text"
    }
  ],
  "variables": [
    {
      "name": "text",
      "description": "text",
      "defaultValue": "text",
      "rules": "text"
    }
  ],
  "startupCommand": "text",
  "configFiles": [
    {
      "path": "text",
      "content": "text"
    }
  ],
  "install": {
    "dockerImage": "text",
    "entrypoint": "text",
    "script": "text"
  },
  "cargo": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "url": "text",
      "targetPath": "text",
      "properties": {
        "hidden": true,
        "readonly": true,
        "noDelete": true,
        "customProperties": {}
      }
    }
  ],
  "serverControl": {
    "readyRegex": "text",
    "stopCommand": "text"
  }
}

Validate server

get

Validate server with token for daemon

Authorizations

Path parameters

internalIdstringRequired

tokenstringRequired

Responses

200

Validation successful

application/json

403

Invalid validation token

application/json

404

Server not found

application/json

500

Server error

application/json

get

GET /api/servers/{internalId}/validate/{token} HTTP/1.1
Host: localhost:3000
Authorization: Bearer JWT
Accept: */*

{
  "validated": true,
  "server": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "internalId": "text",
    "node": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "fqdn": "text",
      "port": 1
    }
  }
}

Get all servers

get

List all servers (or user's servers for non-admin)

Authorizations

Responses

200

List of servers

application/json

403

Forbidden

application/json

500

Server error

application/json

get

GET /api/servers HTTP/1.1
Host: localhost:3000
Authorization: Bearer JWT
Accept: */*

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "internalId": "text",
    "name": "text",
    "nodeId": "123e4567-e89b-12d3-a456-426614174000",
    "unitId": "123e4567-e89b-12d3-a456-426614174000",
    "userId": "123e4567-e89b-12d3-a456-426614174000",
    "allocationId": "123e4567-e89b-12d3-a456-426614174000",
    "memoryMiB": 1,
    "diskMiB": 1,
    "cpuPercent": 1,
    "state": "text",
    "status": {
      "state": "text"
    },
    "node": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "fqdn": "text",
      "port": 1,
      "regionId": "123e4567-e89b-12d3-a456-426614174000",
      "isOnline": true,
      "lastChecked": "2025-05-20T02:46:50.679Z",
      "allocations": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "nodeId": "123e4567-e89b-12d3-a456-426614174000",
          "bindAddress": "text",
          "port": 1,
          "alias": "text",
          "notes": "text",
          "assigned": true,
          "serverId": "123e4567-e89b-12d3-a456-426614174000",
          "createdAt": "2025-05-20T02:46:50.679Z",
          "updatedAt": "2025-05-20T02:46:50.679Z"
        }
      ],
      "region": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "name": "text",
        "identifier": "text",
        "countryId": "text",
        "fallbackRegionId": "123e4567-e89b-12d3-a456-426614174000",
        "serverLimit": 1,
        "stats": {
          "serverCount": 1,
          "nodeCount": 1,
          "onlineNodeCount": 1,
          "atCapacity": true
        },
        "nodes": [
          {
            "id": "123e4567-e89b-12d3-a456-426614174000",
            "name": "text",
            "fqdn": "text",
            "port": 1,
            "regionId": "123e4567-e89b-12d3-a456-426614174000",
            "isOnline": true,
            "lastChecked": "2025-05-20T02:46:50.679Z",
            "allocations": [
              {
                "id": "123e4567-e89b-12d3-a456-426614174000",
                "nodeId": "123e4567-e89b-12d3-a456-426614174000",
                "bindAddress": "text",
                "port": 1,
                "alias": "text",
                "notes": "text",
                "assigned": true,
                "serverId": "123e4567-e89b-12d3-a456-426614174000",
                "createdAt": "2025-05-20T02:46:50.679Z",
                "updatedAt": "2025-05-20T02:46:50.679Z"
              }
            ],
            "region": "[Circular Reference]",
            "createdAt": "2025-05-20T02:46:50.679Z",
            "updatedAt": "2025-05-20T02:46:50.679Z"
          }
        ],
        "createdAt": "2025-05-20T02:46:50.679Z",
        "updatedAt": "2025-05-20T02:46:50.679Z"
      },
      "createdAt": "2025-05-20T02:46:50.679Z",
      "updatedAt": "2025-05-20T02:46:50.679Z"
    },
    "unit": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "shortName": "text",
      "description": "text",
      "dockerImages": [
        {
          "image": "text",
          "displayName": "text"
        }
      ],
      "defaultDockerImage": "text",
      "dockerImage": "text",
      "defaultStartupCommand": "text",
      "configFiles": [
        {
          "path": "text",
          "content": "text"
        }
      ],
      "environmentVariables": [
        {
          "name": "text",
          "description": "text",
          "defaultValue": "text",
          "required": true,
          "userViewable": true,
          "userEditable": true,
          "rules": "text"
        }
      ],
      "installScript": {
        "dockerImage": "text",
        "entrypoint": "text",
        "script": "text"
      },
      "startup": {
        "userEditable": true,
        "readyRegex": "text",
        "stopCommand": "text"
      },
      "features": [
        {
          "name": "text",
          "description": "text",
          "iconPath": "text",
          "type": "required",
          "uiData": {
            "component": "text",
            "props": {}
          }
        }
      ],
      "meta": {
        "version": "text",
        "author": "text",
        "website": "text",
        "supportUrl": "text"
      },
      "recommendedRequirements": {
        "memoryMiB": 1,
        "diskMiB": 1,
        "cpuPercent": 1
      },
      "createdAt": "2025-05-20T02:46:50.679Z",
      "updatedAt": "2025-05-20T02:46:50.679Z"
    },
    "allocation": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "nodeId": "123e4567-e89b-12d3-a456-426614174000",
      "bindAddress": "text",
      "port": 1,
      "alias": "text",
      "notes": "text",
      "assigned": true,
      "serverId": "123e4567-e89b-12d3-a456-426614174000",
      "createdAt": "2025-05-20T02:46:50.679Z",
      "updatedAt": "2025-05-20T02:46:50.679Z"
    },
    "user": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "username": "text",
      "permissions": [
        "text"
      ],
      "createdAt": "2025-05-20T02:46:50.679Z",
      "updatedAt": "2025-05-20T02:46:50.679Z"
    },
    "validationToken": "text",
    "projectId": "123e4567-e89b-12d3-a456-426614174000",
    "project": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "description": "text",
      "userId": "123e4567-e89b-12d3-a456-426614174000",
      "serverCount": 1,
      "createdAt": "2025-05-20T02:46:50.679Z",
      "updatedAt": "2025-05-20T02:46:50.679Z"
    },
    "createdAt": "2025-05-20T02:46:50.679Z",
    "updatedAt": "2025-05-20T02:46:50.679Z"
  }
]

Create server

post

Create a new server

Authorizations

Body

namestring · min: 1 · max: 100Required

nodeIdstring · uuidOptional

regionIdstring · uuidOptional

allocationIdstring · uuidOptional

memoryMiBinteger · min: 128Required

diskMiBinteger · min: 1024Required

cpuPercentnumber · min: 1 · max: 100Required

unitIdstring · uuidRequired

userIdstring · uuidRequired

projectIdstring · uuidOptional

dockerImagestringOptional

startupCommandstringOptional

featureSelectionsobjectOptional

Responses

201

Server created successfully

application/json

400

Invalid request or no available nodes/allocations

application/json

403

Forbidden

application/json

404

Node, unit, or allocation not found

application/json

500

Server error

application/json

post

POST /api/servers HTTP/1.1
Host: localhost:3000
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 423

{
  "name": "text",
  "nodeId": "123e4567-e89b-12d3-a456-426614174000",
  "regionId": "123e4567-e89b-12d3-a456-426614174000",
  "allocationId": "123e4567-e89b-12d3-a456-426614174000",
  "memoryMiB": 1,
  "diskMiB": 1,
  "cpuPercent": 1,
  "unitId": "123e4567-e89b-12d3-a456-426614174000",
  "userId": "123e4567-e89b-12d3-a456-426614174000",
  "projectId": "123e4567-e89b-12d3-a456-426614174000",
  "dockerImage": "text",
  "startupCommand": "text",
  "featureSelections": {}
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "internalId": "text",
  "name": "text",
  "nodeId": "123e4567-e89b-12d3-a456-426614174000",
  "unitId": "123e4567-e89b-12d3-a456-426614174000",
  "userId": "123e4567-e89b-12d3-a456-426614174000",
  "allocationId": "123e4567-e89b-12d3-a456-426614174000",
  "memoryMiB": 1,
  "diskMiB": 1,
  "cpuPercent": 1,
  "state": "text",
  "status": {
    "state": "text"
  },
  "node": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "fqdn": "text",
    "port": 1,
    "regionId": "123e4567-e89b-12d3-a456-426614174000",
    "isOnline": true,
    "lastChecked": "2025-05-20T02:46:50.679Z",
    "allocations": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "nodeId": "123e4567-e89b-12d3-a456-426614174000",
        "bindAddress": "text",
        "port": 1,
        "alias": "text",
        "notes": "text",
        "assigned": true,
        "serverId": "123e4567-e89b-12d3-a456-426614174000",
        "createdAt": "2025-05-20T02:46:50.679Z",
        "updatedAt": "2025-05-20T02:46:50.679Z"
      }
    ],
    "region": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "identifier": "text",
      "countryId": "text",
      "fallbackRegionId": "123e4567-e89b-12d3-a456-426614174000",
      "serverLimit": 1,
      "stats": {
        "serverCount": 1,
        "nodeCount": 1,
        "onlineNodeCount": 1,
        "atCapacity": true
      },
      "nodes": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "name": "text",
          "fqdn": "text",
          "port": 1,
          "regionId": "123e4567-e89b-12d3-a456-426614174000",
          "isOnline": true,
          "lastChecked": "2025-05-20T02:46:50.679Z",
          "allocations": [
            {
              "id": "123e4567-e89b-12d3-a456-426614174000",
              "nodeId": "123e4567-e89b-12d3-a456-426614174000",
              "bindAddress": "text",
              "port": 1,
              "alias": "text",
              "notes": "text",
              "assigned": true,
              "serverId": "123e4567-e89b-12d3-a456-426614174000",
              "createdAt": "2025-05-20T02:46:50.679Z",
              "updatedAt": "2025-05-20T02:46:50.679Z"
            }
          ],
          "region": {
            "id": "123e4567-e89b-12d3-a456-426614174000",
            "name": "text",
            "identifier": "text",
            "countryId": "text",
            "fallbackRegionId": "123e4567-e89b-12d3-a456-426614174000",
            "serverLimit": 1,
            "stats": {
              "serverCount": 1,
              "nodeCount": 1,
              "onlineNodeCount": 1,
              "atCapacity": true
            },
            "nodes": "[Circular Reference]",
            "createdAt": "2025-05-20T02:46:50.679Z",
            "updatedAt": "2025-05-20T02:46:50.679Z"
          },
          "createdAt": "2025-05-20T02:46:50.679Z",
          "updatedAt": "2025-05-20T02:46:50.679Z"
        }
      ],
      "createdAt": "2025-05-20T02:46:50.679Z",
      "updatedAt": "2025-05-20T02:46:50.679Z"
    },
    "createdAt": "2025-05-20T02:46:50.679Z",
    "updatedAt": "2025-05-20T02:46:50.679Z"
  },
  "unit": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "shortName": "text",
    "description": "text",
    "dockerImages": [
      {
        "image": "text",
        "displayName": "text"
      }
    ],
    "defaultDockerImage": "text",
    "dockerImage": "text",
    "defaultStartupCommand": "text",
    "configFiles": [
      {
        "path": "text",
        "content": "text"
      }
    ],
    "environmentVariables": [
      {
        "name": "text",
        "description": "text",
        "defaultValue": "text",
        "required": true,
        "userViewable": true,
        "userEditable": true,
        "rules": "text"
      }
    ],
    "installScript": {
      "dockerImage": "text",
      "entrypoint": "text",
      "script": "text"
    },
    "startup": {
      "userEditable": true,
      "readyRegex": "text",
      "stopCommand": "text"
    },
    "features": [
      {
        "name": "text",
        "description": "text",
        "iconPath": "text",
        "type": "required",
        "uiData": {
          "component": "text",
          "props": {}
        }
      }
    ],
    "meta": {
      "version": "text",
      "author": "text",
      "website": "text",
      "supportUrl": "text"
    },
    "recommendedRequirements": {
      "memoryMiB": 1,
      "diskMiB": 1,
      "cpuPercent": 1
    },
    "createdAt": "2025-05-20T02:46:50.679Z",
    "updatedAt": "2025-05-20T02:46:50.679Z"
  },
  "allocation": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "nodeId": "123e4567-e89b-12d3-a456-426614174000",
    "bindAddress": "text",
    "port": 1,
    "alias": "text",
    "notes": "text",
    "assigned": true,
    "serverId": "123e4567-e89b-12d3-a456-426614174000",
    "createdAt": "2025-05-20T02:46:50.679Z",
    "updatedAt": "2025-05-20T02:46:50.679Z"
  },
  "user": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "username": "text",
    "permissions": [
      "text"
    ],
    "createdAt": "2025-05-20T02:46:50.679Z",
    "updatedAt": "2025-05-20T02:46:50.679Z"
  },
  "validationToken": "text",
  "projectId": "123e4567-e89b-12d3-a456-426614174000",
  "project": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "description": "text",
    "userId": "123e4567-e89b-12d3-a456-426614174000",
    "serverCount": 1,
    "createdAt": "2025-05-20T02:46:50.679Z",
    "updatedAt": "2025-05-20T02:46:50.679Z"
  },
  "createdAt": "2025-05-20T02:46:50.679Z",
  "updatedAt": "2025-05-20T02:46:50.679Z"
}

Update server

patch

Update server details

Authorizations

Path parameters

idstring · uuidRequired

Body

namestring · min: 1 · max: 100Optional

memoryMiBinteger · min: 128Optional

diskMiBinteger · min: 1024Optional

cpuPercentnumber · min: 1 · max: 100Optional

unitIdstring · uuidOptional

projectIdstring · uuidOptional

dockerImagestringOptional

startupCommandstringOptional

Responses

200

Server updated successfully

application/json

400

Invalid request

application/json

403

Forbidden

application/json

404

Server not found

application/json

500

Server error

application/json

patch

PATCH /api/servers/{id} HTTP/1.1
Host: localhost:3000
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 200

{
  "name": "text",
  "memoryMiB": 1,
  "diskMiB": 1,
  "cpuPercent": 1,
  "unitId": "123e4567-e89b-12d3-a456-426614174000",
  "projectId": "123e4567-e89b-12d3-a456-426614174000",
  "dockerImage": "text",
  "startupCommand": "text"
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "internalId": "text",
  "name": "text",
  "nodeId": "123e4567-e89b-12d3-a456-426614174000",
  "unitId": "123e4567-e89b-12d3-a456-426614174000",
  "userId": "123e4567-e89b-12d3-a456-426614174000",
  "allocationId": "123e4567-e89b-12d3-a456-426614174000",
  "memoryMiB": 1,
  "diskMiB": 1,
  "cpuPercent": 1,
  "state": "text",
  "status": {
    "state": "text"
  },
  "node": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "fqdn": "text",
    "port": 1,
    "regionId": "123e4567-e89b-12d3-a456-426614174000",
    "isOnline": true,
    "lastChecked": "2025-05-20T02:46:50.679Z",
    "allocations": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "nodeId": "123e4567-e89b-12d3-a456-426614174000",
        "bindAddress": "text",
        "port": 1,
        "alias": "text",
        "notes": "text",
        "assigned": true,
        "serverId": "123e4567-e89b-12d3-a456-426614174000",
        "createdAt": "2025-05-20T02:46:50.679Z",
        "updatedAt": "2025-05-20T02:46:50.679Z"
      }
    ],
    "region": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "identifier": "text",
      "countryId": "text",
      "fallbackRegionId": "123e4567-e89b-12d3-a456-426614174000",
      "serverLimit": 1,
      "stats": {
        "serverCount": 1,
        "nodeCount": 1,
        "onlineNodeCount": 1,
        "atCapacity": true
      },
      "nodes": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "name": "text",
          "fqdn": "text",
          "port": 1,
          "regionId": "123e4567-e89b-12d3-a456-426614174000",
          "isOnline": true,
          "lastChecked": "2025-05-20T02:46:50.679Z",
          "allocations": [
            {
              "id": "123e4567-e89b-12d3-a456-426614174000",
              "nodeId": "123e4567-e89b-12d3-a456-426614174000",
              "bindAddress": "text",
              "port": 1,
              "alias": "text",
              "notes": "text",
              "assigned": true,
              "serverId": "123e4567-e89b-12d3-a456-426614174000",
              "createdAt": "2025-05-20T02:46:50.679Z",
              "updatedAt": "2025-05-20T02:46:50.679Z"
            }
          ],
          "region": {
            "id": "123e4567-e89b-12d3-a456-426614174000",
            "name": "text",
            "identifier": "text",
            "countryId": "text",
            "fallbackRegionId": "123e4567-e89b-12d3-a456-426614174000",
            "serverLimit": 1,
            "stats": {
              "serverCount": 1,
              "nodeCount": 1,
              "onlineNodeCount": 1,
              "atCapacity": true
            },
            "nodes": "[Circular Reference]",
            "createdAt": "2025-05-20T02:46:50.679Z",
            "updatedAt": "2025-05-20T02:46:50.679Z"
          },
          "createdAt": "2025-05-20T02:46:50.679Z",
          "updatedAt": "2025-05-20T02:46:50.679Z"
        }
      ],
      "createdAt": "2025-05-20T02:46:50.679Z",
      "updatedAt": "2025-05-20T02:46:50.679Z"
    },
    "createdAt": "2025-05-20T02:46:50.679Z",
    "updatedAt": "2025-05-20T02:46:50.679Z"
  },
  "unit": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "shortName": "text",
    "description": "text",
    "dockerImages": [
      {
        "image": "text",
        "displayName": "text"
      }
    ],
    "defaultDockerImage": "text",
    "dockerImage": "text",
    "defaultStartupCommand": "text",
    "configFiles": [
      {
        "path": "text",
        "content": "text"
      }
    ],
    "environmentVariables": [
      {
        "name": "text",
        "description": "text",
        "defaultValue": "text",
        "required": true,
        "userViewable": true,
        "userEditable": true,
        "rules": "text"
      }
    ],
    "installScript": {
      "dockerImage": "text",
      "entrypoint": "text",
      "script": "text"
    },
    "startup": {
      "userEditable": true,
      "readyRegex": "text",
      "stopCommand": "text"
    },
    "features": [
      {
        "name": "text",
        "description": "text",
        "iconPath": "text",
        "type": "required",
        "uiData": {
          "component": "text",
          "props": {}
        }
      }
    ],
    "meta": {
      "version": "text",
      "author": "text",
      "website": "text",
      "supportUrl": "text"
    },
    "recommendedRequirements": {
      "memoryMiB": 1,
      "diskMiB": 1,
      "cpuPercent": 1
    },
    "createdAt": "2025-05-20T02:46:50.679Z",
    "updatedAt": "2025-05-20T02:46:50.679Z"
  },
  "allocation": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "nodeId": "123e4567-e89b-12d3-a456-426614174000",
    "bindAddress": "text",
    "port": 1,
    "alias": "text",
    "notes": "text",
    "assigned": true,
    "serverId": "123e4567-e89b-12d3-a456-426614174000",
    "createdAt": "2025-05-20T02:46:50.679Z",
    "updatedAt": "2025-05-20T02:46:50.679Z"
  },
  "user": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "username": "text",
    "permissions": [
      "text"
    ],
    "createdAt": "2025-05-20T02:46:50.679Z",
    "updatedAt": "2025-05-20T02:46:50.679Z"
  },
  "validationToken": "text",
  "projectId": "123e4567-e89b-12d3-a456-426614174000",
  "project": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "description": "text",
    "userId": "123e4567-e89b-12d3-a456-426614174000",
    "serverCount": 1,
    "createdAt": "2025-05-20T02:46:50.679Z",
    "updatedAt": "2025-05-20T02:46:50.679Z"
  },
  "createdAt": "2025-05-20T02:46:50.679Z",
  "updatedAt": "2025-05-20T02:46:50.679Z"
}

Update server Docker image

patch

Change the Docker image used by the server

Authorizations

Path parameters

idstring · uuidRequired

Body

dockerImagestring · min: 1Required

Responses

200

Docker image updated successfully

application/json

400

Invalid request or image not available

application/json

403

Forbidden

application/json

404

Server not found

application/json

500

Server error

application/json

patch

PATCH /api/servers/{id}/docker-image HTTP/1.1
Host: localhost:3000
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 22

{
  "dockerImage": "text"
}

{
  "dockerImage": "text",
  "message": "text"
}