E-Mail-Vorlage abrufen

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

Gibt eine Version eines Vorlagen-Slots zurück (eine Familie und eine Sprache): standardmäßig die neueste Version, mit ?version=published die veröffentlichte oder mit ?version=N eine bestimmte Nummer. Der Header ETag ist die neueste Version des Slots; senden Sie ihn als If-Match, wenn Sie einen Entwurf speichern.

Pfadparameter

Parameter Beschreibung
family E-Mail-Familie, zum Beispiel verify_email oder email_otp (siehe E-Mail-Vorlagen auflisten).
locale Sprachkennung, zum Beispiel en oder de.

Abfrageparameter

Parameter Beschreibung
version published oder eine Versionsnummer (1 oder größer). Weglassen für die neueste Version.

Antwort

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

Fehler

HTTP code Wann
404 not_found Familie oder Sprache ist unbekannt, der Slot hat keine Versionen, published wurde angefragt, aber nichts ist veröffentlicht, oder die Version existiert nicht.
422 validation_failed version ist weder published noch eine positive Zahl.
401 unauthenticated Die Anmeldeinformation fehlt, ist ungültig oder widerrufen.
403 insufficient_permissions Der Anmeldeinformation fehlt die erforderliche Berechtigung.
429 rate_limited Das Ratenlimit wurde überschritten; wiederholen Sie nach der Zeit aus Retry-After.
503 service_unavailable Eine Abhängigkeit ist vorübergehend nicht verfügbar; wiederholen Sie nach der Zeit aus Retry-After.

Beispiel

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