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

# Changes to Get Appearance Configuration

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

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 5 of 56 revisions.

- **2026-09-30** `f530bf400198`: 2 warning
- **2026-09-25** `4a02153f2e60`: 2 breaking, 17 info
- **2026-08-04** `06734a9c491f`: 6 info
- **2025-08-22** `96118a9cd7f4`: 24 breaking
- **2025-08-13** `ab1a51b76144`: 2 info

## Changes

- **2026-09-30** `f530bf400198`: 2 warning
  - added the new `403.00` enum value to the `status` response property for the response status `403`
  - added the new `404.00` enum value to the `status` response property for the response status `404`
- **2026-09-25** `4a02153f2e60`: 2 breaking, 17 info
  - the response's body type changed from no type to `object` for status `403`
  - the response's body type changed from no type to `object` for status `404`
  - removed `#/components/schemas/BaseError, subschema #2` from the response body `allOf` list for the response status `401`
  - removed `#/components/schemas/BaseError, subschema #2` from the response body `allOf` list for the response status `403`
  - removed `#/components/schemas/BaseError, subschema #2` from the response body `allOf` list for the response status `404`
  - added the optional property `type` to the response with the `403` status
  - added the optional property `type` to the response with the `404` status
  - the response property `detail` became required for the status `401`
  - the response property `instance` became required for the status `401`
  - the response property `status` became required for the status `401`
  - the response property `title` became required for the status `401`
  - added the required property `detail` to the response with the `403` status
  - added the required property `detail` to the response with the `404` status
  - added the required property `instance` to the response with the `403` status
  - added the required property `instance` to the response with the `404` status
  - added the required property `status` to the response with the `403` status
  - added the required property `status` to the response with the `404` status
  - added the required property `title` to the response with the `403` status
  - added the required property `title` to the response with the `404` status
- **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-08-22** `96118a9cd7f4`: 24 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 `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`

---

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