アプリケーションテーマを取得
GET /v1/branding/applications/{application_id} · 権限 branding:read
1 つのアプリケーションのテーマ下書きを返します。そのアプリケーションのホスト型ページでは、トークンが環境テーマを上書きします。独自の下書きがないアプリケーションは空のテーマと ETag: "0" を返します。
リクエスト
| フィールド | タイプ | 必須 | 説明 |
|---|---|---|---|
application_id |
パス | はい | app_… ID。 |
レスポンス
200 OK とスコープのテーマ下書きおよび ETag (スコープごとに独自のバージョンがあります)。
{
"theme": {"logo": "logo_acme", "light": {"color": {"primary": "#0a3d91"}}},
"updated_at": "2026-10-05T09:30:00.123456Z"
}
エラー
| HTTP | コード | 概要 |
|---|---|---|
| 404 | not_found |
この環境にアプリケーションが存在しないか、ID の形式が不正です。 |
| 401 | unauthenticated |
認証情報がない、無効、または失効しています。 |
| 403 | insufficient_permissions |
認証情報に必要な権限がありません。 |
| 429 | rate_limited |
レート制限を超えました。Retry-After の期間後に再試行してください。 |
| 503 | service_unavailable |
依存サービスが一時的に利用できません。Retry-After の期間後に再試行してください。 |
例
curl https://api.eu.keenauth.com/v1/branding/applications/app_01jbexample0000000000000000 \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"