Galon Cloud
Galon API v1

/compute/instances

Base URL https://api.galon.ai/v1 · export GALON_API_BASE="https://api.galon.ai/v1"

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

StatusDescriptionBody
2XXSuccess: the JSON body the route returns (see the description for its fields).object
401Key missing or invalidError
4XXRefused: 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

NameInTypeDescription
Idempotency-Keyheaderstring · required

Request body

application/json

FieldTypeDescription
namestring · requiredHost name: a-z 0-9 and -, starting with a letter.
flavor"1vcpu-1gb" | "2vcpu-4gb" | "4vcpu-8gb" · requiredMachine size: vCPU and memory (disk included).
image"ubuntu-24.04" | "debian-12" · requiredOperating system image.
ssh_key_idsarray<string> · required1 to 5 key ids from list_ssh_keys (needs compute read access) or add_ssh_key.
quote_idstring · requiredQuote id from quote_compute_instance (cq_..., needs compute quote access).

Responses

StatusDescriptionBody
2XXSuccess: the JSON body the route returns (see the description for its fields).object
401Key missing or invalidError
4XXRefused: 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_..."}'