Branding and Domain Endpoints
The branding endpoints manage tenant visual customization including logos, color schemes, theme presets, custom CSS, login page styling, and email branding. Served by TenantBrandingController at /api/v1/tenants/:tenantId/branding.
Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | .../branding | Get branding configuration |
| GET | .../branding/render | Get rendered branding for mode |
| POST | .../branding/initialize | Initialize with defaults |
| PUT | .../branding | Update branding |
| PUT | .../branding/logo | Update logo |
| PUT | .../branding/colors | Update color scheme |
| GET | .../branding/presets | Get available theme presets |
| POST | .../branding/presets/:presetName | Apply theme preset |
| PUT | .../branding/custom-css | Update custom CSS |
| PUT | .../branding/login-page | Update login page |
| PUT | .../branding/email | Update email branding |
| POST | .../branding/reset | Reset to defaults |
GET .../branding/render
Returns rendered branding for a specific display mode. Useful for clients that need resolved values.
| Parameter | Type | Default | Description |
|---|---|---|---|
darkMode | boolean | false | Whether to return dark mode colors |
Theme Presets
Available theme presets can be listed with GET .../branding/presets and applied with POST .../branding/presets/:presetName.
Applying a preset replaces the color scheme and typography settings while preserving logos and custom CSS.
Custom CSS
PUT .../branding/custom-css{
"css": ".sidebar { background: #1a1a2e; }",
"enabled": true
}Custom CSS is injected after the base theme styles, allowing tenants to override specific elements. The enabled flag controls whether the CSS is active.
Reset to Defaults
POST .../branding/resetRestores all branding settings to platform defaults. This operation cannot be undone.