Get the organization theme
GET /v1/branding/organizations/{org_id} · permission branding:read
Returns the theme draft of one organization. An organization theme can set only logo, light.color.primary and dark.color.primary. An organization without its own draft returns an empty theme and ETag: "0".
Request
| Field | Type | Required | Description |
|---|---|---|---|
org_id |
path | yes | org_… id. |
Response
200 OK with the scope's theme draft and its ETag (each scope has its own version).
{
"theme": {"logo": "logo_acme", "light": {"color": {"primary": "#0a3d91"}}},
"updated_at": "2026-10-05T09:30:00.123456Z"
}
Errors
| HTTP | code | When |
|---|---|---|
| 404 | not_found |
The id is not a valid org_… id. |
| 401 | unauthenticated |
The credential is missing, invalid or revoked. |
| 403 | insufficient_permissions |
The credential lacks the required permission. |
| 429 | rate_limited |
The rate limit was exceeded; retry after the Retry-After period. |
| 503 | service_unavailable |
A dependency is temporarily unavailable; retry after the Retry-After period. |
Example
curl https://api.eu.keenauth.com/v1/branding/organizations/org_01jbexample0000000000000000 \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"