---
title: "Changes to Create Virtual Cluster"
method: POST
path: "/v1/event-gateways/{gatewayId}/virtual-clusters"
---

# Changes to Create Virtual Cluster

`POST /v1/event-gateways/{gatewayId}/virtual-clusters`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 8 of 30 revisions.

- **2026-06-26** `73b05fbfd2ef` — 2 warning, 2 info
- **2026-05-20** `55d91b8ceecd` — 10 info
- **2026-03-27** `2322191a98f7` — 1 breaking, 3 info
- **2026-02-16** `106b373707f3` — 2 breaking, 2 info
- **2025-11-06** `5d2b35832e3f` — 6 breaking, 2 warning, 5 info
- **2025-10-17** `564d63b800a1` — 3 breaking
- **2025-10-08** `be46646a0f0a` — 9 breaking, 1 warning, 9 info
- **2025-10-02** `ecce2daf9de6` — 1 info

## Changes

- **2026-06-26** `73b05fbfd2ef` — 2 warning, 2 info
  - removed the request property `topic_aliases/items/match`
  - removed the optional property `topic_aliases/items/match` from the response with the `201` status
  - added the new optional request property `topic_aliases/items/condition`
  - added the optional property `topic_aliases/items/condition` to the response with the `201` status
- **2026-05-20** `55d91b8ceecd` — 10 info
  - added the new optional request property `authentication/items/oneOf[#/components/schemas/VirtualClusterAuthenticationClientCertificate]/fetch_kong_identity_principal`
  - added the new optional request property `authentication/items/oneOf[#/components/schemas/VirtualClusterAuthenticationOauthBearer]/fetch_kong_identity_principal`
  - added the new optional request property `authentication/items/oneOf[#/components/schemas/VirtualClusterAuthenticationSaslPlain]/fetch_kong_identity_principal`
  - added the new optional request property `authentication/items/oneOf[#/components/schemas/VirtualClusterAuthenticationSaslScram]/fetch_kong_identity_principal`
  - added the new optional request property `topic_aliases`
  - added the optional property `authentication/items/oneOf[#/components/schemas/VirtualClusterAuthenticationClientCertificate]/fetch_kong_identity_principal` to the response with the `201` status
  - added the optional property `authentication/items/oneOf[#/components/schemas/VirtualClusterAuthenticationOauthBearer]/fetch_kong_identity_principal` to the response with the `201` status
  - added the optional property `authentication/items/oneOf[#/components/schemas/VirtualClusterAuthenticationSaslPlainSensitiveDataAware]/fetch_kong_identity_principal` to the response with the `201` status
  - added the optional property `authentication/items/oneOf[#/components/schemas/VirtualClusterAuthenticationSaslScram]/fetch_kong_identity_principal` to the response with the `201` status
  - added the optional property `topic_aliases` to the response with the `201` status
- **2026-03-27** `2322191a98f7` — 1 breaking, 3 info
  - added `#/components/schemas/VirtualClusterAuthenticationClientCertificate` to the `authentication/items/` response property `oneOf` list for the response status `201`
  - added `client_certificate` discriminator mapping keys to the `authentication/items/` request property
  - added `#/components/schemas/VirtualClusterAuthenticationClientCertificate` to the `authentication/items/` request property `oneOf` list
  - added `client_certificate` discriminator mapping keys to the `authentication/items/` response property for the response status `201`
- **2026-02-16** `106b373707f3` — 2 breaking, 2 info
  - the `authentication/items/oneOf[#/components/schemas/VirtualClusterAuthenticationSaslPlain]/principals/items/password` request property's minLength was increased from `0` to `1`
  - the `authentication/items/oneOf[#/components/schemas/VirtualClusterAuthenticationSaslPlain]/principals/items/username` request property's minLength was increased from `0` to `1`
  - the `description` request property default value `` was added
  - the `description` response's property default value `` was added for the status `201`
