---
title: "Changes to Replace Customization"
method: PUT
path: "/v3/portals/{portalId}/customization"
---

# Changes to Replace Customization

`PUT /v3/portals/{portalId}/customization`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 12 of 87 revisions.

- **2026-10-15** `7aab863a6daa`: 1 breaking, 2 warning, 2 info
- **2026-10-07** `59663dd13a10`: 4 info
- **2026-09-25** `68d43091b84d`: 3 warning
- **2026-09-18** `f324fb7610e4`: 3 breaking, 2 warning, 24 info
- **2026-09-07** `d2254a6fbee0`: 2 info
- **2025-10-30** `845120e19d45`: 7 breaking
- **2025-10-23** `8ab3ec3ed301`: 1 warning
- **2025-09-11** `396c243e49dc`: 2 info
- **2025-08-22** `3c0154b2053a`: 16 breaking, 19 info
- **2025-08-14** `6333a0d3b095`: 12 info
- **2025-07-22** `76b0fefddb0d`: 8 info
- **2025-07-01** `9a3d26a00088`: 1 info

## Changes

- **2026-10-15** `7aab863a6daa`: 1 breaking, 2 warning, 2 info
  - added `#/components/schemas/InvalidParameterMinimumTime, #/components/schemas/InvalidParameterMaximumTime` to the `invalid_parameters/items/` response property `oneOf` list for the response status `400`
  - added the new `key_invalid` enum value to the `invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterStandard]/rule` response property for the response status `400`
  - added the new `unique` enum value to the `invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterStandard]/rule` response property for the response status `400`
  - added the new optional request property `spec_renderer/try_it_ui_audience`
  - added the optional property `spec_renderer/try_it_ui_audience` to the response with the `200` status
- **2026-10-07** `59663dd13a10`: 4 info
  - the `name` request property default value `ocean` was added
  - request property `layout` deprecated
  - the `name` response's property default value `ocean` was added for the status `200`
  - response property `layout` deprecated
- **2026-09-25** `68d43091b84d`: 3 warning
  - added the new `400.00` enum value to the `status` response property for the response status `400`
  - 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-18** `f324fb7610e4`: 3 breaking, 2 warning, 24 info
  - the response's body type changed from no type to `object` for status `400`
  - 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 the request property `spec_renderer/try_it_ui_audience`
  - removed the optional property `spec_renderer/try_it_ui_audience` from the response with the `200` status
  - removed `#/components/schemas/BaseError, subschema #2` from the response body `allOf` list for the response status `400`
  - 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 `400` status
  - 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 `400` status
  - 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 `400` 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 `invalid_parameters` to the response with the `400` status
  - added the required property `status` to the response with the `400` 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 `400` 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-09-07** `d2254a6fbee0`: 2 info
  - added the new optional request property `spec_renderer/try_it_ui_audience`
  - added the optional property `spec_renderer/try_it_ui_audience` to the response with the `200` status
- **2025-10-30** `845120e19d45`: 7 breaking
  - the request property `menu` became not nullable
  - the request property `menu/footer_bottom` became not nullable
  - the request property `menu/footer_sections` became not nullable
  - the request property `menu/main` became not nullable
  - the request property `spec_renderer` became not nullable
  - the request property `theme` became not nullable
  - the request property `theme/colors` became not nullable
- **2025-10-23** `8ab3ec3ed301`: 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-09-11** `396c243e49dc`: 2 info
  - added the new optional request property `spec_renderer/allow_custom_server_urls`
  - added the optional property `spec_renderer/allow_custom_server_urls` to the response with the `200` status
- **2025-08-22** `3c0154b2053a`: 16 breaking, 19 info
  - 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 `menu` became nullable for the status `200`
  - the response property `menu/footer_bottom` became nullable for the status `200`
  - the response property `menu/footer_sections` became nullable for the status `200`
  - the response property `menu/main` became nullable for the status `200`
  - the response property `spec_renderer` became nullable for the status `200`
  - the response property `status` became nullable for the status `401`
  - the response property `theme` became nullable for the status `200`
  - the response property `theme/colors` became nullable for the status `200`
  - the response property `title` became nullable for the status `401`
  - the request property `menu` became nullable
  - the request property `menu/footer_bottom` became nullable
  - the request property `menu/footer_sections` became nullable
  - the request property `menu/main` became nullable
  - the request property `spec_renderer` became nullable
  - the request property `theme` became nullable
  - the request property `theme/colors` became nullable
  - the `hide_deprecated` request property default value `false` was added
  - the `hide_internal` request property default value `false` was added
  - the `infinite_scroll` request property default value `true` was added
  - the `show_schemas` request property default value `true` was added
  - the `try_it_insomnia` request property default value `true` was added
  - the `try_it_ui` request property default value `true` was added
  - the `hide_deprecated` response's property default value `false` was added for the status `200`
  - the `hide_internal` response's property default value `false` was added for the status `200`
  - the `infinite_scroll` response's property default value `true` was added for the status `200`
  - the `show_schemas` response's property default value `true` was added for the status `200`
  - the `try_it_insomnia` response's property default value `true` was added for the status `200`
  - the `try_it_ui` response's property default value `true` was added for the status `200`
- **2025-08-14** `6333a0d3b095`: 12 info
  - added the new optional request property `spec_renderer/hide_deprecated`
  - added the new optional request property `spec_renderer/hide_internal`
  - the `infinite_scroll` request property default value `true` was removed
  - the `show_schemas` request property default value `true` was removed
  - the `try_it_insomnia` request property default value `true` was removed
  - the `try_it_ui` request property default value `true` was removed
  - added the optional property `spec_renderer/hide_deprecated` to the response with the `200` status
  - added the optional property `spec_renderer/hide_internal` to the response with the `200` status
  - the `infinite_scroll` response's property default value `true` was removed for the status `200`
  - the `show_schemas` response's property default value `true` was removed for the status `200`
  - the `try_it_insomnia` response's property default value `true` was removed for the status `200`
  - the `try_it_ui` response's property default value `true` was removed for the status `200`
- **2025-07-22** `76b0fefddb0d`: 8 info
  - the `infinite_scroll` request property default value `true` was added
  - the `show_schemas` request property default value `true` was added
  - the `try_it_insomnia` request property default value `true` was added
  - the `try_it_ui` request property default value `true` was added
  - the `infinite_scroll` response's property default value `true` was added for the status `200`
  - the `show_schemas` response's property default value `true` was added for the status `200`
  - the `try_it_insomnia` response's property default value `true` was added for the status `200`
  - the `try_it_ui` response's property default value `true` was added for the status `200`
- **2025-07-01** `9a3d26a00088`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/kong/apis/konnect-api-go-sdk/docs/v3/portals/:portalId/customization/put.md) · [API](https://skmtc.dev/kong/apis/konnect-api-go-sdk.md) · [Page](https://skmtc.dev/kong/apis/konnect-api-go-sdk/changes/v3/portals/:portalId/customization/put)
