Invia l'email di verifica a un indirizzo email

POST /v1/users/{user_id}/emails/{email_id}:send-verification · autorizzazione users:write

Invia l'email di verifica a una riga email dell'utente. email_id è l'UUID interno (minuscolo, con trattini). La risposta contiene la scadenza della richiesta di verifica; non viene restituito alcun codice o link. Il corpo facoltativo serve solo a scegliere la lingua dell'email.

Richiesta

Parametro In Obbligatorio Descrizione
user_id path yes ID utente, con prefisso usr_.
email_id path yes ID della riga email (UUID interno, minuscolo, con trattini).

Corpo facoltativo:

Campo Tipo Obbligatorio Descrizione
locale string no Tag di lingua BCP 47 dell'email, ad esempio tr o pt-BR. Il valore predefinito è la lingua dell'utente o dell'ambiente.

Risposta

200 OK. expires_at indica quando scade la richiesta di verifica.

{
  "expires_at": "2026-01-16T09:30:00Z"
}

Errori

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

HTTP code Quando
400 malformed_request, unknown_field Il corpo non è JSON valido oppure contiene un campo sconosciuto.
409 conflict L'indirizzo email è già verificato.
415 unsupported_media_type È stato inviato un corpo senza Content-Type: application/json.
422 validation_failed locale non è un tag di lingua BCP 47 valido, oppure un campo ha un tipo errato.
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 frequenza dell'API o il limite di invio email per utente; rispetta Retry-After.
503 service_unavailable Una dipendenza non è temporaneamente disponibile; riprova più tardi.

Esempio

curl -X POST https://api.eu.keenauth.com/v1/users/usr_0a1b2c3d4e5f6g7h8j9k0m1n2p/emails/0191f0a0-3333-7444-8555-666666666666:send-verification \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"locale": "en"}'

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.