- **2025-11-06** `5d2b35832e3f` — 6 breaking, 2 warning, 5 info
  - the request property `authentication/items/oneOf[#/components/schemas/VirtualClusterAuthenticationSaslPlain]/principals/items/password` became required
  - the request property `authentication/items/oneOf[#/components/schemas/VirtualClusterAuthenticationSaslPlain]/principals/items/username` became required
  - the `authentication/items/oneOf[#/components/schemas/VirtualClusterAuthenticationSaslPlain]/principals` request property's minItems was increased to `1`
  - added the pattern `^[A-Za-z0-9._?*-]+$` to the request property `namespace/additional/consumer_groups/items/oneOf[#/components/schemas/VirtualClusterNamespaceIdSelectorGlob]/glob`
  - added the pattern `^[A-Za-z0-9._?*-]+$` to the request property `namespace/additional/topics/items/oneOf[#/components/schemas/VirtualClusterNamespaceTopicSelectorGlob]/glob`
  - added `#/components/schemas/VirtualClusterAuthenticationSaslPlainSensitiveDataAware` to the `authentication/items/` response property `oneOf` list for the response status `201`
  - changed the pattern of the request property `dns_label` from `^[a-z]([-a-z0-9]*[a-z0-9])?$` to `^[a-z0-9]([-a-z0-9]*[a-z0-9])?$`
  - 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`
  - mapped value for discriminator key `sasl_plain` changed from `#/components/schemas/VirtualClusterAuthenticationSaslPlain` to `#/components/schemas/VirtualClusterAuthenticationSaslPlainSensitiveDataAware` for `authentication/items/` response property for the response status `201`
  - removed `#/components/schemas/VirtualClusterAuthenticationSaslPlain` from the `authentication/items/` response property `oneOf` list for the response status `201`
  - the `namespace/additional/consumer_groups/items/oneOf[#/components/schemas/VirtualClusterNamespaceIdSelectorGlob]/glob` response's property pattern `^[A-Za-z0-9._?*-]+$` was added for the status `201`
  - the `namespace/additional/topics/items/oneOf[#/components/schemas/VirtualClusterNamespaceTopicSelectorGlob]/glob` response's property pattern `^[A-Za-z0-9._?*-]+$` was added for the status `201`
  - the `dns_label` response's property pattern was changed from `^[a-z]([-a-z0-9]*[a-z0-9])?$` to `^[a-z0-9]([-a-z0-9]*[a-z0-9])?$` for the status `201`
- **2025-10-17** `564d63b800a1` — 3 breaking
  - the request property `description` became not nullable
  - the request property `namespace/additional/consumer_groups` became not nullable
  - the request property `namespace/additional/topics` became not nullable
- **2025-10-08** `be46646a0f0a` — 9 breaking, 1 warning, 9 info
  - added the new required request property `acl_mode`
  - the `type` request property const value `exact_list` was added
  - the `type` request property const value `exact_list` was added
  - the `type` request property const value `glob` was added
  - the `type` request property const value `glob` was added
  - removed the enum value `exact_list` of the request property `namespace/additional/consumer_groups/items/oneOf[#/components/schemas/VirtualClusterNamespaceIdSelectorExactList]/type`
  - removed the enum value `exact_list` of the request property `namespace/additional/topics/items/oneOf[#/components/schemas/VirtualClusterNamespaceTopicSelectorExactList]/type`
  - removed the enum value `glob` of the request property `namespace/additional/consumer_groups/items/oneOf[#/components/schemas/VirtualClusterNamespaceIdSelectorGlob]/type`
  - removed the enum value `glob` of the request property `namespace/additional/topics/items/oneOf[#/components/schemas/VirtualClusterNamespaceTopicSelectorGlob]/type`
  - removed the request property `destination/name`
  - the `type` response property const value `exact_list` was added for the status `201`
  - the `type` response property const value `exact_list` was added for the status `201`
  - the `type` response property const value `glob` was added for the status `201`
  - the `type` response property const value `glob` was added for the status `201`
  - removed the `exact_list` enum value from the `namespace/additional/consumer_groups/items/oneOf[#/components/schemas/VirtualClusterNamespaceIdSelectorExactList]/type` response property for the response status `201`
  - removed the `exact_list` enum value from the `namespace/additional/topics/items/oneOf[#/components/schemas/VirtualClusterNamespaceTopicSelectorExactList]/type` response property for the response status `201`
  - removed the `glob` enum value from the `namespace/additional/consumer_groups/items/oneOf[#/components/schemas/VirtualClusterNamespaceIdSelectorGlob]/type` response property for the response status `201`
  - removed the `glob` enum value from the `namespace/additional/topics/items/oneOf[#/components/schemas/VirtualClusterNamespaceTopicSelectorGlob]/type` response property for the response status `201`
  - added the required property `acl_mode` to the response with the `201` status
- **2025-10-02** `ecce2daf9de6` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/kong/apis/konnect-api-beta/docs/v1/event-gateways/:gatewayId/virtual-clusters/post.md) · [API](https://skmtc.dev/kong/apis/konnect-api-beta.md) · [Page](https://skmtc.dev/kong/apis/konnect-api-beta/changes/v1/event-gateways/:gatewayId/virtual-clusters/post)
