# spinup — on-demand Firecracker microVMs

spinup provisions sandboxed Linux microVMs with SSH access, on demand.
Create, exec, snapshot, and destroy VMs via a REST API, or spin one up over SSH.

Base URL: https://spinup.studiokare.nl

## What you can do
  Create a VM        POST /api/vms             -> get back an SSH endpoint
  Run code in a VM   POST /api/vms/:id/exec    -> stdout/stderr/exitCode
  Snapshot a VM     POST /api/vms/:id/snapshot
  List snapshots    GET  /api/vms/snapshots/list
  List / get / stop GET /api/vms, GET /api/vms/:id, DELETE /api/vms/:id
  System status     GET  /api/admin/status
  SSH portal        ssh <user>@spinup.studiokare.nl -p 2200
                     interactive: new, connect, ls, rm, snap, clone, gen-key, api-keys, set-key
  VM web services   https://spinup.studiokare.nl/vm/{namespace}/{name}/  (no auth)

## Authentication
/api/* requires either an API key or HTTP Basic auth:
  Authorization: Bearer sk-<secret>     # generate with `gen-key` in the SSH portal
  # or standard HTTP Basic Auth if configured on the server
No auth needed: GET /up, GET /llms.txt, /vm/*.

## For agents — read this first
  GET /llms.txt   -> full machine-readable API reference with request/response
                     examples, status codes, and the SSH portal command table.
                     Fetch it, then call the API.

## For humans
  Web UI / docs:  https://studiokare.nl/spinup
  Health check:   GET /up