consent_config_theme_upsert
Adapts the consent banner's appearance to the site's brand.
Adapts the consent banner's appearance to the site's brand. Pass what you observe on the client's site: brandColor — the site's primary brand color (any CSS color); surface — whether the site is "light" or "dark"; corners — button corner shape ("sharp" / "rounded" / "pill"); font — the site's font, given as a font name, a full CSS font stack, or "inherit" to adopt the host page's font. If the brand tokens are not enough, fine-tune `overrides`: backgroundColor, textColor, primaryTextColor, borderColor, focusColor, dangerColor, successColor, warningColor. primaryTextColor sets the text on the primary button; without it that text is derived from primaryColor. Fails when: primaryTextColor contrasts below 3.0:1 against the effective primaryColor — the patch is rejected, naming the computed ratio. All fields are optional and patch-merge onto the previous theme. To identify the site: use a URL from the request; otherwise the latest decision `pageUrl`; otherwise ask the user once. This layer is cosmetic only — after applying, "Accept all" and "Reject all" stay equally prominent and the provider list is unchanged.
Behavior
- HTTP
PATCH /consent/config/theme
Arguments
Name | Type | Required | Description |
|---|---|---|---|
font | string | — | No description in the catalog. |
corners | string | — | No description in the catalog. |
surface | string | — | No description in the catalog. |
overrides | object | — | No description in the catalog. |
brandColor | string | — | No description in the catalog. |
Response
Field | Type | Always | Description |
|---|---|---|---|
theme | object | • | |
themeInput | object | • |
Try it
Adapts the consent banner's appearance to the site's brand.