dashboards

Update org branding.

Partial update of the org's branding configuration. Only PRESENT keys change (omit a key to leave it unchanged; set a key to null to clear it). Requires the admin role (branding:manage). Unknown keys → 422. Logo fields (logoLight, logoDark) are read-only in this endpoint — managed via the upload API (DVT-328).

patch/v1/orgs/{orgId}/branding

Request

Base URL: http://localhost:8080
URL: http://localhost:8080/v1/orgs/{orgId}/branding
Auth: one of:
- API key in cookie dvt_session
- HTTP bearer

Query parameters

reasonstring

Optional change note (the "why") recorded in the organization's audit log entry (DVT-5309); 1–280 characters. May also be supplied via the X-Dvt-Change-Reason header. Over-cap values return 400.

Request body

appNamestring nullable

Custom application name. Null to revert to "dvt".

accentColorstring nullable

Accent color — hex/rgb()/hsl() literal, CSS named color, or {token.ref}. CSS resource functions are rejected (ADR-0032 §2). Null to revert to dvt default.

themeTokensobject nullable

Theme-token map (ADR-0032 §A3). Null to clear all token overrides.

homeTargetobject nullable

Custom home-page target (DVT-332). Null to revert to default home.

defaultAppearance'light' nullable

Org-level default appearance. Light only (the dark app shell was removed, DVT-5272); null reverts to light.

logoScalenumber float nullable

Header-logo size multiplier (1.0 = default). Null to revert to the default logo size.

chromeTextColorstring nullable

Manual override for the header/sidebar foreground text (DVT-332). Same color gate as accentColor. Null to clear the override (auto white/near-black by luminance).

showAppNameboolean nullable

Whether the product name renders in the header alongside a logo (DVT-332). Null to revert to the default (true).

Response

Updated branding configuration.

Changes

No recorded changes to this operation across all 1 revision of this API.