Zum Hauptinhalt springen
DELETE
curl
Löscht ein biometrisches Template: Es wird aus allen Arten des Abgleichs entfernt, und die gespeicherte Vorlage wird gelöscht. Die Löschung ist unumkehrbar und wird mit dem ausführenden Principal im Audit-Log erfasst.

Verhalten bei Wiederholungsversuchen

Didit löscht zuerst die gespeicherte Vorlage und markiert die Vorlage erst danach als gelöscht. Ist ein biometrischer Speicher nicht verfügbar, gibt der Aufruf 503 zurück, die Vorlage wechselt in status: purge_failed, und sie ist bereits vom Abgleich ausgeschlossen. Wiederholen Sie denselben Aufruf, um die Löschung abzuschließen.

Fehler

Weitere Löschzeitpunkte

Vorlagen werden außerdem gelöscht, wenn Sie den zugehörigen Benutzer mit Benutzer im Batch löschen löschen, wenn Sie eine Sitzung dieses Benutzers mit deletion_instruction: "privacy_erasure" löschen, und automatisch bei expires_at. Siehe Löschzeitpunkte.

Autorisierungen

x-api-key
string
header
erforderlich

Der API-Schlüssel Ihrer Anwendung, aus Entwickler -> API-Schlüssel in der Business Console. Der Primärschlüssel hat Vollzugriff. Ein benannter Schlüssel kann im Geltungsbereich eingeschränkt werden: keine, Lese- oder Schreibberechtigung pro Ressource, beschränkt auf bestimmte Workflows oder genehmigte Sitzungen, auf eine Liste von IP-Adressen und auf ein Ablaufdatum. 401 bedeutet, dass der Schlüssel falsch, widerrufen oder abgelaufen ist; 403 bedeutet, dass kein Schlüssel gesendet wurde, der Schlüssel keinen Zugriff auf diese Ressource oder Aktion hat oder die Anfrage von einer Adresse außerhalb seiner IP-Liste stammte; 404 bei einer Sitzungsroute bedeutet, dass die Sitzung außerhalb der Workflows oder Status des Schlüssels liegt. Ein Schlüssel ohne Medienzugriff erhält Bild-, Video- und PDF-URLs als null, und ein Schlüssel ohne Schreibberechtigung für Sitzungen erhält Sitzungslinks und Token als null. Siehe https://docs.didit.me/console/api-keys.

Pfadparameter

template_uuid
string<uuid>
erforderlich

Template-ID, wie in biometric_template_uuid von den Endpoints zum Löschen von Sitzungen, biometric_template_id bei einem Treffer der Gesichtssuche oder dem Listen-Endpoint zurückgegeben.

Beispiel:

"9d2f4b6e-1c3a-4e8f-b7d5-0a1c2e3f4a5b"

Antwort

Ergebnis des Löschvorgangs.

uuid
string<uuid>
outcome
enum<string>
Verfügbare Optionen:
purged,
already_purged
Zuletzt geändert am 7. November 2026