組織テーマを取得
GET /v1/branding/organizations/{org_id} · 権限 branding:read
1 つの組織のテーマ下書きを返します。組織テーマで設定できるのは logo、light.color.primary、dark.color.primary のみです。独自の下書きがない組織は空のテーマと ETag: "0" を返します。
リクエスト
| フィールド | タイプ | 必須 | 説明 |
|---|---|---|---|
org_id |
パス | はい | org_… 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 が有効な org_… ID ではありません。 |
| 401 | unauthenticated |
認証情報がない、無効、または失効しています。 |
| 403 | insufficient_permissions |
認証情報に必要な権限がありません。 |
| 429 | rate_limited |
レート制限を超えました。Retry-After の期間後に再試行してください。 |
| 503 | service_unavailable |
依存サービスが一時的に利用できません。Retry-After の期間後に再試行してください。 |
例
curl https://api.eu.keenauth.com/v1/branding/organizations/org_01jbexample0000000000000000 \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"