# 이메일 템플릿 버전 목록 조회

`GET /v1/email-templates/{family}/{locale}/versions` · 권한 `email-templates:read`

슬롯의 버전을 최신순으로 내용 없이 나열합니다. 최대 51개가 반환됩니다: 최근 50개와 게시된 버전. 목록은 페이지로 나뉘지 않습니다. `ETag` 헤더는 슬롯의 최신 버전이며, 버전이 없는 슬롯은 빈 목록을 반환합니다.

## 경로 매개변수

| 매개변수 | 설명 |
|---|---|
| `family` | 이메일 패밀리(예: `verify_email` 또는 `email_otp`, [이메일 템플릿 목록 조회](list.md) 참고). |
| `locale` | 로케일 태그(예: `en` 또는 `de`). |

## 응답

`200 OK`, `ETag: "3"`

```json
{
  "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` 기간 이후에 다시 시도하세요. |

## 예제

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