Update Branding
Updates the organization's branding configuration. All fields are optional: only sent fields are updated. Setting productName or theme colors to null clears them. Requires admin role.
PATCH /api/organization/whitelabel/branding
Theme colors accept CSS custom property tokens (e.g. --color-red-500) or hex colors (e.g. #43B1AE). Invalid values are rejected.
Request Body (all optional)
| Field | Type | Description |
|---|---|---|
productName | string|null | Product display name (1-80 chars). null clears it. |
hideProductName | boolean | Hide the product name in the UI |
hideLogos | boolean | Hide all logos in the UI |
themePrimary | string|null | Primary theme color (hex or CSS variable). null clears it. |
themeSecondary | string|null | Secondary (neutral) theme color (hex or CSS variable), the same name the response uses. null clears it. |
themeNeutral | string|null | Deprecated, use themeSecondary; removed on 2027-02-01. Still accepted; when both are sent, themeSecondary wins. |
Fields you leave out keep their stored value (merge patch). Until 28.10.2026 productName had to be sent with every request; it is optional now.
Example (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
}'Response
{
"branding": {
"productName": "Acme Monitor",
"hideProductName": false,
"hideLogos": false,
"themePrimary": "#43B1AE",
"themeSecondary": null,
"updatedAt": "2026-04-15T12:00:00.000Z"
}
}Common errors
401 Unauthorizedwhen not authenticated403 Forbiddenwhen not an admin
Domain Diagnostics
Live DNS and certificate check of one custom app domain: authoritative nameservers, TXT record seen, propagation, certificate state, last failed verification. Requires the admin role.
Upload Branding Asset
Uploads a logo or favicon as a base64 data URL. Assets are stored in S3 and the branding record is updated automatically. Requires admin role.