Create Server - RunCloud

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

accept

string

required

Example:

application/json

Body Params application/json

name

string

required

Server Name

ipAddress

string

required

Server's IP Address

provider

string

optional

digitalocean, linode, upcloud, hetzner, vultr

webServerType

string

required

Type of Web Server. nginx or ols

installationType

string

required

Type of installation whether native or containerized

databaseType

string

optional

Specifies the type of database to install; can be either mysql or mariadb (default: mariadb).

Example

{
    "name": "Test API Server",
    "ipAddress": "12.24.3.232",
    "provider": "digitalocean",
    "webServerType": "nginx",
    "installationType": "native",
    "databaseType": "mariadb"
}

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://manage.runcloud.io/api/v3/servers' \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Test API Server",
    "ipAddress": "12.24.3.232",
    "provider": "digitalocean",
    "webServerType": "nginx",
    "installationType": "native",
    "databaseType": "mariadb"
}'

Responses

🟢200Success

application/json

Body

id

integer

required

Server ID

name

string

required

Server Name

provider

string

required

Server Provider

stack

string

required

Stack of the server whether native or containerized

ipAddress

string

required

IP Address of the server

country_iso_code

string

required

os

string

required

Operating system of the server

osVersion

string

required

Version of the OS

connected

boolean

required

Status of the server whether it's connected to RunCloud or not

online

boolean

required

Status of the server whether it's online or not

agentVersion

string

required

RunCloud agent version

phpCLIVersion

string

required

PHP CLI version

softwareUpdate

boolean

required

Auto software update

securityUpdate

boolean

required

Auto security update

transferStatus

string

required

Status on whether the server is transferrable or not

created_at

string

required

The time that the server was created at