# 페이지 템플릿 설정

`PUT /v1/branding/page-template` · 권한 `branding:write`

환경 초안의 Liquid 페이지 템플릿을 씁니다(Startup 이상 플랜, 기능 `branding_page_template`). 템플릿에는 `{{ idp.widget }}` 슬롯이 정확히 한 번 있어야 하며, 쓰기 시 샌드박스에서 컴파일됩니다. 빈 문자열은 지웁니다.

## 요청

| 필드 | 유형 | 필수 | 설명 |
|---|---|---|---|
| `If-Match` | 헤더 | 예 | 마지막으로 읽은 초안의 `ETag` (한 번도 쓰지 않았다면 `"0"`). 없으면 `428`, 오래되었으면 `412`. |
| `page_template` | 문자열 | 예 | 최대 102400바이트. `""`은 지웁니다. |

## 응답

`200 OK`와 환경 초안 및 `ETag`. `theme`에는 설정된 토큰만 있으며, 설정되지 않은 토큰은 플랫폼 기본값을 상속합니다.

```json
{
  "theme": {"mode": "light", "light": {"color": {"primary": "#0a3d91"}}, "logo_height": 40},
  "css": null,
  "page_template": null,
  "updated_at": "2026-10-05T09:30:00.123456Z"
}
```

## 오류

| HTTP | code | 조건 |
|---|---|---|
| 400 | `unknown_field` | 본문에 알 수 없는 필드가 있거나 JSON 객체가 아닙니다. |
| 403 | `plan_feature_unavailable` | 플랜에 기능이 포함되어 있지 않습니다(`plan_feature_unavailable`, 확장 `feature`와 `required_plan`). 개발 환경은 제한되지 않습니다. |
| 412 | `precondition_failed` | `If-Match`가 초안의 현재 버전과 일치하지 않습니다. |
| 422 | `validation_failed` | `page_template`가 없거나 `null`이거나(`required`) 너무 깁니다(`too_long`). |
| 422 | `template_forbidden_construct` | 템플릿이 금지된 구문(예: `{% include %}` 또는 `<script>`)을 사용하거나 `{{ idp.widget }}`이 정확히 한 번 나타나지 않습니다. |
| 428 | `precondition_required` | `If-Match` 헤더가 없습니다. |
| 401 | `unauthenticated` | 자격 증명이 없거나 유효하지 않거나 폐기되었습니다. |
| 403 | `insufficient_permissions` | 자격 증명에 필요한 권한이 없습니다. |
| 429 | `rate_limited` | 속도 제한을 초과했습니다. `Retry-After` 기간 후에 다시 시도하세요. |
| 503 | `service_unavailable` | 종속 서비스를 일시적으로 사용할 수 없습니다. `Retry-After` 기간 후에 다시 시도하세요. |

## 예제

```bash
curl -X PUT https://api.eu.keenauth.com/v1/branding/page-template \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -H 'If-Match: "3"' \
  -d '{"page_template":"<div class=\"shell\">{{ idp.widget }}</div>"}'
```