Skip to content

Dashboard API

hypersdk edited this page Aug 7, 2026 · 1 revision

Dashboard API

Script Mission Control without the UI. The page is a thin JSON client.

Deep: Tutorial 10 § API.

Auth

When DASHBOARD_PASSWORD is set:

curl -c jar -X POST http://localhost:8080/api/login \
  -H 'Content-Type: application/json' \
  -d '{"username":"admin","password":"…"}'
curl -b jar http://localhost:8080/api/dashboard/overview

/health stays open. Enterprise tokens: Enterprise.

Endpoints

Endpoint Returns
GET /api/dashboard/overview Banner, namespace, workloads, latest run, version
GET /api/dashboard/pods · …/pods/{name}/logs?lines=&container= Pod health · log tail
DELETE /api/dashboard/pods/{name} Restart (delete) pod
GET /api/dashboard/events · /api/dashboard/tests Events · per-test health
GET /api/dashboard/runs?limit= · /videos · /videos.zip History · videos
POST /api/dashboard/jobs {kind, params} Start job
GET /api/dashboard/jobs/status Live status
POST /api/dashboard/jobs/cancel · /rerun Stop / rerun
GET /api/dashboard/jobs/report.{csv,html,pdf} Last job report
GET/POST/DELETE /api/dashboard/schedules[/{id}] Recurring monitors
POST /api/login · /api/logout Session
GET /reports/…, /screenshots/… Static artifacts
POST /webhook/github HMAC GitHub events — Webhooks

Read endpoints degrade with "available": false when no cluster is reachable (instead of hard erroring).

Start a job

curl -b jar -X POST http://localhost:8080/api/dashboard/jobs \
  -H 'Content-Type: application/json' \
  -d '{"kind":"smoke","params":{"grep":"@smoke"}}'

Kinds mirror Action cards (flow, vitals, route-sweep, api-test, …). Durable /api/v2/jobs: Enterprise.

Related: Using the Dashboard · Schedules and Findings · Admin Basics

Clone this wiki locally