Computers

Create a Computer.

Boots a persistent Linux machine and returns once it is provisioning. The root disk survives stop/start and is only reclaimed by DELETE. Billed per start, per vCPU-hour and GB-hour while running, and per GB-month of disk for as long as the Computer exists.

post/v1/computers

Request

  • Base URL: https://api.scalix.world
  • URL: https://api.scalix.world/v1/computers
  • Auth: HTTP bearer

Request body

namestring required

Lowercase DNS label, max 63 characters. Unique per account.

imagestring nullable

Guest image. ubuntu24 is the only image available today.

ssh_keysstring[] nullable

OpenSSH public keys authorised for root, one per array entry, max 32. Optional — exec and the browser terminal work without one. Send the public half only (the .pub file); a private key is rejected.

Example request

{
  "name": "build-box",
  "image": "ubuntu24",
  "resources": {
    "vcpus": 2,
    "memory_mb": 2048,
    "disk_gb": 20
  },
  "ssh_keys": [
    "ssh-ed25519 AAAAC3Nz… you@laptop"
  ]
}

Response

Computer created (initially CREATING)

idstring required
namestring required
imagestring required
statusstring required

CREATING | RUNNING | STOPPING | STOPPED | STARTING | DELETING | FAILED

statusReasonstring nullable

Human-readable reason for the current status (set on FAILED).

ipAddressstring nullable

Private address inside your network. Reserved for the Computer's lifetime — the same address comes back after a stop/start.

vcpusinteger required
memoryMbinteger required
diskGbinteger required
sshKeysstring[]

The OpenSSH public keys currently authorised for root. Public halves only — there is nothing secret to withhold here, and being able to read back what is installed is how you confirm a revocation took.

createdAtstring required
updatedAtstring required

Example response

{
  "status": "RUNNING"
}

Changes

No recorded changes to this operation across all 1 revision of this API.