Obtenir le thème de l'application

GET /v1/branding/applications/{application_id} · permission branding:read

Renvoie le brouillon de thème d'une application. Ses jetons remplacent le thème de l'environnement sur les pages hébergées de cette application. Une application sans brouillon propre renvoie un thème vide et ETag: "0".

Requête

Champ Type Obligatoire Description
application_id chemin oui Identifiant app_….

Réponse

200 OK avec le brouillon de thème de la portée et son ETag (chaque portée a sa propre version).

{
  "theme": {"logo": "logo_acme", "light": {"color": {"primary": "#0a3d91"}}},
  "updated_at": "2026-10-05T09:30:00.123456Z"
}

Erreurs

HTTP code Quand
404 not_found L'application n'existe pas dans cet environnement, ou l'identifiant est mal formé.
401 unauthenticated L'identifiant est absent, invalide ou révoqué.
403 insufficient_permissions L'identifiant n'a pas la permission requise.
429 rate_limited La limite de débit est dépassée ; réessayez après le délai Retry-After.
503 service_unavailable Une dépendance est temporairement indisponible ; réessayez après le délai Retry-After.

Exemple

curl https://api.eu.keenauth.com/v1/branding/applications/app_01jbexample0000000000000000 \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"