---
title: "Changes to Replace a portal product version"
method: PUT
path: "/v2/portals/{portalId}/product-versions/{productVersionId}"
---

# Changes to Replace a portal product version

`PUT /v2/portals/{portalId}/product-versions/{productVersionId}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 10 of 71 revisions.

- **2026-10-23** `30af8b28f6ef`: 1 breaking, 2 warning
- **2026-09-30** `f530bf400198`: 3 warning
- **2026-09-25** `4a02153f2e60`: 3 breaking, 24 info
- **2026-02-16** `2b2a72c67bd2`: 1 info
- **2025-10-29** `19e869275e28`: 1 warning
- **2025-08-22** `96118a9cd7f4`: 9 breaking, 2 info
- **2025-02-10** `d833d4dbb1fa`: 1 warning, 2 info
- **2024-11-11** `08ead66e9ebb`: 1 breaking, 2 warning, 1 info
- **2024-06-14** `d13649e1346b`: 1 breaking, 38 info
- **2024-05-14** `e583d17413fc`: 1 info

## Changes

- **2026-10-23** `30af8b28f6ef`: 1 breaking, 2 warning
  - 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`
- **2026-09-30** `f530bf400198`: 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-25** `4a02153f2e60`: 3 breaking, 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 `#/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-02-16** `2b2a72c67bd2`: 1 info
  - added the optional property `auth_strategies/items/oneOf[#/components/schemas/AuthStrategyKeyAuth]/ttl` to the response with the `200` status
- **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`: 9 breaking, 2 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 `status` became nullable for the status `401`
  - the response property `title` became nullable for the status `401`
  - the `name` response's property default value `name` was added for the status `200`
  - the `name` response's property default value `name` was added for the status `200`
- **2025-02-10** `d833d4dbb1fa`: 1 warning, 2 info
  - 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`
  - added the optional property `auth_strategies/items/oneOf[#/components/schemas/AuthStrategyClientCredentials]/available_scopes` to the response with the `200` status
  - added the required property `auth_strategies/items/oneOf[#/components/schemas/AuthStrategyKeyAuth]/key_names` to the response with the `200` status
- **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`
- **2024-06-14** `d13649e1346b`: 1 breaking, 38 info
  - added `#/components/schemas/InvalidParameterMinimumLength` to the `allOf[subschema #2]/invalid_parameters/items/` response property `oneOf` list for the response status `400`
  - added the optional property `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterChoiceItem]/source` to the response with the `400` status
  - added the optional property `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterDependentItem]/source` to the response with the `400` status
  - the response property `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterChoiceItem]/choices` became required for the status `400`
  - the response property `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterChoiceItem]/rule` became required for the status `400`
  - the `name` response's property default value `name` was removed for the status `200`
  - the `name` response's property default value `name` was removed for the status `200`
  - removed the `enum` enum value from the `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterStandard]/rule` response property for the response status `400`
  - removed the `invalid` enum value from the `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterChoiceItem]/rule` response property for the response status `400`
  - removed the `is_arn` enum value from the `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterChoiceItem]/rule` response property for the response status `400`
  - removed the `is_array` enum value from the `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterChoiceItem]/rule` response property for the response status `400`
  - removed the `is_base64` enum value from the `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterChoiceItem]/rule` response property for the response status `400`
  - removed the `is_boolean` enum value from the `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterChoiceItem]/rule` response property for the response status `400`
  - removed the `is_date_time` enum value from the `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterChoiceItem]/rule` response property for the response status `400`
  - removed the `is_fqdn` enum value from the `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterChoiceItem]/rule` response property for the response status `400`
  - removed the `is_integer` enum value from the `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterChoiceItem]/rule` response property for the response status `400`
  - removed the `is_label` enum value from the `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterChoiceItem]/rule` response property for the response status `400`
  - removed the `is_null` enum value from the `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterChoiceItem]/rule` response property for the response status `400`
  - removed the `is_number` enum value from the `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterChoiceItem]/rule` response property for the response status `400`
  - removed the `is_object` enum value from the `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterChoiceItem]/rule` response property for the response status `400`
  - removed the `is_string` enum value from the `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterChoiceItem]/rule` response property for the response status `400`
  - removed the `is_supported_network_availability_zone_list` enum value from the `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterChoiceItem]/rule` response property for the response status `400`
  - removed the `is_supported_network_cidr_block` enum value from the `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterChoiceItem]/rule` response property for the response status `400`
  - removed the `is_supported_provider_region` enum value from the `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterChoiceItem]/rule` response property for the response status `400`
  - removed the `is_uuid` enum value from the `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterChoiceItem]/rule` response property for the response status `400`
  - removed the `matches_regex` enum value from the `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterChoiceItem]/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/InvalidParameterChoiceItem]/rule` response property for the response status `400`
  - removed the `min_digits` enum value from the `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterChoiceItem]/rule` response property for the response status `400`
  - removed the `min_digits` enum value from the `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterStandard]/rule` response property for the response status `400`
  - removed the `min_length` enum value from the `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterChoiceItem]/rule` response property for the response status `400`
  - removed the `min_length` enum value from the `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterStandard]/rule` response property for the response status `400`
  - removed the `min_lowercase` enum value from the `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterChoiceItem]/rule` response property for the response status `400`
  - removed the `min_lowercase` enum value from the `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterStandard]/rule` response property for the response status `400`
  - removed the `min_symbols` enum value from the `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterChoiceItem]/rule` response property for the response status `400`
  - removed the `min_symbols` enum value from the `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterStandard]/rule` response property for the response status `400`
  - removed the `min_uppercase` enum value from the `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterChoiceItem]/rule` response property for the response status `400`
  - removed the `min_uppercase` enum value from the `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterStandard]/rule` response property for the response status `400`
  - removed the `required` enum value from the `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterChoiceItem]/rule` response property for the response status `400`
  - removed the `unknown_property` enum value from the `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterChoiceItem]/rule` response property for the response status `400`
- **2024-05-14** `e583d17413fc`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/kong/apis/konnect-api/docs/v2/portals/:portalId/product-versions/:productVersionId/put.md) - [API](https://skmtc.dev/kong/apis/konnect-api.md) - [Page](https://skmtc.dev/kong/apis/konnect-api/changes/v2/portals/:portalId/product-versions/:productVersionId/put)
