Management-API

Die Management-API ist die Machine-to-Machine-Schnittstelle (M2M) von SupaCloud für Infrastructure-as-Code: das Bereitstellen von Workspaces, Projekten, Anmeldedaten, Secrets, Budgets, Tasks und Zeitplänen. Sie nutzt Bearer-Token-Authentifizierung und Desired-State-Semantik (idempotent).

Die Endpunkte liegen unter:

/api/management/v1/workspaces/{slug}/...

mit der Organisationsverwaltung (nicht Slug-bezogen) unter /api/management/v1/organizations*.

Die eingecheckten Spezifikationen liegen unter docs/openapi/management.json und docs/openapi/public.json; du kannst sie neu generieren mit:

cargo run -p supacloud-server --bin export_openapi -- --out docs/openapi

Autonomie & Kohärenz (v0.2.0, ADR 0045)

Die Autonomous Delivery Engine ergänzt drei Endpunkte pro Workspace, damit ein IaC-Consumer die Autonomie-Haltung lesen und seeden sowie prüfen kann, was auf einen Menschen wartet. Sie sind Slug-bezogen unter dem üblichen Workspace-Präfix.

Methode & Pfad	Beschreibung
`GET /api/management/v1/workspaces/{slug}/config/autonomy`	Liest die aufgelöste Autonomie-Konfiguration: das gespeicherte `set_level` (`0–100`) und `set_overrides` sowie das aufgelöste `effective_level`, `plan_ceiling`, `onboarding_cap` und die aufgelöste `policy` (Dispatch / Ask / Effort / Merge). Die Obergrenzen erklären, warum ein effektives Level unter das gesetzte Level begrenzt sein kann.
`PUT /api/management/v1/workspaces/{slug}/config/autonomy`	Setzt die Autonomie-Konfiguration. Body: `level` (`0–100`, vor dem Speichern auf die Plan-Obergrenze begrenzt) und optionale `overrides` — wird es weggelassen, bleiben die gespeicherten Overrides unverändert; `{}` löscht sie. Gibt dieselbe Ansicht wie das GET zurück.
`GET /api/management/v1/workspaces/{slug}/approvals?type=tool\|workflow`	Listet die ausstehenden menschlichen Entscheidungs-Gates auf. Es gibt keine einzelne Approvals-Tabelle: `type=tool` listet die interaktiven Tool-/Frage-/Visual-Gates, `type=workflow` die Workflow-Gates; `type` ist standardmäßig `tool`. Jedes Item trägt einen `source`-Diskriminator und die für diese Quelle relevanten Felder.

Siehe auch

Architektur