メールテンプレートを取得

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

テンプレートのスロット（ファミリーとロケールの組み合わせ）の 1 つのバージョンを返します。既定では最新バージョン、?version=published では公開済みのバージョン、?version=N では指定した番号のバージョンを返します。ETag ヘッダーはスロットの最新バージョンです。下書きを保存するときに If-Match として送信してください。

パスパラメーター

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

クエリパラメーター

パラメーター 説明
version published、またはバージョン番号（1 以上）。最新バージョンの場合は省略します。

レスポンス

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

エラー

HTTP code 発生条件
404 not_found ファミリーまたはロケールが不明、スロットにバージョンがない、published を指定したが公開されたものがない、またはバージョンが存在しません。
422 validation_failed version が published でも正の数値でもありません。
401 unauthenticated 資格情報がない、無効、または取り消されています。
403 insufficient_permissions 資格情報に必要な権限がありません。
429 rate_limited レート制限を超えました。Retry-After の期間が過ぎてから再試行してください。
503 service_unavailable 依存先が一時的に利用できません。Retry-After の期間が過ぎてから再試行してください。

例

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