​
Admin API

Administrative endpoints for platform setup, onboarding, and infrastructure provisioning.

​
Admin Status

Check the overall platform health: 
GET /api/v1/admin/status

{
  "setup_complete": true,
  "kubernetes_connected": true,
  "components": {
    "k3s": "installed",
    "kubevirt": "installed",
    "storage": "installed",
    "metrics": "installed",
    "prometheus": "installed",
    "cloudnativepg": "installed",
    "registry": "installed",
    "coredns": "installed",
    "object_storage": "installed"
  }
}

​
Setup Steps

​
List Setup Steps

GET /api/v1/admin/setup

[
  {
    "id": "k3s",
    "name": "K3s Cluster",
    "description": "Lightweight Kubernetes distribution",
    "status": "installed",
    "order": 1
  },
  {
    "id": "kubevirt",
    "name": "KubeVirt",
    "description": "Virtual machine management",
    "status": "not_installed",
    "order": 2
  }
]

​
Run All Setup Steps

Install all infrastructure components at once: 
POST /api/v1/admin/setup/run-all

​
Check All Steps

Verify the installation status of all components: 
POST /api/v1/admin/setup/check

​
Run a Specific Step

POST /api/v1/admin/setup/{step}/run
Available steps:
Step IDComponentDescription
k3sK3sKubernetes cluster
kubevirtKubeVirtVM management
storage_classStoragePV provisioner
metrics_serverMetricsResource metrics
prometheusPrometheusMonitoring
cloudnativepgCloudNativePGPostgreSQL operator
registryRegistryContainer image storage
corednsCoreDNSDNS resolution
object_storageObject StorageS3-compatible storage

​
Onboarding

​
Get Onboarding Status

GET /api/v1/onboarding/status

{
  "completed": false,
  "steps": {
    "setup_infrastructure": true,
    "create_first_project": false,
    "deploy_first_resource": false,
    "configure_networking": false
  }
}

​
Update Onboarding Status

PATCH /api/v1/onboarding/status

​
Complete Onboarding

POST /api/v1/onboarding/complete

​
Dashboard Stats

Get summary statistics for the dashboard: 
GET /api/v1/dashboard/stats

{
  "droplets": { "total": 5, "running": 4, "off": 1 },
  "apps": { "total": 12, "running": 10, "failed": 2 },
  "databases": { "total": 3, "running": 3 },
  "volumes": { "total": 8, "attached": 5, "available": 3 },
  "cpu_usage_percent": 35.2,
  "memory_usage_percent": 48.7
}

​
Global Events

List platform-wide events: 
GET /api/v1/events

​
Settings

​
Get Settings

GET /api/v1/settings

​
Update Settings

PATCH /api/v1/settings