メールテンプレートをロールバック

POST /v1/email-templates/{family}/{locale}:rollback · 権限 email-templates:write · Startup プラン以上

以前に公開され、現在はアーカイブされているバージョンの内容を再検証し、ロールバック先のバージョンを source_version に設定して、新しいバージョンとして公開します。履歴は書き換えられません。監査レコード email_template.rolled_back が同じトランザクションで書き込まれます。

一度も公開されたことがないバージョン、または現在公開されているバージョンは 409 を返します。

パスパラメーター

パラメーター 説明
family メールファミリー。例: verify_email または email_otp（メールテンプレートを一覧表示を参照）。
locale ロケールタグ。例: en または de。

リクエスト

フィールド 型 必須 説明
version integer はい 再公開するアーカイブ済みのバージョン（1 以上）。

レスポンス

200 OK。新しく公開されたバージョンを返します。

{
  "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
}

エラー

HTTP code 発生条件
400 unknown_field 本文に未知のフィールドがあるか、JSON オブジェクトではありません。
404 not_found ファミリーまたはロケールが不明、またはバージョンが存在しません。
403 plan_feature_unavailable 環境のプランにカスタムメールテンプレートが含まれていません（Startup 以上。必要なプランは required_plan に示されます）。
409 conflict バージョンが一度も公開されていないか、現在公開されているバージョンです。
422 validation_failed version がないか 1 未満、または内容が再検証に通りません。
401 unauthenticated 資格情報がない、無効、または取り消されています。
403 insufficient_permissions 資格情報に必要な権限がありません。
429 rate_limited レート制限を超えました。Retry-After の期間が過ぎてから再試行してください。
503 service_unavailable 依存先が一時的に利用できません。Retry-After の期間が過ぎてから再試行してください。

例

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