--- title: "Changes to Create Transit Gateway" method: POST path: "/v2/cloud-gateways/networks/{networkId}/transit-gateways" --- # Changes to Create Transit Gateway `POST /v2/cloud-gateways/networks/{networkId}/transit-gateways` > Every recorded change to this endpoint, newest first. ## Timeline Changed in 9 of 75 revisions. - **2026-03-16** `377981ac9f14` — 1 breaking, 1 info - **2026-03-11** `c5d7b6bc7ab1` — 2 info - **2026-01-20** `7bc7400170e0` — 1 breaking, 1 info - **2026-01-07** `41f50b46b442` — 5 warning - **2025-10-23** `8ab3ec3ed301` — 1 warning - **2025-08-22** `3c0154b2053a` — 19 breaking - **2025-08-14** `6333a0d3b095` — 15 breaking, 3 warning, 36 info - **2025-07-22** `76b0fefddb0d` — 35 breaking, 14 warning, 3 info - **2025-05-14** `87c135153b84` — 3 info ## Changes - **2026-03-16** `377981ac9f14` — 1 breaking, 1 info - added the new required request property `oneOf[subschema #5: Azure Virtual Hub Peering Gateway]/transit_gateway_attachment_config` - added the required property `oneOf[subschema #4: Azure Virtual Hub Peering Gateway]/transit_gateway_attachment_config` to the response with the `201` status - **2026-03-11** `c5d7b6bc7ab1` — 2 info - added the optional property `oneOf[subschema #1: AWS Transit Gateway]/transit_gateway_attachment_config/attachment_id` to the response with the `201` status - added the optional property `oneOf[subschema #2: AWS VPC Peering Gateway]/transit_gateway_attachment_config/peering_connection_id` to the response with the `201` status - **2026-01-20** `7bc7400170e0` — 1 breaking, 1 info - added `#/components/schemas/AzureVHubPeeringGatewayResponse` to the response body `oneOf` list for the response status `201` - added `#/components/schemas/CreateAzureVHubPeeringGateway` to the request body `oneOf` list - **2026-01-07** `41f50b46b442` — 5 warning - added the new `error` enum value to the `oneOf[subschema #1: AWS Transit Gateway]/state` response property for the response status `201` - added the new `error` enum value to the `oneOf[subschema #2: AWS VPC Peering Gateway]/state` response property for the response status `201` - added the new `error` enum value to the `oneOf[subschema #3: Azure Transit Gateway]/state` response property for the response status `201` - added the new `error` enum value to the `oneOf[subschema #4: GCP VPC Peering Transit Gateway]/state` response property for the response status `201` - added the new `error` enum value to the `oneOf[subschema #5: AWS Resource Endpoint Gateway]/state` response property for the response status `201` - **2025-10-23** `8ab3ec3ed301` — 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** `3c0154b2053a` — 19 breaking - 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 `oneOf[subschema #1: AWS Transit Gateway]/state_metadata/reason` became nullable for the status `201` - the response property `oneOf[subschema #1: AWS Transit Gateway]/state_metadata/reported_status` became nullable for the status `201` - the response property `oneOf[subschema #2: AWS VPC Peering Gateway]/state_metadata/reason` became nullable for the status `201` - the response property `oneOf[subschema #2: AWS VPC Peering Gateway]/state_metadata/reported_status` became nullable for the status `201` - the response property `oneOf[subschema #3: Azure Transit Gateway]/state_metadata/reason` became nullable for the status `201` - the response property `oneOf[subschema #3: Azure Transit Gateway]/state_metadata/reported_status` became nullable for the status `201` - the response property `oneOf[subschema #4: GCP VPC Peering Transit Gateway]/state_metadata/reason` became nullable for the status `201` - the response property `oneOf[subschema #4: GCP VPC Peering Transit Gateway]/state_metadata/reported_status` became nullable for the status `201` - the response property `oneOf[subschema #5: AWS Resource Endpoint Gateway]/state_metadata/reason` became nullable for the status `201` - the response property `oneOf[subschema #5: AWS Resource Endpoint Gateway]/state_metadata/reported_status` became nullable for the status `201` - the response property `status` became nullable for the status `401` - the response property `title` became nullable for the status `401` - **2025-08-14** `6333a0d3b095` — 15 breaking, 3 warning, 36 info - added the new required request property `oneOf[#/components/schemas/CreateAwsTransitGateway -> subschema #1: AWS Transit Gateway]/cidr_blocks` - added the new required request property `oneOf[#/components/schemas/CreateAwsTransitGateway -> subschema #1: AWS Transit Gateway]/name` - added the new required request property `oneOf[#/components/schemas/CreateAwsTransitGateway -> subschema #1: AWS Transit Gateway]/transit_gateway_attachment_config` - added the new required request property `oneOf[#/components/schemas/CreateAwsVpcPeeringGateway -> subschema #2: AWS VPC Peering Gateway]/cidr_blocks` - added the new required request property `oneOf[#/components/schemas/CreateAwsVpcPeeringGateway -> subschema #2: AWS VPC Peering Gateway]/name` - added the new required request property `oneOf[#/components/schemas/CreateAwsVpcPeeringGateway -> subschema #2: AWS VPC Peering Gateway]/transit_gateway_attachment_config` - added the new required request property `oneOf[#/components/schemas/CreateAzureTransitGateway -> subschema #4: Azure Transit Gateway]/name` - added the new required request property `oneOf[#/components/schemas/CreateAzureTransitGateway -> subschema #4: Azure Transit Gateway]/transit_gateway_attachment_config` - the `oneOf[#/components/schemas/CreateAwsTransitGateway -> subschema #1: AWS Transit Gateway]/` request property type changed from no type to `object` - the `oneOf[#/components/schemas/CreateAwsVpcPeeringGateway -> subschema #2: AWS VPC Peering Gateway]/` request property type changed from no type to `object` - the `oneOf[#/components/schemas/CreateAzureTransitGateway -> subschema #4: Azure Transit Gateway]/` request property type changed from no type to `object` - added `#/components/schemas/GCPVPCPeeringGatewayResponse, #/components/schemas/AwsResourceEndpointGatewayResponse` to the response body `oneOf` list for the response status `201` - the `oneOf[#/components/schemas/AwsTransitGatewayResponse -> subschema #1: AWS Transit Gateway]/` response's property type changed from no type to `object` for status `201` - the `oneOf[#/components/schemas/AwsVpcPeeringGatewayResponse -> subschema #2: AWS VPC Peering Gateway]/` response's property type changed from no type to `object` for status `201` - the `oneOf[#/components/schemas/AzureTransitGatewayResponse -> subschema #3: Azure Transit Gateway]/` response's property type changed from no type to `object` for status `201` - removed `#/components/schemas/AwsTransitGateway, subschema #2, subschema #3` from the `oneOf[#/components/schemas/CreateAwsTransitGateway -> subschema #1: AWS Transit Gateway]/` request property `allOf` list - removed `#/components/schemas/AwsVpcPeeringGateway, subschema #2, subschema #3` from the `oneOf[#/components/schemas/CreateAwsVpcPeeringGateway -> subschema #2: AWS VPC Peering Gateway]/` request property `allOf` list - removed `#/components/schemas/AzureTransitGateway, subschema #2, subschema #3` from the `oneOf[#/components/schemas/CreateAzureTransitGateway -> subschema #4: Azure Transit Gateway]/` request property `allOf` list - added the new optional request property `oneOf[#/components/schemas/CreateAwsTransitGateway -> subschema #1: AWS Transit Gateway]/dns_config` - added the new optional request property `oneOf[#/components/schemas/CreateAwsVpcPeeringGateway -> subschema #2: AWS VPC Peering Gateway]/dns_config` - added the new optional request property `oneOf[#/components/schemas/CreateAzureTransitGateway -> subschema #4: Azure Transit Gateway]/dns_config` - added `#/components/schemas/CreateAwsResourceEndpointGateway, #/components/schemas/CreateGCPVPCPeeringTransitGateway` to the request body `oneOf` list - added the optional property `oneOf[#/components/schemas/AwsTransitGatewayResponse -> subschema #1: AWS Transit Gateway]/state_metadata` to the response with the `201` status - added the optional property `oneOf[#/components/schemas/AwsVpcPeeringGatewayResponse -> subschema #2: AWS VPC Peering Gateway]/state_metadata` to the response with the `201` status - added the optional property `oneOf[#/components/schemas/AzureTransitGatewayResponse -> subschema #3: Azure Transit Gateway]/state_metadata` to the response with the `201` status - removed `#/components/schemas/AwsTransitGateway, #/components/schemas/BaseTransitGatewayResponse, subschema #2` from the `oneOf[#/components/schemas/AwsTransitGatewayResponse -> subschema #1: AWS Transit Gateway]/` response property `allOf` list for the response status `201` - removed `#/components/schemas/AwsVpcPeeringGateway, #/components/schemas/BaseTransitGatewayResponse, subschema #2` from the `oneOf[#/components/schemas/AwsVpcPeeringGatewayResponse -> subschema #2: AWS VPC Peering Gateway]/` response property `allOf` list for the response status `201` - removed `#/components/schemas/AzureTransitGateway, #/components/schemas/BaseTransitGatewayResponse` from the `oneOf[#/components/schemas/AzureTransitGatewayResponse -> subschema #3: Azure Transit Gateway]/` response property `allOf` list for the response status `201` - added the required property `oneOf[#/components/schemas/AwsTransitGatewayResponse -> subschema #1: AWS Transit Gateway]/cidr_blocks` to the response with the `201` status - added the required property `oneOf[#/components/schemas/AwsTransitGatewayResponse -> subschema #1: AWS Transit Gateway]/created_at` to the response with the `201` status - added the required property `oneOf[#/components/schemas/AwsTransitGatewayResponse -> subschema #1: AWS Transit Gateway]/dns_config` to the response with the `201` status - added the required property `oneOf[#/components/schemas/AwsTransitGatewayResponse -> subschema #1: AWS Transit Gateway]/entity_version` to the response with the `201` status - added the required property `oneOf[#/components/schemas/AwsTransitGatewayResponse -> subschema #1: AWS Transit Gateway]/id` to the response with the `201` status - added the required property `oneOf[#/components/schemas/AwsTransitGatewayResponse -> subschema #1: AWS Transit Gateway]/name` to the response with the `201` status - added the required property `oneOf[#/components/schemas/AwsTransitGatewayResponse -> subschema #1: AWS Transit Gateway]/state` to the response with the `201` status - added the required property `oneOf[#/components/schemas/AwsTransitGatewayResponse -> subschema #1: AWS Transit Gateway]/transit_gateway_attachment_config` to the response with the `201` status - added the required property `oneOf[#/components/schemas/AwsTransitGatewayResponse -> subschema #1: AWS Transit Gateway]/updated_at` to the response with the `201` status - added the required property `oneOf[#/components/schemas/AwsVpcPeeringGatewayResponse -> subschema #2: AWS VPC Peering Gateway]/cidr_blocks` to the response with the `201` status - added the required property `oneOf[#/components/schemas/AwsVpcPeeringGatewayResponse -> subschema #2: AWS VPC Peering Gateway]/created_at` to the response with the `201` status - added the required property `oneOf[#/components/schemas/AwsVpcPeeringGatewayResponse -> subschema #2: AWS VPC Peering Gateway]/dns_config` to the response with the `201` status - …14 more - **2025-07-22** `76b0fefddb0d` — 35 breaking, 14 warning, 3 info - added `#/components/schemas/AwsTransitGateway, subschema #2, subschema #3` to the `oneOf[subschema #1: AWS Transit Gateway -> #/components/schemas/CreateAwsTransitGateway]/` request property `allOf` list - added `#/components/schemas/AwsVpcPeeringGateway, subschema #2, subschema #3` to the `oneOf[subschema #2: AWS VPC Peering Gateway -> #/components/schemas/CreateAwsVpcPeeringGateway]/` request property `allOf` list - added `#/components/schemas/AzureTransitGateway, subschema #2, subschema #3` to the `oneOf[subschema #3: Azure Transit Gateway -> #/components/schemas/CreateAzureTransitGateway]/` request property `allOf` list - the `oneOf[subschema #1: AWS Transit Gateway -> #/components/schemas/CreateAwsTransitGateway]/` request property type changed from `object` to no type - the `oneOf[subschema #2: AWS VPC Peering Gateway -> #/components/schemas/CreateAwsVpcPeeringGateway]/` request property type changed from `object` to no type - the `oneOf[subschema #3: Azure Transit Gateway -> #/components/schemas/CreateAzureTransitGateway]/` request property type changed from `object` to no type - the `oneOf[subschema #1: AWS Transit Gateway -> #/components/schemas/AwsTransitGatewayResponse]/` response's property type changed from `object` to no type for status `201` - the `oneOf[subschema #2: AWS VPC Peering Gateway -> #/components/schemas/AwsVpcPeeringGatewayResponse]/` response's property type changed from `object` to no type for status `201` - the `oneOf[subschema #3: Azure Transit Gateway -> #/components/schemas/AzureTransitGatewayResponse]/` response's property type changed from `object` to no type for status `201` - removed the required property `oneOf[subschema #1: AWS Transit Gateway -> #/components/schemas/AwsTransitGatewayResponse]/cidr_blocks` from the response with the `201` status - removed the required property `oneOf[subschema #1: AWS Transit Gateway -> #/components/schemas/AwsTransitGatewayResponse]/created_at` from the response with the `201` status - removed the required property `oneOf[subschema #1: AWS Transit Gateway -> #/components/schemas/AwsTransitGatewayResponse]/dns_config` from the response with the `201` status - removed the required property `oneOf[subschema #1: AWS Transit Gateway -> #/components/schemas/AwsTransitGatewayResponse]/entity_version` from the response with the `201` status - removed the required property `oneOf[subschema #1: AWS Transit Gateway -> #/components/schemas/AwsTransitGatewayResponse]/id` from the response with the `201` status - removed the required property `oneOf[subschema #1: AWS Transit Gateway -> #/components/schemas/AwsTransitGatewayResponse]/name` from the response with the `201` status - removed the required property `oneOf[subschema #1: AWS Transit Gateway -> #/components/schemas/AwsTransitGatewayResponse]/state` from the response with the `201` status - removed the required property `oneOf[subschema #1: AWS Transit Gateway -> #/components/schemas/AwsTransitGatewayResponse]/transit_gateway_attachment_config` from the response with the `201` status - removed the required property `oneOf[subschema #1: AWS Transit Gateway -> #/components/schemas/AwsTransitGatewayResponse]/updated_at` from the response with the `201` status - removed the required property `oneOf[subschema #2: AWS VPC Peering Gateway -> #/components/schemas/AwsVpcPeeringGatewayResponse]/cidr_blocks` from the response with the `201` status - removed the required property `oneOf[subschema #2: AWS VPC Peering Gateway -> #/components/schemas/AwsVpcPeeringGatewayResponse]/created_at` from the response with the `201` status - removed the required property `oneOf[subschema #2: AWS VPC Peering Gateway -> #/components/schemas/AwsVpcPeeringGatewayResponse]/dns_config` from the response with the `201` status - removed the required property `oneOf[subschema #2: AWS VPC Peering Gateway -> #/components/schemas/AwsVpcPeeringGatewayResponse]/entity_version` from the response with the `201` status - removed the required property `oneOf[subschema #2: AWS VPC Peering Gateway -> #/components/schemas/AwsVpcPeeringGatewayResponse]/id` from the response with the `201` status - removed the required property `oneOf[subschema #2: AWS VPC Peering Gateway -> #/components/schemas/AwsVpcPeeringGatewayResponse]/name` from the response with the `201` status - removed the required property `oneOf[subschema #2: AWS VPC Peering Gateway -> #/components/schemas/AwsVpcPeeringGatewayResponse]/state` from the response with the `201` status - removed the required property `oneOf[subschema #2: AWS VPC Peering Gateway -> #/components/schemas/AwsVpcPeeringGatewayResponse]/transit_gateway_attachment_config` from the response with the `201` status - removed the required property `oneOf[subschema #2: AWS VPC Peering Gateway -> #/components/schemas/AwsVpcPeeringGatewayResponse]/updated_at` from the response with the `201` status - removed the required property `oneOf[subschema #3: Azure Transit Gateway -> #/components/schemas/AzureTransitGatewayResponse]/created_at` from the response with the `201` status - removed the required property `oneOf[subschema #3: Azure Transit Gateway -> #/components/schemas/AzureTransitGatewayResponse]/dns_config` from the response with the `201` status - removed the required property `oneOf[subschema #3: Azure Transit Gateway -> #/components/schemas/AzureTransitGatewayResponse]/entity_version` from the response with the `201` status - removed the required property `oneOf[subschema #3: Azure Transit Gateway -> #/components/schemas/AzureTransitGatewayResponse]/id` from the response with the `201` status - removed the required property `oneOf[subschema #3: Azure Transit Gateway -> #/components/schemas/AzureTransitGatewayResponse]/name` from the response with the `201` status - removed the required property `oneOf[subschema #3: Azure Transit Gateway -> #/components/schemas/AzureTransitGatewayResponse]/state` from the response with the `201` status - removed the required property `oneOf[subschema #3: Azure Transit Gateway -> #/components/schemas/AzureTransitGatewayResponse]/transit_gateway_attachment_config` from the response with the `201` status - removed the required property `oneOf[subschema #3: Azure Transit Gateway -> #/components/schemas/AzureTransitGatewayResponse]/updated_at` from the response with the `201` status - removed the request property `oneOf[subschema #1: AWS Transit Gateway -> #/components/schemas/CreateAwsTransitGateway]/cidr_blocks` - removed the request property `oneOf[subschema #1: AWS Transit Gateway -> #/components/schemas/CreateAwsTransitGateway]/dns_config` - removed the request property `oneOf[subschema #1: AWS Transit Gateway -> #/components/schemas/CreateAwsTransitGateway]/name` - removed the request property `oneOf[subschema #1: AWS Transit Gateway -> #/components/schemas/CreateAwsTransitGateway]/transit_gateway_attachment_config` - removed the request property `oneOf[subschema #2: AWS VPC Peering Gateway -> #/components/schemas/CreateAwsVpcPeeringGateway]/cidr_blocks` - …12 more - **2025-05-14** `87c135153b84` — 3 info - added the optional property `oneOf[subschema #1: AWS Transit Gateway]/state_metadata` to the response with the `201` status - added the optional property `oneOf[subschema #2: AWS VPC Peering Gateway]/state_metadata` to the response with the `201` status - added the optional property `oneOf[subschema #3: Azure Transit Gateway]/state_metadata` to the response with the `201` status --- [Operation](https://skmtc.dev/kong/apis/konnect-api-go-sdk/docs/v2/cloud-gateways/networks/:networkId/transit-gateways/post.md) · [API](https://skmtc.dev/kong/apis/konnect-api-go-sdk.md) · [Page](https://skmtc.dev/kong/apis/konnect-api-go-sdk/changes/v2/cloud-gateways/networks/:networkId/transit-gateways/post)