---
title: "Update White-label Config"
method: PATCH
path: "/whitelabel/config"
tags: ["White-label"]
---

# Update White-label Config

`PATCH /whitelabel/config`

Update one or more branding fields. Hex colours validated as #RRGGBB; custom_domain validated as RFC-1035 subdomain. Setting custom_domain resets domain_verified=false; call /whitelabel/domain/verify after pointing your CNAME to api.astroway.info.

## Request body

- WhitelabelConfigPatch
  - `primaryColor` string
  - `secondaryColor` string
  - `fontFamily` string
  - `footerText` string, nullable
  - `customDomain` string, nullable

## Response `200`

Successful calculation

- object
  - `ok` boolean
  - `data` object
    - `primary_color` string, nullable
    - `secondary_color` string, nullable
    - `font_family` string, nullable
    - `footer_text` string, nullable
    - `custom_domain` string, nullable
    - `domain_verified` boolean, nullable
    - `domain_last_checked_at` unknown
    - `logo_storage_key` unknown
    - `updated_at` string, nullable

## Other responses

- `400` — Validation error
- `401` — Missing or invalid API key

## Changes

- **2026-08-24** `8ab5a768b521` — 2 breaking
  - the `data/domain_last_checked_at` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - the `data/logo_storage_key` response's property type/format changed from `object`/`` to ``/`` for status `200`
- **2026-08-22** `5a17388652f3` — 1 breaking
  - added required request body

[Change history](https://skmtc.dev/astroway/apis/astroway-calculation-api/changes/whitelabel/config/patch.md)

---

[API](https://skmtc.dev/astroway/apis/astroway-calculation-api.md) · [All operations](https://skmtc.dev/astroway/apis/astroway-calculation-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/astroway/astroway-calculation-api/revisions/8ab5a768b521/schema)