sympozium-apiserver
At a glance
| Field | Value |
|---|---|
| Listen port | 8080 |
| Owner | sympozium |
| Default auth | bearer-static |
| Public hostnames | ui.sympozium.opstech.dev |
| Service-level side effects | mutates-k8s-crds |
| Declared paths | 54 |
| Scanned routes | 0 |
| Total paths emitted | 54 |
Event-flow diagram
mmdc render failed: Command failed: npx --no-install mmdc -i "/home/runner/_work/opstech-site/opstech-site/docs-site/.mermaid-cache/9db413e5bc863125.mmd" -o "/home/runner/_work/opstech-site/opstech-site/docs-site/.mermaid-cache/9db413e5bc863125.svg" -b transparent 2>&1
Per-tag flow diagrams
This service has more than 30 operations; one diagram per OpenAPI tag is emitted, plus the overview above. Use the tab(s) below to drill into a specific tag.
agent-sandbox
mmdc render failed: Command failed: npx --no-install mmdc -i "/home/runner/_work/opstech-site/opstech-site/docs-site/.mermaid-cache/56a4bd35e1c108bb.mmd" -o "/home/runner/_work/opstech-site/opstech-site/docs-site/.mermaid-cache/56a4bd35e1c108bb.svg" -b transparent 2>&1
agents
mmdc render failed: Command failed: npx --no-install mmdc -i "/home/runner/_work/opstech-site/opstech-site/docs-site/.mermaid-cache/e9ffb449333745a9.mmd" -o "/home/runner/_work/opstech-site/opstech-site/docs-site/.mermaid-cache/e9ffb449333745a9.svg" -b transparent 2>&1
capabilities
mmdc render failed: Command failed: npx --no-install mmdc -i "/home/runner/_work/opstech-site/opstech-site/docs-site/.mermaid-cache/9ef9937435a13a6e.mmd" -o "/home/runner/_work/opstech-site/opstech-site/docs-site/.mermaid-cache/9ef9937435a13a6e.svg" -b transparent 2>&1
cluster
mmdc render failed: Command failed: npx --no-install mmdc -i "/home/runner/_work/opstech-site/opstech-site/docs-site/.mermaid-cache/586cbdd9603fe234.mmd" -o "/home/runner/_work/opstech-site/opstech-site/docs-site/.mermaid-cache/586cbdd9603fe234.svg" -b transparent 2>&1
density
mmdc render failed: Command failed: npx --no-install mmdc -i "/home/runner/_work/opstech-site/opstech-site/docs-site/.mermaid-cache/5a5fe08441cc2385.mmd" -o "/home/runner/_work/opstech-site/opstech-site/docs-site/.mermaid-cache/5a5fe08441cc2385.svg" -b transparent 2>&1
ensembles
mmdc render failed: Command failed: npx --no-install mmdc -i "/home/runner/_work/opstech-site/opstech-site/docs-site/.mermaid-cache/3f211fbff183cdfe.mmd" -o "/home/runner/_work/opstech-site/opstech-site/docs-site/.mermaid-cache/3f211fbff183cdfe.svg" -b transparent 2>&1
gateway
mmdc render failed: Command failed: npx --no-install mmdc -i "/home/runner/_work/opstech-site/opstech-site/docs-site/.mermaid-cache/e60ad7ac70b7d9dc.mmd" -o "/home/runner/_work/opstech-site/opstech-site/docs-site/.mermaid-cache/e60ad7ac70b7d9dc.svg" -b transparent 2>&1
health
mmdc render failed: Command failed: npx --no-install mmdc -i "/home/runner/_work/opstech-site/opstech-site/docs-site/.mermaid-cache/dc65a64ad69afe85.mmd" -o "/home/runner/_work/opstech-site/opstech-site/docs-site/.mermaid-cache/dc65a64ad69afe85.svg" -b transparent 2>&1
mcpservers
mmdc render failed: Command failed: npx --no-install mmdc -i "/home/runner/_work/opstech-site/opstech-site/docs-site/.mermaid-cache/ab995af2c7ce8849.mmd" -o "/home/runner/_work/opstech-site/opstech-site/docs-site/.mermaid-cache/ab995af2c7ce8849.svg" -b transparent 2>&1
models
mmdc render failed: Command failed: npx --no-install mmdc -i "/home/runner/_work/opstech-site/opstech-site/docs-site/.mermaid-cache/18c57ed698da8d8a.mmd" -o "/home/runner/_work/opstech-site/opstech-site/docs-site/.mermaid-cache/18c57ed698da8d8a.svg" -b transparent 2>&1
namespaces
mmdc render failed: Command failed: npx --no-install mmdc -i "/home/runner/_work/opstech-site/opstech-site/docs-site/.mermaid-cache/57fc16a95c33fd49.mmd" -o "/home/runner/_work/opstech-site/opstech-site/docs-site/.mermaid-cache/57fc16a95c33fd49.svg" -b transparent 2>&1
nodes
mmdc render failed: Command failed: npx --no-install mmdc -i "/home/runner/_work/opstech-site/opstech-site/docs-site/.mermaid-cache/f7431ae84e090616.mmd" -o "/home/runner/_work/opstech-site/opstech-site/docs-site/.mermaid-cache/f7431ae84e090616.svg" -b transparent 2>&1
observability
mmdc render failed: Command failed: npx --no-install mmdc -i "/home/runner/_work/opstech-site/opstech-site/docs-site/.mermaid-cache/fce0d114ea59096f.mmd" -o "/home/runner/_work/opstech-site/opstech-site/docs-site/.mermaid-cache/fce0d114ea59096f.svg" -b transparent 2>&1
pods
mmdc render failed: Command failed: npx --no-install mmdc -i "/home/runner/_work/opstech-site/opstech-site/docs-site/.mermaid-cache/0a08c694270c6112.mmd" -o "/home/runner/_work/opstech-site/opstech-site/docs-site/.mermaid-cache/0a08c694270c6112.svg" -b transparent 2>&1
policies
mmdc render failed: Command failed: npx --no-install mmdc -i "/home/runner/_work/opstech-site/opstech-site/docs-site/.mermaid-cache/f99e0de8fafc304f.mmd" -o "/home/runner/_work/opstech-site/opstech-site/docs-site/.mermaid-cache/f99e0de8fafc304f.svg" -b transparent 2>&1
providers
mmdc render failed: Command failed: npx --no-install mmdc -i "/home/runner/_work/opstech-site/opstech-site/docs-site/.mermaid-cache/ee9f30ad6ec8cafb.mmd" -o "/home/runner/_work/opstech-site/opstech-site/docs-site/.mermaid-cache/ee9f30ad6ec8cafb.svg" -b transparent 2>&1
runs
mmdc render failed: Command failed: npx --no-install mmdc -i "/home/runner/_work/opstech-site/opstech-site/docs-site/.mermaid-cache/326cd1eaeb8ef473.mmd" -o "/home/runner/_work/opstech-site/opstech-site/docs-site/.mermaid-cache/326cd1eaeb8ef473.svg" -b transparent 2>&1
schedules
mmdc render failed: Command failed: npx --no-install mmdc -i "/home/runner/_work/opstech-site/opstech-site/docs-site/.mermaid-cache/1ddd533f982b78d6.mmd" -o "/home/runner/_work/opstech-site/opstech-site/docs-site/.mermaid-cache/1ddd533f982b78d6.svg" -b transparent 2>&1
skills
mmdc render failed: Command failed: npx --no-install mmdc -i "/home/runner/_work/opstech-site/opstech-site/docs-site/.mermaid-cache/42e5a0fb51c94e1c.mmd" -o "/home/runner/_work/opstech-site/opstech-site/docs-site/.mermaid-cache/42e5a0fb51c94e1c.svg" -b transparent 2>&1
stream
mmdc render failed: Command failed: npx --no-install mmdc -i "/home/runner/_work/opstech-site/opstech-site/docs-site/.mermaid-cache/15581d4f9088cd1b.mmd" -o "/home/runner/_work/opstech-site/opstech-site/docs-site/.mermaid-cache/15581d4f9088cd1b.svg" -b transparent 2>&1
Endpoints
| Method | Path | Summary | Side effects | Status |
|---|---|---|---|---|
DELETE | /api/v1/agent-sandbox/install | Uninstall all Agent Sandbox CRDs (group agents.x-k8s.io) | mutates-k8s-crd | verified-from-code |
POST | /api/v1/agent-sandbox/install | Install Agent Sandbox CRDs from kubernetes-sigs release manifests | mutates-k8s-crd | verified-from-code |
GET | /api/v1/agents | List Agent CRDs in a namespace | read-k8sread-only | verified-from-code |
POST | /api/v1/agents | Create an Agent | mutates-k8s-crdread-k8s | verified-from-code |
DELETE | /api/v1/agents/{name} | Delete an Agent | mutates-k8s-crd | verified-from-code |
GET | /api/v1/agents/{name} | Get a single Agent | read-k8sread-only | verified-from-code |
PATCH | /api/v1/agents/{name} | Patch an Agent (web-endpoint, lifecycle, approval gate) | mutates-k8s-crdread-k8s | verified-from-code |
GET | /api/v1/agents/{name}/web-endpoint | Web-endpoint exposure status for an Agent | read-k8sread-only | verified-from-code |
GET | /api/v1/canary | Read system canary config + most recent run health | read-k8sread-only | verified-from-code |
PATCH | /api/v1/canary | Patch the canary spec (auto-creates SympoziumConfig if absent) | mutates-config-crdread-k8s | verified-from-code |
GET | /api/v1/capabilities | Optional feature availability (currently: agent-sandbox CRDs) | read-k8sread-only | verified-from-code |
GET | /api/v1/catalog | Aggregated catalog — what models the cluster can run | read-only | verified-from-code |
GET | /api/v1/cluster | Cluster summary — node/namespace/pod counts and version | read-k8sread-only | verified-from-code |
GET | /api/v1/density/cost | Correlate placed Models with fitness data for cost attribution | read-k8sread-only | verified-from-code |
GET | /api/v1/density/installed-models | List installed models per node (as detected by runtimes) | read-only | verified-from-code |
GET | /api/v1/density/nodes | List nodes with llmfit fitness data | read-only | verified-from-code |
GET | /api/v1/density/nodes/{name} | Get fitness data for a single node | read-only | verified-from-code |
GET | /api/v1/density/query | Rank nodes by fitness for a given model | read-only | verified-from-code |
GET | /api/v1/density/runtimes | List per-node runtimes (Ollama, llama.cpp, vLLM, ...) detected by llmfit | read-only | verified-from-code |
POST | /api/v1/density/simulate | Simulate placing a model and report per-node impact | read-only | verified-from-code |
GET | /api/v1/ensembles | List Ensemble items (excludes the system-canary) | read-k8sread-only | verified-from-code |
POST | /api/v1/ensembles | Create an Ensemble from scratch | mutates-k8s-crd | verified-from-code |
DELETE | /api/v1/ensembles/{name} | Delete an Ensemble | mutates-k8s-crd | verified-from-code |
GET | /api/v1/ensembles/{name} | Get an Ensemble | read-k8sread-only | verified-from-code |
PATCH | /api/v1/ensembles/{name} | Patch an Ensemble (provider, model, channels, personas, etc.) | mutates-k8s-crdread-k8s | verified-from-code |
POST | /api/v1/ensembles/{name}/clone | Clone an Ensemble (strips activation state and auth) | mutates-k8s-crdread-k8s | verified-from-code |
GET | /api/v1/ensembles/{name}/shared-memory | Proxy to the ensemble shared-memory server's /list endpoint | read-k8sread-only | verified-from-code |
POST | /api/v1/ensembles/{name}/stimulus/trigger | Manually fire the Ensemble's stimulus relationship | mutates-k8s-crdread-k8s | verified-from-code |
POST | /api/v1/ensembles/install-defaults | Copy default Ensembles from sympozium-system into a namespace | mutates-k8s-crdread-k8s | verified-from-code |
DELETE | /api/v1/gateway | Delete the SympoziumConfig singleton | mutates-config-crd | verified-from-code |
GET | /api/v1/gateway | Read SympoziumConfig.gateway (singleton) | read-k8sread-only | verified-from-code |
PATCH | /api/v1/gateway | Patch the SympoziumConfig.gateway block | mutates-config-crdread-k8s | verified-from-code |
POST | /api/v1/gateway | Create the SympoziumConfig singleton with gateway spec | mutates-config-crd | verified-from-code |
GET | /api/v1/gateway/metrics | Time-bucketed gateway request metrics derived from web-proxy AgentRuns | read-k8sread-only | verified-from-code |
GET | /api/v1/mcpservers | List MCPServer items (cluster-wide) | read-k8sread-only | verified-from-code |
POST | /api/v1/mcpservers | Create an MCPServer | mutates-k8s-crd | verified-from-code |
DELETE | /api/v1/mcpservers/{name} | Delete an MCPServer | mutates-k8s-crd | verified-from-code |
GET | /api/v1/mcpservers/{name} | Get an MCPServer | read-k8sread-only | verified-from-code |
PATCH | /api/v1/mcpservers/{name} | Patch an MCPServer (transport, URL, allow/deny lists, timeout) | mutates-k8s-crdread-k8s | verified-from-code |
GET | /api/v1/mcpservers/{name}/auth/status | Check whether an MCPServer's token Secret is populated | read-k8sread-only | verified-from-code |
POST | /api/v1/mcpservers/{name}/auth/token | Store a bearer/PAT token for an MCPServer (key GITHUB_PERSONAL_ACCESS_TOKEN) | mutates-k8s-crd | verified-from-code |
POST | /api/v1/mcpservers/install-defaults | Copy default MCPServers from sympozium-system into a namespace | mutates-k8s-crdread-k8s | verified-from-code |
GET | /api/v1/models | List Model CRDs (optionally namespaced) | read-k8sread-only | verified-from-code |
POST | /api/v1/models | Create a Model (cluster-local inference server) | mutates-k8s-crd | verified-from-code |
DELETE | /api/v1/models/{name} | Delete a Model | mutates-k8s-crd | verified-from-code |
GET | /api/v1/models/{name} | Get a Model by name | read-k8sread-only | verified-from-code |
GET | /api/v1/namespaces | List namespace names cluster-wide | read-k8sread-only | verified-from-code |
GET | /api/v1/nodes | List Kubernetes nodes (Ready status + labels) | read-k8sread-only | verified-from-code |
GET | /api/v1/observability/metrics | Aggregated AgentRun metrics + collector probe | read-k8sread-only | verified-from-code |
GET | /api/v1/pods | List pods in a namespace with derived restart counts and instance refs | read-k8sread-only | verified-from-code |
GET | /api/v1/pods/{name}/logs | Tail the last 200 log lines of a pod | read-k8sread-only | verified-from-code |
GET | /api/v1/policies | List SympoziumPolicy CRDs (cluster-wide) | read-k8sread-only | verified-from-code |
GET | /api/v1/policies/{name} | Get a SympoziumPolicy by name | read-k8sread-only | verified-from-code |
POST | /api/v1/providers/bedrock/models | List AWS Bedrock foundation models with TEXT output | calls-bedrock | verified-from-code |
GET | /api/v1/providers/models | Proxy a `/v1/models` (or Ollama `/api/tags`) listing | calls-llm-providerread-only | verified-from-code |
GET | /api/v1/providers/nodes | Nodes annotated by node-probe DaemonSet with inference providers | read-k8sread-only | verified-from-code |
GET | /api/v1/runs | List AgentRun items in a namespace | read-k8sread-only | verified-from-code |
POST | /api/v1/runs | Create an AgentRun | mutates-k8s-crdread-k8s | verified-from-code |
DELETE | /api/v1/runs/{name} | Delete an AgentRun | mutates-k8s-crd | verified-from-code |
GET | /api/v1/runs/{name} | Get a single AgentRun | read-k8sread-only | verified-from-code |
POST | /api/v1/runs/{name}/gate-verdict | Approve, reject, or rewrite a gated AgentRun | mutates-k8s-crdread-k8s | verified-from-code |
GET | /api/v1/runs/{name}/telemetry | Run telemetry summary | read-k8sread-only | verified-from-code |
GET | /api/v1/schedules | List SympoziumSchedule items in a namespace | read-k8sread-only | verified-from-code |
POST | /api/v1/schedules | Create a SympoziumSchedule | mutates-k8s-crd | verified-from-code |
DELETE | /api/v1/schedules/{name} | Delete a SympoziumSchedule | mutates-k8s-crd | verified-from-code |
GET | /api/v1/schedules/{name} | Get a SympoziumSchedule by name | read-k8sread-only | verified-from-code |
PATCH | /api/v1/schedules/{name} | Patch a SympoziumSchedule (cron, task, suspend, concurrency) | mutates-k8s-crdread-k8s | verified-from-code |
GET | /api/v1/skills | List SkillPack CRDs (cluster-wide) | read-k8sread-only | verified-from-code |
GET | /api/v1/skills/{name} | Get a SkillPack by name | read-k8sread-only | verified-from-code |
GET | /api/v1/skills/github-gitops/auth/status | Check whether the github-gitops PAT is stored | read-k8sread-only | verified-from-code |
POST | /api/v1/skills/github-gitops/auth/token | Store a GitHub PAT for the github-gitops skill | mutates-k8s-crd | verified-from-code |
GET | /healthz | Liveness probe | read-only | verified-from-code |
GET | /metrics | Prometheus metrics for the apiserver process | read-only | verified-from-code |
GET | /readyz | Readiness probe | read-only | verified-from-code |
GET | /ws/stream | WebSocket stream of agent stream-chunk events | read-only | verified-from-code |
Source links
- OpenAPI fragment (raw):
tools/api-inventory/openapi/sympozium-apiserver.yaml - Diagram source (Mermaid):
tools/api-inventory/diagrams/sympozium-apiserver.mmd - Spec governing the inventory:
specs/platform-api-inventory/