> ## 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.

# Agent deaktivieren oder wieder aktivieren

> Schalte einen Agenten mit einer gespeicherten Begründung aus oder wieder ein.

Schaltet einen Agenten als Governance-Aktion aus oder wieder ein. Ein deaktivierter Agent kann nicht verwendet werden, bis du ihn wieder einschaltest. Die Antwort ist der aktualisierte Agent, mit denselben Feldern wie bei [Agent abrufen](https://docs.langdock.com/de/developer/governance-api/get-agent.md).

Die [Agent Deaktivieren API](https://docs.langdock.com/de/developer/agents-api/agent-disable.md) ist ein anderer Aufruf. Sie nutzt den Scope `ASSISTANT_API` und erreicht nur einen Agenten, den dieser Key bearbeiten darf. Dieser Aufruf verlangt nicht, dass der Agent mit dem Key geteilt ist.

## Basis-URL

```
https://api.langdock.com/governance/v1/agents/{agentId}/disable
```

> [!WARNING]
>
> **Dedicated Deployments**
>
> Ersetze `api.langdock.com` durch `<your-deployment-url>/api/public` in allen Anfragen.

## Voraussetzungen

* **API-Key** mit dem Scope `GOVERNANCE_API`
* **Governance aktivieren** ist an
* `agentId` ist die UUID des Agenten

## Request Body

| Feld | Typ | Pflicht | Beschreibung |
| - | - | - | - |
| `disabled` | boolean | Ja | `true` schaltet den Agenten aus, `false` schaltet ihn wieder ein |
| `disabledReason` | string | Nein | Bis zu 500 Zeichen, gespeichert solange der Agent aus ist |

Leerzeichen am Anfang und Ende von `disabledReason` werden entfernt. Eine leere Begründung wird als null gespeichert. Alle, die den Agenten sehen können, sehen die Begründung am Badge **Deaktiviert**. Inhaber und Bearbeitende sehen sie zusätzlich im Agenten-Editor.

Wenn du den Agenten wieder einschaltest, werden `disabledReason` und `disabledAt` gelöscht, auch wenn die Anfrage noch eine Begründung mitschickt. Der Nutzer des API-Keys wird als die Person gespeichert, die den Agenten deaktiviert hat. Die Antwort enthält diese ID nicht.

```bash theme={null}
curl -X PATCH "https://api.langdock.com/governance/v1/agents/2f1c7b9e-5d7a-4f2a-9d2e-5b2c0e8f1a3b/disable" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "disabled": true, "disabledReason": "ServiceNow INC0012345: failed compliance review" }'
```

```bash theme={null}
curl -X PATCH "https://api.langdock.com/governance/v1/agents/2f1c7b9e-5d7a-4f2a-9d2e-5b2c0e8f1a3b/disable" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "disabled": false }'
```

## Verhalten

* **Ausgeschaltet:** `disabled` ist `true`, `disabledReason` ist die gespeicherte Begründung und `disabledAt` ist gesetzt.
* **Wieder eingeschaltet:** `disabled` ist `false`, `disabledReason` und `disabledAt` sind null.
* **Agent nicht verfügbar?** Liefert `404` mit der Meldung `Agent not found`.
* **`disabled` fehlt, oder die Begründung ist länger als 500 Zeichen?** Liefert `400`.

> [!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.