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

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