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

EndpointPurpose
GET /api/v1/whoamiToken identity and quota
POST /api/v1/instancesProvision
GET /api/v1/instancesList
DELETE /api/v1/instances/:idDestroy
EndpointPurpose
GET /api/v1/pathsPath inventory
GET /api/v1/paths/:id/metricsTelemetry window
GET /statusPublic status object
GET /api/status.jsonMachine-readable status
Rate limit: 120 requests/minute per token. Exceeding it returns 429 with a Retry-After header.