Elimina un indirizzo email non principale di un utente

DELETE /v1/users/{user_id}/emails/{email_id} · autorizzazione users:write

Elimina un indirizzo email non principale dell'utente. L'indirizzo principale non può essere eliminato: prima rendi principale un altro indirizzo verificato. Finché l'ambiente richiede un'email, non è possibile eliminare l'ultimo indirizzo verificato dell'utente. Ogni eliminazione viene registrata nel log di audit di gestione come user.email_removed, con la chiave API come attore. Eliminare di nuovo la stessa riga restituisce 404, perché la riga non esiste più: l'effetto è idempotente, il codice di stato no.

Richiesta

Parametro In Obbligatorio Descrizione
user_id path sì ID utente, con prefisso usr_.
email_id path sì ID della riga email (UUID interno, minuscolo, con trattini), come restituito da GET /v1/users/{user_id}/emails.

La richiesta non prevede body.

Risposta

204 No Content.

Errori

Ogni errore è un body application/problem+json con un code stabile.

HTTP code Quando
409 primary_identifier_required L'indirizzo è quello principale.
409 last_verified_channel L'ambiente richiede un'email e questo è l'ultimo indirizzo verificato.
404 not_found L'utente o la riga email non esiste in questo ambiente, l'email 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 users: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/emails/0191f0a0-3333-7444-8555-666666666666 \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

Dati personali

Questo endpoint tratta dati personali: profilo dell'utente finale. 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.