Obtenir le brouillon d'image de marque

GET /v1/branding · permission branding:read

Renvoie le brouillon d'image de marque de l'environnement : jetons de thème, CSS personnalisé et modèle de page. Le brouillon n'est pas en ligne ; les pages hébergées utilisent la dernière version publiée (POST /v1/branding:publish). Si rien n'a encore été écrit, le thème est vide, l'ETag vaut "0" et updated_at est null. Envoyez l'ETag dans If-Match lors de l'écriture suivante.

Requête

Cette opération ne prend aucun champ de chemin, de requête ou de corps. L'environnement provient de l'identifiant.

Réponse

200 OK avec le brouillon de l'environnement et son ETag. theme ne contient que les jetons définis ; les autres héritent de la valeur par défaut de la plateforme.

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

Erreurs

HTTP	code	Quand
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 \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"