Skip to main content
POST
Create a server

Authorizations

Authorization
string
header
required

API token from your CloudBlast account settings. Pass as Authorization: Bearer <token>.

Body

application/json
plan_id
integer
required

Plan ID from GET /plans

Example:

1

location_id
integer
required

Location ID from GET /locations

Example:

1

template_slug
string
required

Template slug from GET /locations/{id}/templates

Example:

"ubuntu-24.04"

hostname
string | null

Server hostname. Defaults to the plan name if omitted.

Maximum string length: 191
Example:

"web-01.example.com"

ssh_key_ids
integer[]

IDs of saved SSH keys to install during provisioning. Obtain IDs from GET /ssh-keys. The generated root password remains available.

Required array length: 1 - 20 elements
Example:

Response

Server created

data
object