---
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 7 of 75 revisions.

- **2026-06-30** `164458859caa` — 8 info
- **2026-06-23** `bb5e056b7c6d` — 2 warning, 2 info
- **2026-05-05** `9296070059c5` — 2 info
- **2026-03-16** `377981ac9f14` — 1 breaking, 3 info
- **2026-01-20** `7bc7400170e0` — 2 info
- **2025-12-22** `5e6b2a1afead` — 3 breaking
- **2025-12-03** `581456e3279f` — 1 info

## Changes

- **2026-06-30** `164458859caa` — 8 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 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
- **2026-06-23** `bb5e056b7c6d` — 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-05** `9296070059c5` — 2 info
  - added the new optional request property `topic_aliases`
  - added the optional property `topic_aliases` to the response with the `201` status
- **2026-03-16** `377981ac9f14` — 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-01-20** `7bc7400170e0` — 2 info
  - the `description` request property default value `` was added
  - the `description` response's property default value `` was added for the status `201`
- **2025-12-22** `5e6b2a1afead` — 3 breaking
  - 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 `destination/anyOf[#/components/schemas/BackendClusterReferenceById]/id` request property's minLength was increased from `0` to `1`
- **2025-12-03** `581456e3279f` — 1 info
  - endpoint added

---

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