メールテンプレートのバージョンを一覧表示
GET /v1/email-templates/{family}/{locale}/versions · 権限 email-templates:read
スロットのバージョンを、内容を含めずに新しい順で一覧表示します。最大 51 件が返されます: 直近の 50 件と公開済みのバージョン。一覧はページ分割されません。ETag ヘッダーはスロットの最新バージョンです。バージョンがないスロットは空の一覧を返します。
パスパラメーター
| パラメーター | 説明 |
|---|---|
family |
メールファミリー。例: verify_email または email_otp（メールテンプレートを一覧表示を参照）。 |
locale |
ロケールタグ。例: en または de。 |
レスポンス
200 OK、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}
}
エラー
| HTTP | code | 発生条件 |
|---|---|---|
| 404 | not_found |
ファミリーまたはロケールが不明です。 |
| 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/versions \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
CLI: keenauth email-templates versions list verify_email en