Revoca l'autenticatore di un utente
DELETE /v1/users/{user_id}/authenticators/{authenticator_id} · autorizzazione user-credentials:write
Revoca un autenticatore, passkey comprese. revoked_by diventa admin:<actor> e revoke_reason diventa admin_removed. Se l'autenticatore è già revocato non cambia nulla e la chiamata restituisce comunque 204. Le sessioni dell'utente non vengono chiuse. L'utente riceve una notifica e l'operazione viene registrata nel log di audit di gestione.
Richiesta
| Parametro | In | Obbligatorio | Descrizione |
|---|---|---|---|
user_id |
path | sì | ID utente, con prefisso usr_. |
authenticator_id |
path | sì | ID autenticatore, con prefisso cred_. |
La richiesta non prevede body.
Risposta
204 No Content, anche quando l'autenticatore era già revocato.
Errori
Ogni errore è un body application/problem+json con un code stabile.
| HTTP | code |
Quando |
|---|---|---|
| 404 | not_found |
L'utente o l'autenticatore non esiste in questo ambiente, l'autenticatore non appartiene a questo utente, oppure un ID è malformato. |
| 401 | unauthenticated |
La chiave API manca, non è valida o è stata revocata. |
| 403 | insufficient_permissions |
La chiave non ha l'autorizzazione user-credentials:write. |
| 429 | rate_limited |
È stato superato il limite di richieste; rispetta Retry-After. |
| 503 | service_unavailable |
Una dipendenza non è disponibile temporaneamente; riprova più tardi. |
Esempio
curl -X DELETE https://api.eu.keenauth.com/v1/users/usr_0a1b2c3d4e5f6g7h8j9k0m1n2p/authenticators/cred_0a1b2c3d4e5f6g7h8j9k0m1n2p \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
Dati personali
Questo endpoint tratta dati personali: credenziali. Dati personali nelle API di KeenAuth descrive cosa viene memorizzato, per quanto tempo viene conservato e come viene cancellato. Non inviare categorie particolari di dati personali (salute, dati biometrici, religione, opinioni politiche, orientamento sessuale) in nessun campo.