Skip to main content

​
CloudBlast API

The CloudBlast API lets you manage your cloud infrastructure programmatically. Create servers, manage IP addresses, configure firewalls, and more — all through a simple REST interface.

​
Base URL

https://console.cloudblast.io/api/v2

​
Key Concepts

Template Slugs

Templates are identified by slugs (e.g., ubuntu-24.04) instead of UUIDs. Slugs work across all nodes in a location — you don’t need to know which node your server will land on.

Automatic Node Selection

When creating a server, the API automatically selects the best node based on available resources, template availability, and IP availability.

Server Identification

Servers can be identified by their full UUID (36 chars) or short UUID (8 chars) in all API endpoints.

Consistent Responses

All responses use {"data": ...} for success and {"error": {"code": "...", "message": "..."}} for errors.

​
Quick Start

  1. Get your API key from Account Settings
  2. Pick a location and template:
# List locations
curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://console.cloudblast.io/api/v2/locations

# List templates for a location
curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://console.cloudblast.io/api/v2/locations/1/templates
  1. Create a server:
curl -X POST https://console.cloudblast.io/api/v2/servers \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "plan_id": 1,
    "location_id": 1,
    "template_slug": "ubuntu-24.04",
    "hostname": "my-server.example.com"
  }'
The response includes the server details, root password, and IP addresses.

​
Typical Workflow