Skip to main content
POST
/
compute
/
machines
Create a machine
curl --request POST \
  --url https://api.akua.dev/v1/compute/machines \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "config_ref": "<string>",
  "cluster_id": "<string>",
  "node_claim": "<unknown>"
}
'
{
  "provider_id": "compute://abc123",
  "node_name": "worker-xl8r2",
  "status": "provisioning"
}

Documentation Index

Fetch the complete documentation index at: https://docs.akua.dev/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

workspace API token (sk_akua_...) or OAuth2 JWT. Create tokens at https://akua.dev/developers/api-tokens

Body

application/json
​
config_ref
string
required

ComputeConfig ID

​
cluster_id
string
required

Cluster ID

​
node_claim
any

Machine requirements (instance type, resources, taints)

Response

Machine created

​
provider_id
string
required
Example:

"compute://abc123"

​
node_name
string
required
Example:

"worker-xl8r2"

​
status
string
required
Example:

"provisioning"