ブランディング下書きを取得

GET /v1/branding · 権限 branding:read

環境のブランディング下書き (テーマトークン、カスタム CSS、ページテンプレート) を返します。下書きは公開されていません。ホスト型ページは最後に公開されたバージョン (POST /v1/branding:publish) を使用します。まだ何も書き込まれていない場合、テーマは空で、ETag は "0"、updated_at は null です。次の書き込みでは ETag を If-Match として送信してください。

リクエスト

この操作はパス、クエリ、本文のフィールドを受け取りません。環境は認証情報から決まります。

レスポンス

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

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

エラー

HTTP	コード	概要
401	`unauthenticated`	認証情報がない、無効、または失効しています。
403	`insufficient_permissions`	認証情報に必要な権限がありません。
429	`rate_limited`	レート制限を超えました。`Retry-After` の期間後に再試行してください。
503	`service_unavailable`	依存サービスが一時的に利用できません。`Retry-After` の期間後に再試行してください。

例

curl https://api.eu.keenauth.com/v1/branding \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"