Management-Client löschen
DELETE /v1/management-clients/{application_id} · Berechtigung management-clients:write
Löscht den Management-Client-Datensatz einer Anwendung. Die Anwendung und ihre Berechtigungsnachweise bleiben erhalten. Das Löschen der Anwendung selbst (DELETE /v1/applications/{application_id}) entfernt auch diesen Datensatz; danach antworten dieser Endpunkt und GET mit 404. If-Match ist erforderlich: Ohne es schlägt die Anfrage mit 428 fehl, mit einer nicht mehr passenden Version mit 412. Nur ein API-Schlüssel kann diesen Endpunkt aufrufen.
Anfrage
| Parameter | In | Beschreibung |
|---|---|---|
application_id |
Pfad | Anwendungs-ID (app_…). |
If-Match |
Header | Das ETag aus dem letzten Lesen oder Schreiben. |
Antwort
204 No Content
Fehler
| HTTP | code | Wann |
|---|---|---|
| 403 | insufficient_permissions |
Der Berechtigungsnachweis hat nicht management-clients:write, oder es ist kein API-Schlüssel. |
| 403 | permission_escalation |
Der Datensatz ist umfassender als der aufrufende Schlüssel. |
| 404 | not_found |
Die Anwendung hat in dieser Umgebung keinen Datensatz. |
| 412 | precondition_failed |
If-Match stimmt nicht mit der aktuellen Version überein. |
| 428 | precondition_required |
If-Match fehlt. |
Beispiel
curl -X DELETE https://api.eu.keenauth.com/v1/management-clients/app_01h455vb4pex5vsknk084sn02q \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
-H 'If-Match: "3f2a9c0d7b1e4a6f8c5d2e1b0a9f8e7d"'
CLI: keenauth management-clients delete app_01h455vb4pex5vsknk084sn02q --if-match '"3f2a9c0d7b1e4a6f8c5d2e1b0a9f8e7d"' --yes