Elimina un client di gestione
DELETE /v1/management-clients/{application_id} · permesso management-clients:write
Elimina il record del client di gestione di un'applicazione. L'applicazione e le sue credenziali vengono mantenute. L'eliminazione dell'applicazione stessa (DELETE /v1/applications/{application_id}) rimuove anche questo record; successivamente questo endpoint e GET rispondono con 404. If-Match è obbligatorio: senza di esso la richiesta fallisce con 428, e con una versione non più corrispondente fallisce con 412. Solo una chiave API può chiamare questo endpoint.
Richiesta
| Parametro | In | Descrizione |
|---|---|---|
application_id |
path | ID dell'applicazione (app_…). |
If-Match |
header | L'ETag dell'ultima lettura o scrittura. |
Risposta
204 No Content
Errori
| HTTP | code | Quando |
|---|---|---|
| 403 | insufficient_permissions |
La credenziale non ha management-clients:write, oppure non è una chiave API. |
| 403 | permission_escalation |
Il record è più ampio della chiave che effettua la chiamata. |
| 404 | not_found |
L'applicazione non ha un record in questo ambiente. |
| 412 | precondition_failed |
If-Match non corrisponde alla versione corrente. |
| 428 | precondition_required |
If-Match manca. |
Esempio
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