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

> Aktiviere oder deaktiviere einen Agenten programmatisch

<Info>
  **⚠️ Du nutzt unsere API in einem Dedicated Deployment?** Ersetze einfach `api.langdock.com` durch die Base URL deines Deployments: **`<deployment-url>/api/public`**
</Info>

<Info>
  Dies ist die neue Agents API mit nativer Vercel AI SDK Kompatibilität. Wenn du die veraltete Assistants API verwendest, siehe den [Migrations-Guide](/de/developer/assistants-api/assistant-to-agent-migration).
</Info>

Aktiviert oder deaktiviert einen Agenten in deinem Workspace. Deaktivierte Agenten können von Workspace-Mitgliedern nicht verwendet werden, bis sie wieder aktiviert werden.

<Warning>
  Dies ist eine administrative Aktion. Nur Workspace-Admins oder Nutzer mit entsprechenden Berechtigungen können Agenten aktivieren/deaktivieren.
</Warning>

## Anwendungsfälle

* **Temporär deaktivieren** eines Agenten, der Wartung oder Updates benötigt
* **Wieder aktivieren** eines zuvor deaktivierten Agenten
* **Verfügbarkeit steuern** während Rollouts oder Tests

## Request-Parameter

| Parameter  | Typ     | Erforderlich | Beschreibung                                      |
| ---------- | ------- | ------------ | ------------------------------------------------- |
| `agentId`  | string  | Ja           | UUID des zu aktivierenden/deaktivierenden Agenten |
| `disabled` | boolean | Ja           | `true` zum Deaktivieren, `false` zum Aktivieren   |

## Beispiel

```javascript theme={null}
const axios = require("axios");

async function toggleAgentStatus(agentId, disabled) {
  const response = await axios.patch(
    "https://api.langdock.com/agent/v1/disable",
    {
      agentId: agentId,
      disabled: disabled
    },
    {
      headers: {
        Authorization: "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
      }
    }
  );

  console.log(`Agent ${disabled ? 'deaktiviert' : 'aktiviert'}:`, response.data);
}

// Agent deaktivieren
toggleAgentStatus("550e8400-e29b-41d4-a716-446655440000", true);

// Agent wieder aktivieren
toggleAgentStatus("550e8400-e29b-41d4-a716-446655440000", false);
```

## Antwort-Format

### Erfolgreiche Antwort (200 OK)

```typescript theme={null}
{
  status: "success";
  message: "Agent disabled successfully" | "Agent enabled successfully";
}
```

## Fehlerbehandlung

| Status-Code | Beschreibung                                               |
| ----------- | ---------------------------------------------------------- |
| 400         | Ungültige Parameter (fehlende agentId oder disabled)       |
| 401         | Ungültiger oder fehlender API-Schlüssel                    |
| 403         | Unzureichende Berechtigungen zum Deaktivieren von Agenten  |
| 404         | Agent nicht gefunden oder API-Schlüssel hat keinen Zugriff |
| 429         | Rate Limit überschritten                                   |

## Verhalten

Wenn ein Agent deaktiviert ist:

* Nutzer können keine neuen Konversationen mit dem Agenten starten
* Der Agent erscheint nicht in der Agenten-Bibliothek für normale Nutzer
* Bestehende Konversationen können noch einsehbar sein, aber der Agent kann nicht antworten
* Admins können den Agenten weiterhin sehen und verwalten
* Der Agent kann jederzeit wieder aktiviert werden

<Info>
  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](/de/admin/ai-adoption-and-rollout/best-practices/api-key-best-practices).
</Info>