Machines

Provision, manage, and control cloud development machines

Machines are GPU-powered dev environments with SSH access, auto-stop on idle, and lifecycle management (start/stop/delete). Read operations use /{'{namespace}'}/machines, write operations go through /auth/v1/seed/.

Endpoints

Error responses

All machine endpoints may return the following errors:

Status	Description
400	Bad request -- invalid parameters or configuration
401	Unauthorized -- missing or invalid credentials
403	Forbidden -- insufficient permissions
404	Not found -- machine does not exist
409	Conflict -- machine is in an incompatible state for this action
422	Unprocessable entity -- invalid GPU/CPU/memory combination
429	Rate limit exceeded
500	Internal server error -- Seed orchestration failure

{
  "error": {
    "code": "invalid_request",
    "message": "GPU type 'A100-80GB' does not support gpu_count of 3. Must be 1, 2, 4, or 8.",
    "request_id": "req_9d4e5f6a7b8c"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "GPU type 'A100-80GB' does not support gpu_count of 3. Must be 1, 2, 4, or 8.",
    "request_id": "req_9d4e5f6a7b8c"
  }
}

Previous → Repositories

Next Overview →