Anwendungsthema abrufen
GET /v1/branding/applications/{application_id} · Berechtigung branding:read
Gibt den Themenentwurf einer Anwendung zurück. Seine Tokens überschreiben das Umgebungsthema auf den gehosteten Seiten dieser Anwendung. Eine Anwendung ohne eigenen Entwurf liefert ein leeres Thema und ETag: "0".
Anfrage
| Feld | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
application_id |
Pfad | ja | app_…-ID. |
Antwort
200 OK mit dem Themenentwurf des Bereichs und seinem ETag (jeder Bereich hat eine eigene Version).
{
"theme": {"logo": "logo_acme", "light": {"color": {"primary": "#0a3d91"}}},
"updated_at": "2026-10-05T09:30:00.123456Z"
}
Fehler
| HTTP | Code | Wann |
|---|---|---|
| 404 | not_found |
Die Anwendung existiert in dieser Umgebung nicht, oder die ID ist fehlerhaft. |
| 401 | unauthenticated |
Die Anmeldeinformation fehlt, ist ungültig oder widerrufen. |
| 403 | insufficient_permissions |
Der Anmeldeinformation fehlt die erforderliche Berechtigung. |
| 429 | rate_limited |
Das Ratenlimit wurde überschritten; nach der Retry-After-Zeit erneut versuchen. |
| 503 | service_unavailable |
Eine Abhängigkeit ist vorübergehend nicht verfügbar; nach der Retry-After-Zeit erneut versuchen. |
Beispiel
curl https://api.eu.keenauth.com/v1/branding/applications/app_01jbexample0000000000000000 \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"