# E-posta şablonu sürümlerini listele

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

Bir yuvanın sürümlerini, en yeniden eskiye doğru, içerikleri olmadan listeler. En fazla 51 tane döner: son 50 sürüm ve yayımlanmış olan. Liste sayfalanmaz. `ETag` başlığı yuvanın en yeni sürümüdür; hiç sürümü olmayan yuva boş liste döndürür.

## Yol parametreleri

| Parametre | Açıklama |
|---|---|
| `family` | E-posta ailesi, örneğin `verify_email` veya `email_otp` ([E-posta şablonlarını listele](list.md) bölümüne bakın). |
| `locale` | Dil etiketi, örneğin `en` veya `de`. |

## Yanıt

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

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

## Hatalar

| HTTP | code | Ne zaman |
|---|---|---|
| 404 | `not_found` | Aile ya da dil bilinmiyor. |
| 401 | `unauthenticated` | Kimlik bilgisi eksik, geçersiz ya da iptal edilmiş. |
| 403 | `insufficient_permissions` | Kimlik bilgisinin gerekli izni yok. |
| 429 | `rate_limited` | Hız sınırı aşıldı; `Retry-After` süresinden sonra yeniden deneyin. |
| 503 | `service_unavailable` | Bir bağımlılık geçici olarak kullanılamıyor; `Retry-After` süresinden sonra yeniden deneyin. |

## Örnek

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