Ottenere un modello e-mail

GET /v1/email-templates/{family}/{locale} · permesso email-templates:read

Restituisce una versione di uno slot di modello (una famiglia e una lingua): per impostazione predefinita la versione più recente, quella pubblicata con ?version=published, oppure un numero specifico con ?version=N. L'intestazione ETag è la versione più recente dello slot; inviala come If-Match quando salvi una bozza.

Parametri di percorso

Parametro Descrizione
family Famiglia di e-mail, per esempio verify_email o email_otp (vedi Elencare i modelli e-mail).
locale Tag della lingua, per esempio en o de.

Parametri di query

Parametro Descrizione
version published, oppure un numero di versione (1 o maggiore). Ometti per la versione più recente.

Risposta

200 OK con ETag: "3"

{
  "family": "verify_email",
  "locale": "en",
  "version": 3,
  "status": "draft",
  "subject": "Confirm your email for {{ application.name }}",
  "html": "<p>Hi,</p><p><a href=\"{{ link }}\">Confirm your email</a></p>",
  "text_body": "Confirm your email: {{ link }}",
  "from_name": null,
  "source_version": null,
  "created_at": "2026-10-19T09:00:00Z",
  "published_at": null,
  "latest_version": 3,
  "published_version": 2
}

Errori

HTTP code Quando
404 not_found La famiglia o la lingua è sconosciuta, lo slot non ha versioni, è stato chiesto published ma non c'è nulla di pubblicato, oppure la versione non esiste.
422 validation_failed version non è né published né un numero positivo.
401 unauthenticated La credenziale è mancante, non valida o revocata.
403 insufficient_permissions La credenziale non ha il permesso richiesto.
429 rate_limited È stato superato il limite di frequenza; riprova dopo il periodo indicato in Retry-After.
503 service_unavailable Una dipendenza è temporaneamente non disponibile; riprova dopo il periodo indicato in Retry-After.

Esempio

curl "https://api.eu.keenauth.com/v1/email-templates/verify_email/en?version=published" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

CLI: keenauth email-templates get verify_email en --version published