Obtenir le thème de l'organisation
GET /v1/branding/organizations/{org_id} · permission branding:read
Renvoie le brouillon de thème d'une organisation. Un thème d'organisation ne peut définir que logo, light.color.primary et dark.color.primary. Une organisation sans brouillon propre renvoie un thème vide et ETag: "0".
Requête
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
org_id |
chemin | oui | Identifiant org_…. |
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'identifiant n'est pas un identifiant org_… valide. |
| 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/organizations/org_01jbexample0000000000000000 \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"