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

# Assistant Disable API

> Einen Assistenten programmatisch aktivieren oder deaktivieren

<Warning>
  Die Assistants API wird am 16. August eingestellt. Verwende die [Agents API](/de/developer/agents-api/agent-disable) für neue Systeme. Nutze den [Migrations-Guide](/de/developer/assistants-api/assistant-to-agent-migration), um bestehende Systeme umzustellen.
</Warning>

<Info>
  **Nutzt du unsere API über ein Dedicated Deployment?** Ersetze einfach `api.langdock.com` mit der Basis-URL deines Deployments: **`<deployment-url>/api/public`**
</Info>

Aktiviert oder deaktiviert einen Assistenten in deinem Workspace. Deaktivierte Assistenten 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 Assistenten deaktivieren/aktivieren.
</Warning>

## Anwendungsfälle

* **Vorübergehend deaktivieren** eines Assistenten, der Wartung oder Updates benötigt
* **Wieder aktivieren** eines zuvor deaktivierten Assistenten
* **Verfügbarkeit steuern** von Assistenten während Rollouts oder Tests

## Anfrageparameter

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

## Beispiel

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

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

  console.log(`Assistant ${disabled ? 'disabled' : 'enabled'}:`, response.data);
}

// Disable an assistant
toggleAssistantStatus("550e8400-e29b-41d4-a716-446655440000", true);

// Re-enable an assistant
toggleAssistantStatus("550e8400-e29b-41d4-a716-446655440000", false);
```

## Antwortformat

### Erfolgreiche Antwort (200 OK)

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

## Fehlerbehandlung

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

## Verhalten

Wenn ein Assistent deaktiviert ist:

* Nutzer können keine neuen Konversationen mit dem Assistenten starten
* Der Assistent erscheint nicht in der Assistenten-Bibliothek für reguläre Nutzer
* Bestehende Konversationen können weiterhin angezeigt werden, aber der Assistent kann nicht antworten
* Admins können den Assistenten weiterhin einsehen und verwalten
* Der Assistent 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>