# カスタム CSS を設定

`PUT /v1/branding/css` · 権限 `branding:write`

環境の下書きのカスタム CSS を書き込みます (Startup 以上のプラン、機能 `branding_custom_css`)。CSS は許可リスト方式のサニタイザーを通ります。使用できるのは `ui_catalog` のクラス (`idp-*`) と許可されたプロパティおよび値のみで、保護レイヤー (法的テキスト、同意、アクセシビリティ要素) を隠したり覆ったりすることはできません。オール・オア・ナッシング: 違反が 1 つでもあれば何も書き込まれません。下書きには送信したテキストではなくサニタイザーの正規化出力が保存され、レスポンスの `css` はその出力です。空文字列で消去し、プランの制限を受けません。

## リクエスト

| フィールド | タイプ | 必須 | 説明 |
|---|---|---|---|
| `If-Match` | ヘッダー | はい | 最後に読み取った下書きの `ETag` (未書き込みなら `"0"`)。ない場合は `428`、古い場合は `412`。 |
| `css` | 文字列 | はい | 最大 51200 バイト、有効な UTF-8。`""` で消去。 |

## レスポンス

`200 OK` と環境の下書きおよび `ETag`。`theme` には設定済みのトークンのみが含まれ、未設定のトークンはプラットフォーム既定値を継承します。

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

## エラー

| HTTP | コード | 概要 |
|---|---|---|
| 400 | `unknown_field` | 本文に不明なフィールドがあるか、JSON オブジェクトではありません。 |
| 403 | `plan_feature_unavailable` | プランにこの機能が含まれていません (`plan_feature_unavailable`、拡張 `feature` と `required_plan`)。開発環境は制限されません。 |
| 412 | `precondition_failed` | `If-Match` が下書きの現在のバージョンと一致しません。 |
| 422 | `validation_failed` | `css` がない、`null` (`required`)、長すぎる (`too_long`)、または有効な UTF-8 ではありません (`invalid_utf8`)。 |
| 422 | `branding_validation_failed` | CSS がサニタイザーを通過しませんでした。`violations` 拡張にすべての違反が列挙されます: `line`、`column` (1 始まり)、`rule` (例: `class_not_in_catalog`、`protected_property`、`property_not_allowed`、`syntax_error`)、および該当する場合は `name` (プロパティ、クラス、または関数の名前)。CSS の値は返されません。違反が 100 件を超えるとサニタイザーは停止し、最後の項目のルールは `too_many_issues` です。正規化された出力は入力より長くなります (すべてのルールにスコープ接頭辞が付与されるため)。51200 バイトを超える場合、唯一の違反はルール `too_large` (1 行目、1 列目) です。 |
| 428 | `precondition_required` | `If-Match` ヘッダーがありません。 |
| 401 | `unauthenticated` | 認証情報がない、無効、または失効しています。 |
| 403 | `insufficient_permissions` | 認証情報に必要な権限がありません。 |
| 429 | `rate_limited` | レート制限を超えました。`Retry-After` の期間後に再試行してください。 |
| 503 | `service_unavailable` | 依存サービスが一時的に利用できません。`Retry-After` の期間後に再試行してください。 |

サニタイザーによる拒否の例:

```css
.idp-button{position:fixed}
.my-banner{color:red}
```

```json
{
  "type": "https://docs.keenauth.com/errors/branding_validation_failed",
  "title": "Branding validation failed",
  "status": 422,
  "code": "branding_validation_failed",
  "violations": [
    {"line": 1, "column": 13, "rule": "property_not_allowed", "name": "position"},
    {"line": 2, "column": 1, "rule": "class_not_in_catalog", "name": "my-banner"}
  ],
  "request_id": "req_01J9Z3N5W8Q2F6V4K7T1M0XB3C"
}
```

## 例

```bash
curl -X PUT https://api.eu.keenauth.com/v1/branding/css \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -H 'If-Match: "3"' \
  -d '{"css":".idp-title { color: #0a3d91 }"}'
```