---
title: "Changes to Create a new Route"
method: POST
path: "/v2/control-planes/{controlPlaneId}/core-entities/routes"
---

# Changes to Create a new Route

`POST /v2/control-planes/{controlPlaneId}/core-entities/routes`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 87 revisions.

- **2026-04-17** `c80d57ed14ab`: 4 info
- **2025-10-30** `845120e19d45`: 4 breaking
- **2025-09-16** `ddf026fbd25b`: 2 breaking, 6 warning
- **2025-08-22** `3c0154b2053a`: 4 breaking, 32 info
- **2025-08-14** `6333a0d3b095`: 28 info
- **2025-07-22** `76b0fefddb0d`: 2 breaking, 30 info

## Changes

- **2026-04-17** `c80d57ed14ab`: 4 info
  - the `protocols` request property default value changed from `http, https` to `https`
  - the `protocols` request property default value changed from `http, https` to `https`
  - the `protocols` response's property default value changed from `http, https` to `https` for the status `201`
  - the `protocols` response's property default value changed from `http, https` to `https` for the status `201`
- **2025-10-30** `845120e19d45`: 4 breaking
  - the request property `oneOf[#/components/schemas/RouteJson]/destinations/items/ip` became not nullable
  - the request property `oneOf[#/components/schemas/RouteJson]/destinations/items/port` became not nullable
  - the request property `oneOf[#/components/schemas/RouteJson]/sources/items/ip` became not nullable
  - the request property `oneOf[#/components/schemas/RouteJson]/sources/items/port` became not nullable
- **2025-09-16** `ddf026fbd25b`: 2 breaking, 6 warning
  - the `oneOf[#/components/schemas/RouteExpression]/protocols` request property's minLength was increased from `0` to `1`
  - the `oneOf[#/components/schemas/RouteJson]/protocols` request property's minLength was increased from `0` to `1`
  - the `oneOf[#/components/schemas/RouteExpression]/priority` request property's max was set to `70368744177663.00`
  - the `oneOf[#/components/schemas/RouteJson]/destinations/items/port` request property's max was set to `65535.00`
  - the `oneOf[#/components/schemas/RouteJson]/sources/items/port` request property's max was set to `65535.00`
  - the `oneOf[#/components/schemas/RouteExpression]/priority` request property's min was set to `0.00`
  - the `oneOf[#/components/schemas/RouteJson]/destinations/items/port` request property's min was set to `0.00`
  - the `oneOf[#/components/schemas/RouteJson]/sources/items/port` request property's min was set to `0.00`
- **2025-08-22** `3c0154b2053a`: 4 breaking, 32 info
  - the response property `oneOf[#/components/schemas/RouteJson]/destinations/items/ip` became nullable for the status `201`
  - the response property `oneOf[#/components/schemas/RouteJson]/destinations/items/port` became nullable for the status `201`
  - the response property `oneOf[#/components/schemas/RouteJson]/sources/items/ip` became nullable for the status `201`
  - the response property `oneOf[#/components/schemas/RouteJson]/sources/items/port` became nullable for the status `201`
  - the request property `oneOf[#/components/schemas/RouteJson]/destinations/items/ip` became nullable
  - the request property `oneOf[#/components/schemas/RouteJson]/destinations/items/port` became nullable
  - the request property `oneOf[#/components/schemas/RouteJson]/sources/items/ip` became nullable
  - the request property `oneOf[#/components/schemas/RouteJson]/sources/items/port` became nullable
  - the `https_redirect_status_code` request property default value `426` was added
  - the `https_redirect_status_code` request property default value `426` was added
  - the `path_handling` request property default value `v0` was added
  - the `path_handling` request property default value `v0` was added
  - the `preserve_host` request property default value `false` was added
  - the `preserve_host` request property default value `false` was added
  - the `priority` request property default value `0` was added
  - the `regex_priority` request property default value `0` was added
  - the `request_buffering` request property default value `true` was added
  - the `request_buffering` request property default value `true` was added
  - the `response_buffering` request property default value `true` was added
  - the `response_buffering` request property default value `true` was added
  - the `strip_path` request property default value `true` was added
  - the `strip_path` request property default value `true` was added
  - the `https_redirect_status_code` response's property default value `426` was added for the status `201`
  - the `https_redirect_status_code` response's property default value `426` was added for the status `201`
  - the `path_handling` response's property default value `v0` was added for the status `201`
  - the `path_handling` response's property default value `v0` was added for the status `201`
  - the `preserve_host` response's property default value `false` was added for the status `201`
  - the `preserve_host` response's property default value `false` was added for the status `201`
  - the `priority` response's property default value `0` was added for the status `201`
  - the `regex_priority` response's property default value `0` was added for the status `201`
  - the `request_buffering` response's property default value `true` was added for the status `201`
  - the `request_buffering` response's property default value `true` was added for the status `201`
  - the `response_buffering` response's property default value `true` was added for the status `201`
  - the `response_buffering` response's property default value `true` was added for the status `201`
  - the `strip_path` response's property default value `true` was added for the status `201`
  - the `strip_path` response's property default value `true` was added for the status `201`
