> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# AI deaktivieren

> Deaktiviert AI-Antworten für eine Konversation und ermöglicht die Übergabe an einen Menschen

Deaktiviert AI-Antworten für eine Konversation. Nach der Deaktivierung stoppt der Assistent die Antwortgenerierung. Neue Nachrichten werden weiterhin gespeichert, aber nicht mehr von der AI beantwortet.

Das ist ideal für **Human-Takeover**-Workflows, wenn ein Kunde mit einem menschlichen Agenten sprechen möchte.

### Authentifizierung

Dieser Endpunkt benötigt deinen **Automate API Key** als Bearer-Token.

### Path-Parameter

<ParamField path="uuid" type="string" required>
  Die eindeutige UUID der Konversation
</ParamField>

### Antwort-Felder

<ResponseField name="status" type="boolean">
  `true`, wenn die Operation erfolgreich war
</ResponseField>

<ResponseField name="ai_enabled" type="boolean">
  Ist bei Erfolg immer `false`
</ResponseField>

### Fehlerantworten

<ResponseField name="status" type="boolean">
  `false`, wenn ein Fehler auftritt
</ResponseField>

<ResponseField name="error" type="string">
  Fehlermeldung. Mögliche Werte:

  * `Conversation not found` — die UUID existiert nicht oder gehört zu einem anderen Account
</ResponseField>

<RequestExample>
  ```bash cURL theme={null} theme={null}
  curl -X POST "https://app.famulor.de/api/automate/conversations/7c9e6679-7425-40de-944b-e07fc1f90ae7/disable-ai" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```javascript JavaScript theme={null} theme={null}
  const conversationId = '7c9e6679-7425-40de-944b-e07fc1f90ae7';

  const response = await fetch(
    `https://app.famulor.de/api/automate/conversations/${conversationId}/disable-ai`,
    {
      method: 'POST',
      headers: {
        Authorization: 'Bearer YOUR_API_KEY',
      },
    }
  );

  const data = await response.json();
  console.log(data.ai_enabled); // false
  ```

  ```python Python theme={null} theme={null}
  import requests

  conversation_id = '7c9e6679-7425-40de-944b-e07fc1f90ae7'

  response = requests.post(
      f'https://app.famulor.de/api/automate/conversations/{conversation_id}/disable-ai',
      headers={'Authorization': 'Bearer YOUR_API_KEY'}
  )

  data = response.json()
  print(data['ai_enabled'])  # False
  ```
</RequestExample>

<ResponseExample>
  ```json 200 Success theme={null} theme={null}
  {
    "status": true,
    "ai_enabled": false
  }
  ```

  ```json 404 Not Found theme={null} theme={null}
  {
    "status": false,
    "error": "Conversation not found"
  }
  ```

  ```json 401 Unauthorized theme={null} theme={null}
  {
    "error": "Unauthorized"
  }
  ```
</ResponseExample>

## Human-Takeover-Flow

Ein häufiger Übergabe-Flow:

1. Erstelle ein Mid-Call-Tool (z. B. `transfer_to_human`) mit Webhook zu ActivePieces oder deinem Automations-Flow.
2. Rufe im Automations-Flow `POST /automate/conversations/{uuid}/disable-ai` mit deinem API Key auf.
3. Benachrichtige dein Support-Team (z. B. via Slack, E-Mail oder CRM) mit der Conversation-UUID.
4. Die AI stoppt Antworten — dein menschlicher Agent übernimmt direkt im Chat.

Zum späteren Reaktivieren nutzt du den Endpunkt [AI aktivieren](/de/api-reference/conversations/enable-ai).
