Branding aktualisieren
Aktualisiert die Branding-Konfiguration der Organisation. Alle Felder sind optional — nur gesendete Felder werden aktualisiert. Wird productName oder eine Theme-Farbe auf null gesetzt, wird sie geleert. Erfordert die Admin-Rolle.
PATCH /api/organization/whitelabel/branding
Theme-Farben akzeptieren CSS-Custom-Property-Tokens (z.B. --color-red-500) oder Hex-Farben (z.B. #43B1AE). Ungültige Werte werden abgelehnt.
Anfrage (Request Body) (alle optional)
| Feld | Typ | Beschreibung |
|---|---|---|
productName | string|null | Anzeigename des Produkts (1–80 Zeichen). null leert ihn. |
hideProductName | boolean | Blendet den Produktnamen in der UI aus |
hideLogos | boolean | Blendet alle Logos in der UI aus |
themePrimary | string|null | Primäre Theme-Farbe (Hex oder CSS-Variable). null leert sie. |
themeNeutral | string|null | Neutrale/sekundäre Theme-Farbe (Hex oder CSS-Variable). null leert sie. |
Beispiel (cURL)
curl -X PATCH "$BASE_URL/api/organization/whitelabel/branding" \
-H "Cookie: $SESSION_COOKIE" \
-H "Content-Type: application/json" \
-d '{
"productName": "Acme Monitor",
"themePrimary": "#43B1AE",
"hideProductName": false
}'Antwort (Response)
{
"branding": {
"productName": "Acme Monitor",
"hideProductName": false,
"hideLogos": false,
"themePrimary": "#43B1AE",
"themeSecondary": null,
"updatedAt": "2026-04-15T12:00:00.000Z"
}
}Häufige Fehler
401 Unauthorizedwenn nicht authentifiziert403 Forbiddenwenn kein Admin
Domains auflisten
Gibt alle eigenen App-Domains der Organisation zurück. Es werden nur Domains mit der Rolle app zurückgegeben. Erfordert die Admin-Rolle.
Branding-Asset hochladen
Lädt ein Logo oder Favicon als Base64-Data-URL hoch. Assets werden in S3 gespeichert und der Branding-Datensatz wird automatisch aktualisiert. Erfordert die Admin-Rolle.