Machines

A template sets the CPU, memory, installed apps and hourly price. GET /v1/catalog without authentication to inspect shared templates, prices and available payment methods. GET /v1/templates with a key to include your private templates.

Each template returns id, name, private, vcpus, memory_mb, hourly_usd, apps, office_ready and office_status. Installed Office apps alone do not establish activation. For an Office task, choose office_ready: true and create with require_office_ready: true.

Use prevent_cloning: true for a kept licensed computer. It refuses forks, private-template creation and starting copies from snapshots. Resume the original computer to preserve its identity.

POST /v1/machines starts a computer in one call. Always send a unique Idempotency-Key, and retain it with the exact request body until the result is known. A successful reply contains the computer ID, state, size and creation timings.

{"template":"windows-16gb","name":"office-report","auto_stop_minutes":15,"prevent_cloning":true,"require_office_ready":true}

GET /v1/machine-requests/{key} finds a computer after a lost create reply. POST /v1/machine-requests/{key}/stop cancels that create or stops the computer it produced. A cancelled request key cannot be reused.

GET /v1/machines lists kept computers. POST /v1/machines/{id}/stop saves state and stops running charges; POST /start resumes. Check stop_warning and resume_warning: a cold recovery can preserve disk while losing open apps or unsaved memory. DELETE erases the computer and its encryption key.

Starting more computers requires enough balance for 15 minutes of the resulting aggregate running rate, plus physical capacity. Running work continues against the actual balance. Paid accounts have no ordinary fixed count tier; operator restrictions and physical storage/memory still apply.