> ## Documentation Index > Fetch the complete documentation index at: https://docs.langdock.com/llms.txt > Use this file to discover all available pages before exploring further. # Governance API Übersicht > Lies den Review- und Compliance-Status jedes Agenten und schalte einen Agenten mit einer gespeicherten Begründung aus oder wieder ein. Mit der Governance API liest du den Review- und Compliance-Status der Agenten in deinem Workspace und schaltest einen Agenten mit einer gespeicherten Begründung aus oder wieder ein. Nutze sie, wenn ein Ticket-System oder ein anderes System auf diesen Status reagieren soll. Die API liefert keine Anweisungen des Agenten, keine Konversationen, keine Dokumente und keine Aktionsergebnisse. Konversationsinhalte und Tool-Ergebnisse holst du über die [Compliance API](https://docs.langdock.com/de/developer/compliance-api/export-tool-results.md). ## Bevor du startest * **Governance ist an**: Schalte **Governance aktivieren** unter [Einstellungen > Workspace > Produkte > Governance](https://app.langdock.com/settings/workspace/products/governance) ein. * **API-Key-Scope**: Ein Workspace-Admin legt einen Workspace-API-Key mit dem Scope `GOVERNANCE_API` unter [Einstellungen > Workspace > Produkte > API](https://app.langdock.com/settings/workspace/products/api) an. Im Formular heißt der Scope **Governance API** und er ist nur sichtbar, wenn Governance an ist. Beim Einschalten bestätigt der Admin, dass jeder mit dem Key den Governance-Status lesen und Agenten deaktivieren kann, auch ohne Zugriff auf Governance. Ein persönlicher API-Key kann diesen Scope nicht haben. Den Workspace nimmt die API aus dem API-Key. Du schickst keine Workspace-ID mit. ## Basis-URL ``` https://api.langdock.com ``` > [!WARNING] > > **Dedicated Deployments** > > Ersetze `api.langdock.com` durch `/api/public` in allen Anfragen. ## Authentifizierung ```bash theme={null} Authorization: Bearer YOUR_API_KEY ``` ## Verfügbare Endpoints | Methode | Endpoint | Beschreibung | | - | - | - | | `GET` | `/governance/v1/agents` | [Agenten auflisten](https://docs.langdock.com/de/developer/governance-api/list-agents.md) | | `GET` | `/governance/v1/agents/{agentId}` | [Agent abrufen](https://docs.langdock.com/de/developer/governance-api/get-agent.md) | | `PATCH` | `/governance/v1/agents/{agentId}/disable` | [Agent deaktivieren oder wieder aktivieren](https://docs.langdock.com/de/developer/governance-api/disable-agent.md) | Archivierte Agenten und Agenten-Templates sind nicht enthalten. Ist **Private Ressourcen in Governance ausblenden** aktiv, fehlen auch Agenten, die mit niemandem sonst geteilt sind. Abrufen und Deaktivieren liefern für diese Agenten `404`. ## Das Agenten-Objekt Auflisten, Abrufen und Deaktivieren liefern dasselbe Objekt. Die Liste steckt es in `agents`. Abrufen und Deaktivieren stecken ein Objekt in `agent`. | Feld | Beschreibung | | - | - | | `id` | UUID des Agenten | | `name` | Name des Agenten, oder null | | `description` | Beschreibung des Agenten, oder null | | `createdAt` | Zeitpunkt, zu dem der Agent erstellt wurde, oder null | | `updatedAt` | Zeitpunkt der letzten Änderung am Agenten, oder null | | `owner` | `{ id, name, email }` des aktuellen Besitzers, oder null. `name` kann null sein | | `verified` | `true`, wenn der Agent verifiziert ist | | `disabled` | `true`, wenn der Agent ausgeschaltet ist | | `disabledAt` | Zeitpunkt, zu dem er ausgeschaltet wurde, oder null | | `disabledReason` | Gespeicherte Begründung, solange er aus ist, oder null | | `reviewStatus` | Letzte Review-Entscheidung für die aktuelle Version | | `complianceStatus` | Zusammenfassung der erzwungenen Compliance-Regeln | | `complianceRules` | Letztes Ergebnis jeder erzwungenen Regel, die gelaufen ist | `reviewStatus` ist `pending_review`, wenn noch niemand entschieden hat. Nach einer Entscheidung ist der Wert `approved`, `internal_flag` oder `rejected`. `complianceStatus` hat einen dieser Werte: | Wert | Bedeutung | | - | - | | `high_risk` | Eine Regel mit Schwere `HIGH` oder `CRITICAL` ist `FAILING` | | `potentially` | Eine Regel mit Schwere `LOW` oder `MEDIUM` ist `FAILING`, und keine Regel mit Schwere `HIGH` oder `CRITICAL` ist `FAILING` | | `not_high_risk` | Jede Regel mit einem Urteil ist `PASSING` | | `not_checked` | Noch keine Regel hat ein Ergebnis `PASSING` oder `FAILING` | `RUNNING` und `ERROR` sind keine Urteile. Sie allein setzen einen Agenten nicht auf `high_risk` oder `potentially`. Jeder Eintrag in `complianceRules` hat `ruleId`, `ruleName`, `severity` (`LOW`, `MEDIUM`, `HIGH`, `CRITICAL`), `status` (`RUNNING`, `PASSING`, `FAILING`, `ERROR`), `reasoning` und `evaluatedAt`. Deaktivierte und gelöschte Regeln fehlen. Du bekommst nur das letzte Ergebnis jeder Regel. ## Abfragen Es gibt keinen Webhook. Frage [Agenten auflisten](https://docs.langdock.com/de/developer/governance-api/list-agents.md) regelmäßig ab. `updatedSince` filtert auf `updatedAt` des Agenten. Eine Compliance-Regel kann später fertig werden, ohne diesen Zeitpunkt zu ändern. Eine Abfrage, die nur `updatedSince` nutzt, kann eine Regel als `RUNNING` sehen und das spätere `FAILING` verpassen. * **Markierte Agenten.** Rufe die Liste mit `complianceStatus=high_risk,potentially` und ohne `updatedSince` ab. Merke dir `evaluatedAt` jeder Regel, damit du nur einmal reagierst. Die API liefert das letzte Ergebnis jeder Regel. Ein Ergebnis, das zwischen zwei Abfragen ersetzt wurde, ist danach nicht mehr da. * **Neue oder bearbeitete Agenten.** Setze `updatedSince` auf den Start deines letzten Laufs. Ist eine gelieferte Regel `RUNNING`, rufe [Agent abrufen](https://docs.langdock.com/de/developer/governance-api/get-agent.md) auf, bis keine Regel mehr `RUNNING` ist. ## Fehler | Status | Bedeutung | | - | - | | `400` | Ungültige Query, ungültiger Pfad oder ungültiger Body. Die Meldung ist `Invalid query parameters`, `Invalid path parameters` oder `Invalid request data` | | `401` | API-Key fehlt oder ist ungültig | | `403` | Dem Key fehlt `GOVERNANCE_API`, oder Governance ist aus. Wenn Governance aus ist, lautet die Meldung `Governance is not enabled for this workspace` | | `404` | `Agent not found`. Der Agent ist in diesem Workspace nicht verfügbar | | `429` | Mehr als 500 Anfragen pro Minute für diesen Workspace und diesen API-Key. Ein Token-Limit gibt es nicht | | `500` | Interner Serverfehler | > [!NOTE] > > Langdock blockiert bewusst Browser-basierte Anfragen, um deinen API-Schlüssel zu schützen und die Sicherheit deiner Anwendungen zu gewährleisten. Weitere Informationen findest du in unserem Guide zu [Best Practices für API-Schlüssel](https://docs.langdock.com/de/admin/ai-adoption-and-rollout/best-practices/api-key-best-practices.md). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.