GET /compute/instances
List machines
List the virtual machines of this project. Use when finding a machine or its vm_ id. Before: nothing. Returns data (machines with state, size, image and ssh access). Scope: compute:read.
API key (Bearer), on the public API endpoint.
Responses
| Status | Description | Body |
|---|---|---|
2XX | Success: the JSON body the route returns (see the description for its fields). | object |
401 | Key missing or invalid | Error |
4XX | Refused: act on detail.code, then follow detail.next_action (404 not_found while the service is not open to the account). | Error |
Examples
curl
curl -X GET "$GALON_API_BASE/compute/instances" \
-H "Authorization: Bearer $GALON_API_KEY"POST /compute/instances
Create a machine
Create a Linux virtual machine billed per minute. Use when the user asked for a machine and accepted the quote; it costs money until deleted. Before: add_ssh_key and quote_compute_instance (needs compute quote access), same flavor and image. Returns the machine (provisioning); poll get_compute_instance (needs compute read access) until running, then use its ssh command. Scope: compute:write. Needs a prepaid balance.
API key (Bearer), on the public API endpoint.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
Idempotency-Key | header | string · required |
Request body
application/json
| Field | Type | Description |
|---|---|---|
name | string · required | Host name: a-z 0-9 and -, starting with a letter. |
flavor | "1vcpu-1gb" | "2vcpu-4gb" | "4vcpu-8gb" · required | Machine size: vCPU and memory (disk included). |
image | "ubuntu-24.04" | "debian-12" · required | Operating system image. |
ssh_key_ids | array<string> · required | 1 to 5 key ids from list_ssh_keys (needs compute read access) or add_ssh_key. |
quote_id | string · required | Quote id from quote_compute_instance (cq_..., needs compute quote access). |
Responses
| Status | Description | Body |
|---|---|---|
2XX | Success: the JSON body the route returns (see the description for its fields). | object |
401 | Key missing or invalid | Error |
4XX | Refused: act on detail.code, then follow detail.next_action (404 not_found while the service is not open to the account). | Error |
Examples
curl
curl -X POST "$GALON_API_BASE/compute/instances" \
-H "Authorization: Bearer $GALON_API_KEY" \
-H "Idempotency-Key: <unique-key>" \
-H "Content-Type: application/json" \
-d '{"name": "string", "flavor": "1vcpu-1gb", "image": "ubuntu-24.04", "ssh_key_ids": ["key_..."], "quote_id": "cq_..."}'