---
title: "Changes to Update Appearance Configuration"
method: PATCH
path: "/v2/portals/{portalId}/appearance"
---

# Changes to Update Appearance Configuration

`PATCH /v2/portals/{portalId}/appearance`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 6 of 52 revisions.

- **2026-08-04** `06734a9c491f` — 6 info
- **2025-10-29** `19e869275e28` — 1 warning
- **2025-08-22** `96118a9cd7f4` — 29 breaking
- **2025-08-13** `ab1a51b76144` — 2 info
- **2025-02-10** `d833d4dbb1fa` — 1 warning
- **2024-11-11** `08ead66e9ebb` — 1 breaking, 2 warning, 1 info

## Changes

- **2026-08-04** `06734a9c491f` — 6 info
  - response property `allOf[#/components/schemas/V2PortalAppearance]/custom_fonts` deprecated
  - response property `allOf[#/components/schemas/V2PortalAppearance]/custom_theme` deprecated
  - response property `allOf[#/components/schemas/V2PortalAppearance]/images` deprecated
  - response property `allOf[#/components/schemas/V2PortalAppearance]/text` deprecated
  - response property `allOf[#/components/schemas/V2PortalAppearance]/theme_name` deprecated
  - response property `allOf[#/components/schemas/V2PortalAppearance]/use_custom_fonts` deprecated
- **2025-10-29** `19e869275e28` — 1 warning
  - added the new `type` enum value to the `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterStandard]/rule` response property for the response status `400`
- **2025-08-22** `96118a9cd7f4` — 29 breaking
  - the response property `allOf[#/components/schemas/V2PortalAppearance]/custom_theme/colors/button/primary_fill/description` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/V2PortalAppearance]/custom_theme/colors/button/primary_text/description` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/V2PortalAppearance]/custom_theme/colors/section/accent/description` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/V2PortalAppearance]/custom_theme/colors/section/body/description` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/V2PortalAppearance]/custom_theme/colors/section/footer/description` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/V2PortalAppearance]/custom_theme/colors/section/header/description` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/V2PortalAppearance]/custom_theme/colors/section/hero/description` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/V2PortalAppearance]/custom_theme/colors/section/stroke/description` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/V2PortalAppearance]/custom_theme/colors/section/tertiary/description` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/V2PortalAppearance]/custom_theme/colors/text/accent/description` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/V2PortalAppearance]/custom_theme/colors/text/footer/description` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/V2PortalAppearance]/custom_theme/colors/text/header/description` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/V2PortalAppearance]/custom_theme/colors/text/headings/description` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/V2PortalAppearance]/custom_theme/colors/text/hero/description` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/V2PortalAppearance]/custom_theme/colors/text/link/description` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/V2PortalAppearance]/custom_theme/colors/text/primary/description` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/V2PortalAppearance]/custom_theme/colors/text/secondary/description` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/V2PortalAppearance]/images/catalog_cover/filename` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/V2PortalAppearance]/images/favicon/filename` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/V2PortalAppearance]/images/logo/filename` became nullable for the status `200`
  - the response property `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterChoiceItem]/source` became nullable for the status `400`
  - the response property `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterDependentItem]/source` became nullable for the status `400`
  - the response property `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterMaximumLength]/source` became nullable for the status `400`
  - the response property `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterMinimumLength]/source` became nullable for the status `400`
  - the response property `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterStandard]/source` became nullable for the status `400`
  - the response property `detail` became nullable for the status `401`
  - the response property `instance` became nullable for the status `401`
  - the response property `status` became nullable for the status `401`
  - the response property `title` became nullable for the status `401`
- **2025-08-13** `ab1a51b76144` — 2 info
  - added `#/components/schemas/V2PortalAppearance` to the response body `allOf` list for the response status `200`
  - removed `#/components/schemas/PortalAppearance` from the response body `allOf` list for the response status `200`
- **2025-02-10** `d833d4dbb1fa` — 1 warning
  - added the new `missing_reference` enum value to the `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterStandard]/rule` response property for the response status `400`
- **2024-11-11** `08ead66e9ebb` — 1 breaking, 2 warning, 1 info
  - added `#/components/schemas/InvalidParameterMaximumLength` to the `allOf[subschema #2]/invalid_parameters/items/` response property `oneOf` list for the response status `400`
  - added the new `min` enum value to the `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterMinimumLength]/rule` response property for the response status `400`
  - added the new `min_items` enum value to the `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterMinimumLength]/rule` response property for the response status `400`
  - removed the `max_length` enum value from the `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterStandard]/rule` response property for the response status `400`

---

[Operation](https://skmtc.dev/kong/apis/konnect-api/docs/v2/portals/:portalId/appearance/patch.md) · [API](https://skmtc.dev/kong/apis/konnect-api.md) · [Page](https://skmtc.dev/kong/apis/konnect-api/changes/v2/portals/:portalId/appearance/patch)