Lösche eine Verbindung

DELETE /v1/connections/{connection_id} · Berechtigung connections:write

Löscht eine Verbindung. Benutzerdaten werden nicht gelöscht. If-Match ist erforderlich. Wenn Benutzer Identitäten von einer aktiven Verbindung haben, schlägt das Löschen mit connection_in_use fehl; Deaktiviere die Verbindung zuerst. Die Verbindung wird auch aus Anwendungsverbindungslisten entfernt. Eine gelöschte Verbindung kann innerhalb von 30 Tagen mit :restore als inactive wiederhergestellt werden; danach wird sie endgültig gelöscht.

Anfrage

Feld	Typ	Erforderlich	Beschreibung
`connection_id`	string	ja	Verbindungskennung (`conn_…`).
`If-Match`	header	ja	Das `ETag` der Verbindung wie zuletzt gelesen. Fehlt: `428`; veraltet: `412`.

Antwort

204 No Content, kein Body.

Fehler

HTTP	Code	Wann
404	`not_found`	Die Verbindung existiert nicht oder gehört einer anderen Umgebung.
409	`connection_in_use`	Benutzer haben immer noch Identitäten von dieser aktiven Verbindung; Deaktiviere sie zuerst.
412	`precondition_failed`	`If-Match` stimmt nicht mit der aktuellen Version überein.
428	`precondition_required`	Der `If-Match`-Header fehlt.
401	`unauthenticated`	Die Anmeldedaten fehlen, sind ungültig oder wurden widerrufen.
403	`insufficient_permissions`	Die Anmeldedaten haben nicht die erforderliche Berechtigung.
429	`rate_limited`	Die Rate-Grenze wurde überschritten; Wiederhole nach dem `Retry-After`-Zeitraum.
503	`service_unavailable`	Eine Abhängigkeit ist vorübergehend nicht verfügbar; Wiederhole nach dem `Retry-After`-Zeitraum.

Beispiel

curl -X DELETE https://api.eu.keenauth.com/v1/connections/conn_0k3v8m1q2x9dz4h7s5t6w0y1ab \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H 'If-Match: "2"'