---
title: "Replace a portal product version"
method: PUT
path: "/v2/portals/{portalId}/product-versions/{productVersionId}"
tags: ["Portal Product Versions"]
---

# Replace a portal product version

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

## Request

- Base URL: `https://global.api.konghq.com`
- URL: `https://global.api.konghq.com/v2/portals/{portalId}/product-versions/{productVersionId}`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer

Replace a portal product version

## Request body

- V2ReplacePortalProductVersionPayload: Payload to update a Portal Product Version
  - `publish_status` 'published' | 'unpublished', required: Publication status of the API product version on the portal
  - `auth_strategy_ids` UUIDRW[], required: A list of authentication strategy IDs
  - `application_registration_enabled` boolean, required: Whether the application registration on this portal for the api product version is enabled
  - `auto_approve_registration` boolean, required: Whether the application registration auto approval on this portal for the api product version is enabled
  - `deprecated` boolean, required: Whether the api product version on the portal is deprecated
  - `notify_developers` boolean: Whether to notify developers who are affected by this change

## Response `200`

A response containing a portal product version

- V2PortalProductVersion: A Portal Product Version holds metadata that describes how a Product Version is configured for a specific portal. It contains: - Lifecyle and deprecation statuses - Application registration settings like auto approve or whether application registration is enabled - The Authentication Strategy (if present) that is enabled for Application Registration
  - `id` string, uuid, required: Contains a unique identifier used for this resource.
  - `publish_status` 'published' | 'unpublished', required: Publication status of the API product version on the portal
  - `product_version_id` string, uuid, required: Contains a unique identifier used for this resource.
  - `created_at` string, date-time, required: An ISO-8601 timestamp representation of entity creation date.
  - `updated_at` string, date-time, required: An ISO-8601 timestamp representation of entity update date.
  - `auth_strategies` AuthStrategy[], required: A list of authentication strategies
    - union
      - object: KeyAuth Auth strategy that the application uses.
        - `id` string, uuid, required: The Application Auth Strategy ID.
        - `name` string, required
        - `credential_type` 'key_auth', required
        - `key_names` string[], required
        - `ttl` object, nullable: Default maximum Time-To-Live for keys created under this strategy.
          - `value` integer, required
          - `unit` 'days' | 'weeks' | 'years', required
      - object: Client Credential Auth strategy that the application uses.
        - `id` string, uuid, required: The Application Auth Strategy ID.
        - `name` string, required
        - `credential_type` 'client_credentials' | 'self_managed_client_credentials', required
        - `auth_methods` string[], required
        - `available_scopes` string[]: Possible developer selectable scopes for an application. Only present when using DCR Provider that supports it.
  - `application_registration_enabled` boolean, required: Whether the application registration on this portal for the api product version is enabled
  - `auto_approve_registration` boolean, required: Whether the application registration auto approval on this portal for the api product version is enabled
  - `deprecated` boolean, required: Whether the api product version on the portal is deprecated

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found

## 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`
  - …23 more
- …earlier changes not shown

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

---

[API](https://skmtc.dev/kong/apis/konnect-api.md) - [All operations](https://skmtc.dev/kong/apis/konnect-api/llms.txt) - [OpenAPI document](https://skmtc.dev/kong/apis/konnect-api/revisions/757a21fb79f2?raw)
