REST API Reference
All endpoints under /api/v1.
Cluster
| Method | Endpoint | Description |
|---|---|---|
| GET | /clusters | List all kubeconfig contexts |
| POST | /clusters/switch | Switch active cluster |
| GET | /cluster/overview | Full cluster summary with counts, CPU/memory, health, events, workloads |
| GET | /cluster/permissions | Probed RBAC permissions per resource type |
Resources
| Method | Endpoint | Description |
|---|---|---|
| GET | /resources/:type | List with pagination (?limit=50), filtering (?namespace=, ?search=, ?status=) |
| GET | /resources/:type/:ns/:name | Detail with metrics injection |
| GET | /resources/:type/:ns/:name/yaml | Raw YAML (secrets redacted, managedFields stripped) |
| GET | /resources/pods/:ns/:name/logs | Pod logs (?container=, ?tailLines=100) |
| GET | /resources/:workload/:ns/:name/pods | Pods owned by deployment/statefulset/daemonset/job |
| GET | /resources/deployments/:ns/:name/history | Revision history via ReplicaSets |
Other
| Method | Endpoint | Description |
|---|---|---|
| GET | /topology | Full topology graph (nodes + edges) |
| GET | /insights | Active insights (?severity=critical,warning) |
| GET | /events | Events (?type=Warning, ?involvedName=, ?involvedKind=) |
| WS | /ws | WebSocket for real-time updates |