Obtener el tema de la organización
GET /v1/branding/organizations/{org_id} · permiso branding:read
Devuelve el borrador del tema de una organización. Un tema de organización solo puede definir logo, light.color.primary y dark.color.primary. Una organización sin borrador propio devuelve un tema vacío y ETag: "0".
Solicitud
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
org_id |
ruta | sí | Id org_…. |
Respuesta
200 OK con el borrador del tema del ámbito y su ETag (cada ámbito tiene su propia versión).
{
"theme": {"logo": "logo_acme", "light": {"color": {"primary": "#0a3d91"}}},
"updated_at": "2026-10-05T09:30:00.123456Z"
}
Errores
| HTTP | código | Cuándo |
|---|---|---|
| 404 | not_found |
El id no es un id org_… válido. |
| 401 | unauthenticated |
La credencial falta, no es válida o se ha revocado. |
| 403 | insufficient_permissions |
La credencial no tiene el permiso necesario. |
| 429 | rate_limited |
Se superó el límite de frecuencia; vuelva a intentarlo tras el periodo Retry-After. |
| 503 | service_unavailable |
Una dependencia no está disponible temporalmente; vuelva a intentarlo tras el periodo Retry-After. |
Ejemplo
curl https://api.eu.keenauth.com/v1/branding/organizations/org_01jbexample0000000000000000 \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"