Ottenere il tema dell'organizzazione
GET /v1/branding/organizations/{org_id} · permesso branding:read
Restituisce la bozza del tema di un'organizzazione. Un tema di organizzazione può impostare solo logo, light.color.primary e dark.color.primary. Un'organizzazione senza bozza propria restituisce un tema vuoto e ETag: "0".
Richiesta
| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
org_id |
percorso | sì | Id org_…. |
Risposta
200 OK con la bozza del tema dell'ambito e il suo ETag (ogni ambito ha la propria versione).
{
"theme": {"logo": "logo_acme", "light": {"color": {"primary": "#0a3d91"}}},
"updated_at": "2026-10-05T09:30:00.123456Z"
}
Errori
| HTTP | code | Quando |
|---|---|---|
| 404 | not_found |
L'id non è un id org_… valido. |
| 401 | unauthenticated |
La credenziale manca, non è valida o è stata revocata. |
| 403 | insufficient_permissions |
La credenziale non ha il permesso richiesto. |
| 429 | rate_limited |
Il limite di frequenza è stato superato; riprovare dopo il periodo Retry-After. |
| 503 | service_unavailable |
Una dipendenza è temporaneamente non disponibile; riprovare dopo il periodo Retry-After. |
Esempio
curl https://api.eu.keenauth.com/v1/branding/organizations/org_01jbexample0000000000000000 \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"