Obtenir un modèle d'e-mail

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

Renvoie une version d'un emplacement de modèle (une famille et une langue) : la version la plus récente par défaut, la version publiée avec ?version=published, ou un numéro donné avec ?version=N. L'en-tête ETag est la version la plus récente de l'emplacement ; envoyez-le comme If-Match lorsque vous enregistrez un brouillon.

Paramètres de chemin

Paramètre Description
family Famille d'e-mails, par exemple verify_email ou email_otp (voir Lister les modèles d'e-mail).
locale Étiquette de langue, par exemple en ou de.

Paramètres de requête

Paramètre Description
version published, ou un numéro de version (1 ou plus). Omettez-le pour la version la plus récente.

Réponse

200 OK avec 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
}

Erreurs

HTTP code Quand
404 not_found La famille ou la langue est inconnue, l'emplacement n'a aucune version, published a été demandé alors que rien n'est publié, ou la version n'existe pas.
422 validation_failed version n'est ni published ni un nombre positif.
401 unauthenticated L'identifiant est absent, invalide ou révoqué.
403 insufficient_permissions L'identifiant n'a pas l'autorisation requise.
429 rate_limited La limite de débit a été dépassée ; réessayez après la durée indiquée par Retry-After.
503 service_unavailable Une dépendance est temporairement indisponible ; réessayez après la durée indiquée par Retry-After.

Exemple

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