---
title: "Changes to Create API Product Version"
method: POST
path: "/v2/api-products/{apiProductId}/product-versions"
---

# Changes to Create API Product Version

`POST /v2/api-products/{apiProductId}/product-versions`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 7 of 52 revisions.

- **2025-10-29** `19e869275e28` — 1 warning
- **2025-08-22** `96118a9cd7f4` — 7 breaking, 3 info
- **2025-08-13** `ab1a51b76144` — 1 breaking
- **2025-03-13** `ddd4be7ea073` — 1 breaking, 1 info
- **2025-02-10** `d833d4dbb1fa` — 1 warning, 1 info
- **2024-11-11** `08ead66e9ebb` — 1 breaking, 2 warning, 1 info
- **2024-09-11** `be7c36317ba6` — 2 info

## Changes

- **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` — 7 breaking, 3 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 `gateway_service/runtime_group_id` became nullable for the status `201`
  - the response property `labels/additionalProperties/` became nullable for the status `201`
  - the request property `labels/additionalProperties/` became nullable
  - the `deprecated` request property default value `false` was added
  - the `publish_status` request property default value `unpublished` was added
- **2025-08-13** `ab1a51b76144` — 1 breaking
  - the request property `labels/additionalProperties/` became not nullable
- **2025-03-13** `ddd4be7ea073` — 1 breaking, 1 info
  - the response property `labels/additionalProperties/` became nullable for the status `201`
  - the request property `labels/additionalProperties/` became nullable
- **2025-02-10** `d833d4dbb1fa` — 1 warning, 1 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 non-success response with the status `409`
- **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-09-11** `be7c36317ba6` — 2 info
  - added the new optional request property `labels`
  - added the required property `labels` to the response with the `201` status

---

[Operation](https://skmtc.dev/kong/apis/konnect-api/docs/v2/api-products/:apiProductId/product-versions/post.md) · [API](https://skmtc.dev/kong/apis/konnect-api.md) · [Page](https://skmtc.dev/kong/apis/konnect-api/changes/v2/api-products/:apiProductId/product-versions/post)