E-Mail-Vorlage zurücksetzen

POST /v1/email-templates/{family}/{locale}:rollback · Berechtigung email-templates:write · Startup-Plan und höher

Validiert den Inhalt einer früher veröffentlichten (jetzt archivierten) Version erneut und veröffentlicht ihn als neue Version, wobei source_version auf die Version gesetzt wird, auf die Sie zurückgesetzt haben. Der Verlauf wird nicht umgeschrieben. Der Auditeintrag email_template.rolled_back wird in derselben Transaktion geschrieben.

Eine Version, die nie veröffentlicht wurde, oder die aktuell veröffentlichte Version liefert 409.

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.

Anfrage

Feld Typ Pflicht Beschreibung
version integer ja Die archivierte Version, die erneut veröffentlicht wird (1 oder größer).

Antwort

200 OK mit der neuen veröffentlichten Version.

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

Fehler

HTTP code Wann
400 unknown_field Der Body enthält ein unbekanntes Feld oder ist kein JSON-Objekt.
404 not_found Familie oder Sprache ist unbekannt, oder die Version existiert nicht.
403 plan_feature_unavailable Der Plan der Umgebung enthält keine eigenen E-Mail-Vorlagen (Startup und höher; required_plan nennt den nötigen Plan).
409 conflict Die Version wurde nie veröffentlicht oder ist die aktuell veröffentlichte Version.
422 validation_failed version fehlt oder ist kleiner als 1, oder der Inhalt besteht die Validierung nicht mehr.
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 -X POST https://api.eu.keenauth.com/v1/email-templates/verify_email/en:rollback \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"version":1}'

CLI: keenauth email-templates rollback verify_email en --version 1 --yes