Obtener una plantilla de correo

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

Devuelve una versión de un slot de plantilla (una familia y un idioma): por defecto, la versión más reciente; la publicada con ?version=published, o un número concreto con ?version=N. La cabecera ETag es la versión más reciente del slot; envíela como If-Match cuando guarde un borrador.

Parámetros de ruta

Parámetro Descripción
family Familia de correo, por ejemplo verify_email o email_otp (consulte Listar plantillas de correo).
locale Etiqueta de idioma, por ejemplo en o de.

Parámetros de consulta

Parámetro Descripción
version published, o un número de versión (1 o mayor). Omítalo para la versión más reciente.

Respuesta

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
}

Errores

HTTP code Cuándo
404 not_found La familia o el idioma no existe, el slot no tiene versiones, se pidió published y no hay nada publicado, o la versión no existe.
422 validation_failed version no es published ni un número positivo.
401 unauthenticated La credencial falta, no es válida o ha sido revocada.
403 insufficient_permissions La credencial no tiene el permiso requerido.
429 rate_limited Se superó el límite de frecuencia; reintente después del periodo indicado en Retry-After.
503 service_unavailable Una dependencia no está disponible temporalmente; reintente después del periodo indicado en Retry-After.

Ejemplo

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