Deploy new server

POST

https://api.vpsbg.eu/v1/servers

This endpoints creates a new order for a server and pays it off-session using your account's balance or performs a payment directly from your saved card.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Header Params

Body Params application/json

Example

{
    "name": "new_server",
    "plan": "cloud-vps-2gb",
    "billing_cycle": 3,
    "image_id": 73,
    "password": "fCm%5D&8Zc24rh"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.vpsbg.eu/v1/servers' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "new_server",
    "plan": "cloud-vps-2gb",
    "billing_cycle": 3,
    "image_id": 73,
    "password": "fCm%5D&8Zc24rh"
}'

Responses

🟢201The server was created successfully. Please bear in mind that in some cases, your server might be returned in status Processing as all servers are processed in a queue. You can check the server data at a later point using the provided ID.

application/json

Body

Example

{
    "message": "The Password field is required when ssh keys is not present.  ",
    "errors": {
        "password": [
            "The Password field is required when ssh keys is not present."
        ],
        "ssh_keys": [
            "The ssh keys field is required when Password is not present."
        ]
    }
}

🟠400Bad request (specified in the response)

🟠422Validation error. The error is specified in the response.

🔴500Server Error

Modified at 2026-02-11 13:49:48

Bandwidth

Start a server