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

# Lead löschen

> Lösche einen bestehenden Lead aus dem Famulor-System per API. Entfernt alle zugehörigen Anrufdaten, Transkripte und Notizen dieses Kontakts dauerhaft.

Dieser Endpunkt ermöglicht es dir, einen Lead aus dem Famulor-System zu löschen.

<Warning>
  Diese Aktion ist **nicht rückgängig zu machen**. Einmal gelöschte Leads können nicht wiederhergestellt werden.
</Warning>

### Pfad-Parameter

<ParamField path="id" type="integer" required>
  Die ID des zu löschenden Leads
</ParamField>

### Antwort-Felder

<ResponseField name="message" type="string">
  Die Nachricht der Antwort
</ResponseField>

### Hinweise

* Der Lead muss dem authentifizierten Benutzer gehören
* Nach dem Löschen sind alle mit dem Lead verknüpften Daten dauerhaft entfernt
* Laufende Anrufprozesse für diesen Lead werden abgebrochen
* Diese Aktion kann nicht rückgängig gemacht werden

<ResponseExample>
  ```json 200 Response theme={null}
  {
    "message": "Lead deleted successfully"
  }
  ```

  ```json 404 Response theme={null}
  {
    "message": "Lead nicht gefunden"
  }
  ```

  ```json 403 Response theme={null}
  {
    "message": "Zugriff verweigert - Lead gehört nicht dem authentifizierten Benutzer"
  }
  ```
</ResponseExample>

<Tip>
  Passende Seiten: [Introduction](/de/api-reference/introduction) und [Authentication Guide](/de/developers/authentication-guide) und [API Integration Examples](/de/developers/api-integration-examples).
</Tip>