Revoca una sessione
POST /v1/sessions/{session_id}:revoke · permesso sessions:write
Revoca la sessione e le famiglie di refresh token a essa associate; i token di accesso emessi nella sessione smettono di essere accettati dall'introspezione e dal controllo di revoca (sid), e le applicazioni della sessione ricevono notifiche di disconnessione. La richiesta non ha corpo. Revocare una sessione già revocata o scaduta non modifica nulla e restituisce already_inactive: true. La revoca viene scritta nel log di audit di gestione. Inviare un'intestazione Idempotency-Key per rendere sicuri i nuovi tentativi.
Richiesta
| Parametro | In | Obbligatorio | Descrizione |
|---|---|---|---|
session_id |
path | sì | ID sessione, con prefisso ses_. |
Risposta
200 OK.
{
"already_inactive": false,
"revoked_token_families": 2
}
Errori
Ogni errore è un body application/problem+json con un code stabile.
| HTTP | code |
Quando |
|---|---|---|
| 400 | malformed_request, unknown_field |
È stato inviato un corpo che non è JSON valido oppure contiene un campo. |
| 404 | not_found |
La sessione non esiste in questo ambiente (oppure l'ID è malformato). |
| 401 | unauthenticated |
La chiave API manca, non è valida o è stata revocata. |
| 403 | insufficient_permissions |
La chiave non ha il permesso sessions:write. |
| 429 | rate_limited |
È stato superato il limite di frequenza; attendi il periodo indicato in Retry-After. |
| 503 | service_unavailable |
Una dipendenza non è disponibile temporaneamente; riprova più tardi. |
Esempio
curl -X POST https://api.eu.keenauth.com/v1/sessions/ses_0a1b2c3d4e5f6g7h8j9k0m1n2p:revoke \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
-H "Idempotency-Key: $(uuidgen)"
CLI: keenauth sessions revoke ses_0a1b2c3d4e5f6g7h8j9k0m1n2p --yes