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

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 (スコープごとに独自のバージョンがあります)。

{
  "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 の期間後に再試行してください。

例

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"}}}}'