List sandbox images
curl --request GET \
--url https://console.cloudblast.io/api/v2/sandboxes/images \
--header 'Authorization: Bearer <token>'import requests
url = "https://console.cloudblast.io/api/v2/sandboxes/images"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://console.cloudblast.io/api/v2/sandboxes/images', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://console.cloudblast.io/api/v2/sandboxes/images",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://console.cloudblast.io/api/v2/sandboxes/images"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://console.cloudblast.io/api/v2/sandboxes/images")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://console.cloudblast.io/api/v2/sandboxes/images")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"id": 3,
"name": "Ubuntu 24.04 Desktop",
"slug": "ubuntu-24.04-desktop",
"os": "linux",
"desktop": true,
"vcpu": 2,
"memory_mb": 4096,
"disk_gb": 20,
"location": {
"id": 1,
"name": "Frankfurt, Germany",
"short_code": "fra",
"icon": "https://console.cloudblast.io/storage/locations/de.svg"
},
"hourly_price": 0.03,
"stopped_hourly_price": 0.002,
"allowed": true,
"in_stock": true
}
],
"limits": {
"used": 1,
"max": 2,
"cpu": 2,
"memory_mb": 4096
},
"currency": "EUR",
"lifecycle": {
"auto_stop_minutes": 15,
"auto_destroy_minutes": -1,
"min_auto_stop_minutes": 5,
"max_minutes": 43200
}
}{
"error": {
"code": "UNAUTHENTICATED",
"message": "Missing or invalid Authorization header. Use: Authorization: Bearer <token>"
}
}Sandboxes
List Sandbox Images
The images you can create a sandbox from. The image decides the OS, the size (vCPUs, memory and disk) and the location. Sizes are fixed per image.
allowed is false for an image that is larger than your account level allows. in_stock is false for an image that is out of stock right now. limits says how many sandboxes you have and how many you may have. lifecycle gives the defaults a new sandbox gets and the range you may choose from. Prices are per hour in currency, billed per minute.
While sandboxes are switched off on the platform, the answer is { "data": [], "limits": null }.
GET
/
sandboxes
/
images
List sandbox images
curl --request GET \
--url https://console.cloudblast.io/api/v2/sandboxes/images \
--header 'Authorization: Bearer <token>'import requests
url = "https://console.cloudblast.io/api/v2/sandboxes/images"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://console.cloudblast.io/api/v2/sandboxes/images', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://console.cloudblast.io/api/v2/sandboxes/images",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://console.cloudblast.io/api/v2/sandboxes/images"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://console.cloudblast.io/api/v2/sandboxes/images")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://console.cloudblast.io/api/v2/sandboxes/images")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"id": 3,
"name": "Ubuntu 24.04 Desktop",
"slug": "ubuntu-24.04-desktop",
"os": "linux",
"desktop": true,
"vcpu": 2,
"memory_mb": 4096,
"disk_gb": 20,
"location": {
"id": 1,
"name": "Frankfurt, Germany",
"short_code": "fra",
"icon": "https://console.cloudblast.io/storage/locations/de.svg"
},
"hourly_price": 0.03,
"stopped_hourly_price": 0.002,
"allowed": true,
"in_stock": true
}
],
"limits": {
"used": 1,
"max": 2,
"cpu": 2,
"memory_mb": 4096
},
"currency": "EUR",
"lifecycle": {
"auto_stop_minutes": 15,
"auto_destroy_minutes": -1,
"min_auto_stop_minutes": 5,
"max_minutes": 43200
}
}{
"error": {
"code": "UNAUTHENTICATED",
"message": "Missing or invalid Authorization header. Use: Authorization: Bearer <token>"
}
}Authorizations
Response
Images, your limits and the lifecycle defaults