E-Mail-Vorlagenversionen auflisten

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

Listet die Versionen eines Slots, neueste zuerst, ohne ihren Inhalt auf. Es werden höchstens 51 zurückgegeben: die letzten 50 und die veröffentlichte. Die Liste ist nicht paginiert. Der Header ETag ist die neueste Version des Slots; ein Slot ohne Versionen gibt eine leere Liste zurück.

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`.

Antwort

200 OK mit ETag: "3"

{
  "data": [
    {"version": 3, "status": "draft", "source_version": null, "created_at": "2026-10-19T09:00:00Z", "published_at": null},
    {"version": 2, "status": "published", "source_version": null, "created_at": "2026-10-18T14:10:00Z", "published_at": "2026-10-18T14:12:00Z"},
    {"version": 1, "status": "archived", "source_version": null, "created_at": "2026-10-17T08:00:00Z", "published_at": "2026-10-17T08:05:00Z"}
  ],
  "list_metadata": {"before": null, "after": null}
}

Fehler

HTTP	code	Wann
404	`not_found`	Familie oder Sprache ist unbekannt.
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/versions \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

CLI: keenauth email-templates versions list verify_email en