Images
List images
Retrieve all base images available in a region, grouped by operating system distribution.
Use the id from a specific image version as the image_id when creating an instance.
curl -X GET \
"https://cloud.huddleapis.com/api/v1/images?region=eu2" \
-H "x-api-key: $HUDDLE_API_KEY" \
-H "Accept: application/json"x-api-key<token>
In: header
Query Parameters
regionstring
Region code where the resource exists (e.g., eu2).
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://cloud.huddleapis.com/api/v1/images?region=eu2"{
"image_groups": [
{
"distro": "ubuntu",
"versions": [
{
"id": "ubuntu-22-04-x64",
"version": "22.04"
},
{
"id": "ubuntu-20-04-x64",
"version": "20.04"
}
]
},
{
"distro": "debian",
"versions": [
{
"id": "debian-12-x64",
"version": "12"
}
]
}
]
}{
"message": "Bad request",
"error": {
"code": "BAD_REQUEST",
"message": "Invalid request body",
"type": "client"
},
"timestamp": "2024-03-18T10:22:00Z"
}{
"message": "Unauthorized",
"error": {
"code": "UNAUTHORIZED",
"message": "x-api-key header missing",
"type": "auth"
},
"timestamp": "2024-03-18T10:22:00Z"
}{
"message": "Internal server error",
"error": {
"code": "INTERNAL_ERROR",
"message": "Failed to create instance",
"type": "server"
},
"timestamp": "2024-03-18T10:22:00Z"
}