- **2025-08-14** `6333a0d3b095`: 28 info
  - the `https_redirect_status_code` request property default value `426` was removed
  - the `https_redirect_status_code` request property default value `426` was removed
  - the `path_handling` request property default value `v0` was removed
  - the `path_handling` request property default value `v0` was removed
  - the `preserve_host` request property default value `false` was removed
  - the `preserve_host` request property default value `false` was removed
  - the `priority` request property default value `0` was removed
  - the `regex_priority` request property default value `0` was removed
  - the `request_buffering` request property default value `true` was removed
  - the `request_buffering` request property default value `true` was removed
  - the `response_buffering` request property default value `true` was removed
  - the `response_buffering` request property default value `true` was removed
  - the `strip_path` request property default value `true` was removed
  - the `strip_path` request property default value `true` was removed
  - the `https_redirect_status_code` response's property default value `426` was removed for the status `201`
  - the `https_redirect_status_code` response's property default value `426` was removed for the status `201`
  - the `path_handling` response's property default value `v0` was removed for the status `201`
  - the `path_handling` response's property default value `v0` was removed for the status `201`
  - the `preserve_host` response's property default value `false` was removed for the status `201`
  - the `preserve_host` response's property default value `false` was removed for the status `201`
  - the `priority` response's property default value `0` was removed for the status `201`
  - the `regex_priority` response's property default value `0` was removed for the status `201`
  - the `request_buffering` response's property default value `true` was removed for the status `201`
  - the `request_buffering` response's property default value `true` was removed for the status `201`
  - the `response_buffering` response's property default value `true` was removed for the status `201`
  - the `response_buffering` response's property default value `true` was removed for the status `201`
  - the `strip_path` response's property default value `true` was removed for the status `201`
  - the `strip_path` response's property default value `true` was removed for the status `201`
- **2025-07-22** `76b0fefddb0d`: 2 breaking, 30 info
  - the response property `oneOf[#/components/schemas/RouteExpression]/tags` became nullable for the status `201`
  - the response property `oneOf[#/components/schemas/RouteJson]/tags` became nullable for the status `201`
  - the request property `oneOf[#/components/schemas/RouteExpression]/tags` became nullable
  - the request property `oneOf[#/components/schemas/RouteJson]/tags` became nullable
  - the `https_redirect_status_code` request property default value `426` was added
  - the `https_redirect_status_code` request property default value `426` was added
  - the `path_handling` request property default value `v0` was added
  - the `path_handling` request property default value `v0` was added
  - the `preserve_host` request property default value `false` was added
  - the `preserve_host` request property default value `false` was added
  - the `priority` request property default value `0` was added
  - the `regex_priority` request property default value `0` was added
  - the `request_buffering` request property default value `true` was added
  - the `request_buffering` request property default value `true` was added
  - the `response_buffering` request property default value `true` was added
  - the `response_buffering` request property default value `true` was added
  - the `strip_path` request property default value `true` was added
  - the `strip_path` request property default value `true` was added
  - the `https_redirect_status_code` response's property default value `426` was added for the status `201`
  - the `https_redirect_status_code` response's property default value `426` was added for the status `201`
  - the `path_handling` response's property default value `v0` was added for the status `201`
  - the `path_handling` response's property default value `v0` was added for the status `201`
  - the `preserve_host` response's property default value `false` was added for the status `201`
  - the `preserve_host` response's property default value `false` was added for the status `201`
  - the `priority` response's property default value `0` was added for the status `201`
  - the `regex_priority` response's property default value `0` was added for the status `201`
  - the `request_buffering` response's property default value `true` was added for the status `201`
  - the `request_buffering` response's property default value `true` was added for the status `201`
  - the `response_buffering` response's property default value `true` was added for the status `201`
  - the `response_buffering` response's property default value `true` was added for the status `201`
  - the `strip_path` response's property default value `true` was added for the status `201`
  - the `strip_path` response's property default value `true` was added for the status `201`

---

[Operation](https://skmtc.dev/kong/apis/konnect-api-go-sdk/docs/v2/control-planes/:controlPlaneId/core-entities/routes/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/control-planes/:controlPlaneId/core-entities/routes/post)
