Uptimeify Docs
Whitelabel

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)

FieldTypeDescription
productNamestring|nullProduct display name (1–80 chars). null clears it.
hideProductNamebooleanHide the product name in the UI
hideLogosbooleanHide all logos in the UI
themePrimarystring|nullPrimary theme color (hex or CSS variable). null clears it.
themeNeutralstring|nullNeutral/secondary theme color (hex or CSS variable). null clears it.

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 Unauthorized when not authenticated
  • 403 Forbidden when not an admin

List Domains

Returns all custom app domains for the organization. Only domains with role app are returned. Requires 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.

On this page

Request Body (all optional)Example (cURL)ResponseCommon errors