Documentation
Quickstart
Three calls get you a routable instance. Everything else is optional.
1. Authenticate
export TOKEN="$YOUR_API_TOKEN" curl -s https://sla.sunlawai.com/api/v1/whoami -H "Authorization: Bearer $TOKEN"
2. Create
curl -s https://sla.sunlawai.com/api/v1/instances -H "Authorization: Bearer $TOKEN" \ -d '{"region":"lax","vcpu":2,"mem_mb":4096,"ssh_key":"…"}'
Instances are billed from provisioning, not from first boot.
3. Observe
curl -s https://sla.sunlawai.com/api/v1/paths/lax-home-1/metrics \ -H "Authorization: Bearer $TOKEN" {"rtt_ms":{"p50":169,"p90":210},"loss_pct":0.0,"retrans":3}
Reference
| Endpoint | Purpose |
|---|---|
| GET /api/v1/whoami | Token identity and quota |
| POST /api/v1/instances | Provision |
| GET /api/v1/instances | List |
| DELETE /api/v1/instances/:id | Destroy |
| Endpoint | Purpose |
|---|---|
| GET /api/v1/paths | Path inventory |
| GET /api/v1/paths/:id/metrics | Telemetry window |
| GET /status | Public status object |
| GET /api/status.json | Machine-readable status |
Rate limit: 120 requests/minute per token. Exceeding it returns
429 with a Retry-After header.