whitelabel/patch
Tool: update
Update whitelabel branding settings for the authenticated organization.
All fields are optional. To read the current settings without changing anything, send an empty body — the response returns the current state. Requires organization admin permissions. To clear a field — and to know why null fails — see call-contract.
customDomainis validated upstream. An invalid domain is rejected with an in-body error (surfaced by this server asstatus: "error"even though the HTTP status is 200); re-check the domain format and retry.
coloris length-validated upstream (max 128 chars).logoImageUrlmax 512 chars.customDomainmax 64 chars.
Body
| field | type | req | constraints | description |
|---|---|---|---|---|
| color | string | – | ≤128 chars | Primary color for the whitelabel UI (color name or code). |
| customDomain | string | – | ≤64 chars | Custom domain — validated upstream; invalid formats are rejected with an in-body error. |
| logoImageUrl | string | – | ≤512 chars | URL to the logo image displayed in the interface. |
Response
200 — Current/updated whitelabel state.
| field | type | description |
|---|---|---|
| color | string | Current color setting. |
| customDomain | string | Current custom domain. |
| logoImageUrl | string | Current logo image URL. |
Errors: 400, 401, 406, 415, 422, 429, 500 — shared schema: schemas/errors.
Invoke
Call update with name: "whitelabel/patch".