Get the application theme
GET /v1/branding/applications/{application_id} · permission branding:read
Returns the theme draft of one application. Its tokens override the environment theme on that application's hosted pages. An application without its own draft returns an empty theme and ETag: "0".
Request
| Field | Type | Required | Description |
|---|---|---|---|
application_id |
path | yes | app_… 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 application does not exist in this environment, or the id is malformed. |
| 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/applications/app_01jbexample0000000000000000 \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"