# アプリケーションテーマを置き換え

`PUT /v1/branding/applications/{application_id}` · 権限 `branding:write`

スコープのテーマ下書き全体を置き換えます。本文にないトークンは消去されます。`{"theme":{}}` はスコープを空にします。`If-Match` には環境ではなくこのスコープの `ETag` (対応する GET から取得) を指定します。

## リクエスト

| フィールド | タイプ | 必須 | 説明 |
|---|---|---|---|
| `application_id` | パス | はい | `app_…` ID。 |
| `If-Match` | ヘッダー | はい | 最後に読み取った下書きの `ETag` (未書き込みなら `"0"`)。ない場合は `428`、古い場合は `412`。 |
| `theme` | オブジェクト | はい | スコープの完全な `BrandingTheme`。 |

## レスポンス

`200 OK` とスコープのテーマ下書きおよび `ETag` (スコープごとに独自のバージョンがあります)。

```json
{
  "theme": {"logo": "logo_acme", "light": {"color": {"primary": "#0a3d91"}}},
  "updated_at": "2026-10-05T09:30:00.123456Z"
}
```

## エラー

| HTTP | コード | 概要 |
|---|---|---|
| 400 | `unknown_field` | 本文に不明なフィールドがあるか、JSON オブジェクトではありません。 |
| 404 | `not_found` | この環境にアプリケーションが存在しないか、ID の形式が不正です。 |
| 412 | `precondition_failed` | `If-Match` が下書きの現在のバージョンと一致しません。 |
| 422 | `validation_failed` | トークン値が無効です (`invalid_value`、`out_of_range`、`unknown_token`)。`pointer` がトークンを示します (例: `/theme/light/color/primary`)。 |
| 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/applications/app_01jbexample0000000000000000 \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -H 'If-Match: "1"' \
  -d '{"theme":{"logo":"logo_acme","light":{"color":{"primary":"#0a3d91"}}}}'
```