Obtener el borrador de marca

GET /v1/branding · permiso branding:read

Devuelve el borrador de marca del entorno: tokens del tema, CSS personalizado y plantilla de página. El borrador no está activo; las páginas alojadas usan la última versión publicada (POST /v1/branding:publish). Si aún no se escribió nada, el tema está vacío, el ETag es "0" y updated_at es null. Envíe el ETag como If-Match en la siguiente escritura.

Solicitud

Esta operación no admite campos de ruta, consulta ni cuerpo. El entorno proviene de la credencial.

Respuesta

200 OK con el borrador del entorno y su ETag. theme contiene solo los tokens definidos; los demás heredan el valor predeterminado de la plataforma.

{
  "theme": {"mode": "light", "light": {"color": {"primary": "#0a3d91"}}, "logo_height": 40},
  "css": null,
  "page_template": null,
  "updated_at": "2026-10-05T09:30:00.123456Z"
}

Errores

HTTP	código	Cuándo
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 \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"