Instances
Create instance
Provision a new compute instance. This creates a boot volume from the specified image, launches the VM with the given flavor and security groups, and optionally assigns a public IP.
Authorization
ApiKeyAuth X-API-Key<token>
API key for authentication. Generate from the Huddle01 Cloud dashboard.
In: header
Query Parameters
region*string
Region code (e.g., eu2, us1)
Header Parameters
Idempotency-Key?string
Unique key to ensure idempotent request handling
Request Body
application/json
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://cloud.huddleapis.com/api/v1/instances?region=string" \ -H "Content-Type: application/json" \ -d '{ "name": "my-web-server", "flavor_id": "flavor-4vcpu-8gb", "image_id": "ubuntu-22.04", "boot_disk_size": 50, "key_name": [ "my-ssh-key" ], "sg_names": [ "web-server-sg" ] }'{
"id": "string",
"name": "string",
"vcpus": 0,
"ram": 0,
"status": "string",
"created_at": "2019-08-24T14:15:22Z",
"image": {
"id": "string",
"name": "string",
"distribution": "string",
"distribution_version": "string"
},
"region": {
"name": "eu2"
}
}{
"success": false,
"error": "Invalid request"
}{
"success": false,
"error": "Invalid request"
}{
"success": false,
"error": "Invalid request"
}{
"success": false,
"error": "Invalid request"
}