# Magentic LangGraph Control Plane API (v1.0.0) Auth: None (Open Local API) | OpenAPI: /openapi.json | Swagger UI: /docs ## Endpoints (67) - `GET /` [dashboard] — Living Brain Sovereign 12-Grid Dashboard - `GET /api` [Discovery & Health] — Self-describing API endpoint catalog (JSON or ?format=md) - `POST /api/ast/file` [AST & Vertical Slices] — Parse deterministic AST for a single file - `POST /api/ast/scan` [AST & Vertical Slices] — Scan repository AST and group into vertical slices - `POST /api/brain/map` [Internal Brain & Living Knowledge Graph] — Map repository AST and identify DRY anti-patterns - `POST /api/brain/sync-slice` [Internal Brain & Living Knowledge Graph] — Sync SLICE.md living spec to Postgres & Redis - `GET /api/brain/{repo}/card/{file_path}` [Internal Brain & Living Knowledge Graph] — Retrieve localized Graph Card for AI or UI - `GET /api/brain/{repo}/commits` [Internal Brain & Living Knowledge Graph] — Retrieve latest 10 git commits from Brain - `GET /api/brain/{repo}/dry-violations` [Internal Brain & Living Knowledge Graph] — List detected DRY smells and circular dependencies - `GET /api/brain/{repo}/graph` [Internal Brain & Living Knowledge Graph] — Retrieve repository dependency graph - `GET /api/brain/{repo}/logs` [Internal Brain & Living Knowledge Graph] — Retrieve system & swarm event logs from PostgreSQL - `GET /api/brain/{repo}/remote` [Internal Brain & Living Knowledge Graph] — Inspect git remote and tenant sovereignty boundary - `GET /api/cluster/migration/plan` [Cluster Mesh & Migration] — Retrieve cluster-1 Migration Roadmap - `POST /api/cluster/migration/stage` [Cluster Mesh & Migration] — Transition Migration Stage or Weight - `GET /api/cluster/topology` [Cluster Mesh & Migration] — Inspect AI Compute Nodes Topology - `GET /api/dashboard/cards` [dashboard] — List registered micro-frontend slice cards - `GET /api/dashboard/layout` [dashboard] — Retrieve server-driven 12-grid layout from Redis - `POST /api/dashboard/layout` [dashboard] — Update 12-grid card order and spans in Redis - `GET /api/design/tokens` [Design System & UI Primitives] — Get Centralized CSS Design Tokens - `POST /api/engines/chat` [AI Engines & VRAM] — Invoke Tier-1 vLLM or Tier-2 Ollama - `POST /api/engines/embeddings` [AI Engines & VRAM] — Generate 768d/1024d semantic vector embedding - `GET /api/engines/headroom` [AI Engines & VRAM] — Get live GPU VRAM headroom and safe parallel vLLM slots - `POST /api/engines/vram/evict` [AI Engines & VRAM] — Arbitrate GPU VRAM between vLLM, Ollama, and ComfyUI - `GET /api/graphs` [Sovereign LangGraph Engine] — List all sovereign StateGraphs in the cluster - `GET /api/graphs/{graph_id}` [Sovereign LangGraph Engine] — Get graph metadata and Mermaid diagram - `POST /api/graphs/{graph_id}/invoke` [Sovereign LangGraph Engine] — Execute StateGraph API-first - `GET /api/graphs/{graph_id}/stream` [Sovereign LangGraph Engine] — Stream live graph node transitions via SSE - `GET /api/health` [Discovery & Health] — Check local Redis connectivity and Sovereign GPU headroom - `POST /api/pipeline/history/clear` [Pipeline Runtime UI] — Clear completed pipeline runs history in Redis - `GET /api/pipeline/state` [Pipeline Runtime UI] — Get live :4321-compatible pipeline & worker thread state - `GET /api/pipeline/stream` [Pipeline Runtime UI] — Live SSE stream of Redis brain:telemetry & thread progress - `GET /api/redis/stream` [Redis Reactive Streams] — Multiplexed SSE stream pushing updates for requested Redis keys - `POST /api/reports/generate` [reports] — Generate Data-Grounded Executive Report with ComfyUI Media & Charts - `GET /api/reports/{report_id}/docx` [reports] — Download Generated DOCX Executive Dossier - `GET /api/reports/{report_id}/html` [reports] — View Compiled HTML Executive Dossier - `GET /api/reports/{report_id}/pdf` [reports] — Download Generated PDF Executive Dossier - `POST /api/sanitizer/run` [Estate Sanitizer] — Dispatch LangGraph Sanitizer Swarm - `POST /api/sanitizer/scan` [Estate Sanitizer] — Discover Softronic Legacy Artifacts - `GET /api/sanitizer/threads/{thread_id}/state` [Estate Sanitizer] — Fetch LangGraph State Snapshot for Sanitizer Thread - `GET /api/sanitizer/topology` [Estate Sanitizer] — Inspect Sanitizer StateGraph Topology & Mermaid Diagram - `GET /api/scanner/latest` [Secret Scanner] — Get Latest Scan - `GET /api/scanner/report/docx` [Secret Scanner] — Download Latest Docx - `GET /api/scanner/report/pdf` [Secret Scanner] — Download Latest Pdf - `POST /api/scanner/run` [Secret Scanner] — Trigger Secret Scan - `POST /api/swarm/factory/build` [Code Swarm (Coder-Reviewer)] — Execute full multi-file Slice Factory swarm - `GET /api/swarm/latest` [Code Swarm (Coder-Reviewer)] — Get Latest Swarm Run - `POST /api/swarm/run` [Code Swarm (Coder-Reviewer)] — Run Code Swarm - `GET /api/swarm/{thread_id}` [Code Swarm (Coder-Reviewer)] — Get Swarm Run By Id - `GET /api/threads` [LangGraph Threads & Runs] — List recent LangGraph threads and Redis progress - `POST /api/threads` [LangGraph Threads & Runs] — Create a new stateful LangGraph thread - `GET /api/threads/active` [LangGraph Threads & Runs] — Read live :4321-compatible brain:vectorization:active Redis telemetry - `GET /api/threads/graph/topology` [LangGraph Threads & Runs] — Get compiled LangGraph StateGraph nodes, edges, and Mermaid diagram - `GET /api/threads/{thread_id}/history` [LangGraph Threads & Runs] — List LangGraph Redis checkpoint history for time-travel inspection - `GET /api/threads/{thread_id}/progress` [LangGraph Threads & Runs] — Get live WorkerThreadState[] progress for a thread from local Redis - `POST /api/threads/{thread_id}/runs` [LangGraph Threads & Runs] — Execute or dispatch a LangGraph job (AST + Vectorize + Parallel Send() Swarm or ReAct Agent) - `POST /api/threads/{thread_id}/runs/stream` [LangGraph Threads & Runs] — Stream LangGraph super-step updates & worker slots via SSE - `GET /api/threads/{thread_id}/state` [LangGraph Threads & Runs] — Inspect persisted LangGraph thread state - `POST /api/vectors/index` [Vectorization & Semantic Search] — Vectorize repository across parallel worker threads - `POST /api/vectors/search` [Vectorization & Semantic Search] — Semantic search over indexed repository files - `POST /api/vram/evict` [GPU VRAM & Graph Arbitration] — Arbitrate VRAM via compiled LangGraph - `GET /api/vram/snapshot` [GPU VRAM & Graph Arbitration] — Live GPU VRAM and engine allocations - `GET /api/vram/stream` [GPU VRAM & Graph Arbitration] — SSE stream of real-time GPU VRAM events - `GET /brain` [Internal Brain & Living Knowledge Graph] — Standalone Full Page Knowledge Graph Explorer - `GET /brain/card` [Internal Brain & Living Knowledge Graph] — Embeddable UI Component Card snippet - `GET /dashboard` [dashboard] — Living Brain Dashboard Alias - `GET /design-system` [Design System & UI Primitives] — Standalone Design System Showcase View - `GET /design-system/card` [Design System & UI Primitives] — Embeddable UI Component Card snippet