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

# Changes to Create a new Service

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

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 7 of 52 revisions.

- **2025-09-16** `f03059016622` — 1 breaking, 12 warning
- **2025-08-22** `96118a9cd7f4` — 3 breaking, 17 info
- **2025-07-22** `2c77aeaee5fb` — 1 breaking, 1 info
- **2025-07-15** `dbc2de5f2663` — 2 info
- **2025-04-15** `fc6abbc537f3` — 6 breaking, 10 info
- **2024-12-06** `426663331655` — 1 breaking
- **2024-11-11** `08ead66e9ebb` — 16 breaking, 18 info

## Changes

- **2025-09-16** `f03059016622` — 1 breaking, 12 warning
  - the `id` request property's minLength was increased from `0` to `1`
  - the `connect_timeout` request property's max was set to `2147483646.00`
  - the `port` request property's max was set to `65535.00`
  - the `read_timeout` request property's max was set to `2147483646.00`
  - the `retries` request property's max was set to `32767.00`
  - the `tls_verify_depth` request property's max was set to `64.00`
  - the `write_timeout` request property's max was set to `2147483646.00`
  - the `connect_timeout` request property's min was set to `1.00`
  - the `port` request property's min was set to `0.00`
  - the `read_timeout` request property's min was set to `1.00`
  - the `retries` request property's min was set to `0.00`
  - the `tls_verify_depth` request property's min was set to `0.00`
  - the `write_timeout` request property's min was set to `1.00`
- **2025-08-22** `96118a9cd7f4` — 3 breaking, 17 info
  - the response property `tls_sans/dnsnames` became nullable for the status `201`
  - the response property `tls_sans/uris` became nullable for the status `201`
  - the response property `url` became nullable for the status `201`
  - the request property `tls_sans/dnsnames` became nullable
  - the request property `tls_sans/uris` became nullable
  - the request property `url` became nullable
  - the `connect_timeout` request property default value `60000` was added
  - the `enabled` request property default value `true` was added
  - the `port` request property default value `80` was added
  - the `protocol` request property default value `http` was added
  - the `read_timeout` request property default value `60000` was added
  - the `retries` request property default value `5` was added
  - the `write_timeout` request property default value `60000` was added
  - the `connect_timeout` response's property default value `60000` was added for the status `201`
  - the `enabled` response's property default value `true` was added for the status `201`
  - the `port` response's property default value `80` was added for the status `201`
  - the `protocol` response's property default value `http` was added for the status `201`
  - the `read_timeout` response's property default value `60000` was added for the status `201`
  - the `retries` response's property default value `5` was added for the status `201`
  - the `write_timeout` response's property default value `60000` was added for the status `201`
- **2025-07-22** `2c77aeaee5fb` — 1 breaking, 1 info
  - the response property `tags` became nullable for the status `201`
  - the request property `tags` became nullable
- **2025-07-15** `dbc2de5f2663` — 2 info
  - added the new optional request property `tls_sans`
  - added the optional property `tls_sans` to the response with the `201` status
- **2025-04-15** `fc6abbc537f3` — 6 breaking, 10 info
  - the response property `created_at` became nullable for the status `201`
  - the response property `port` became nullable for the status `201`
  - the response property `protocol` became nullable for the status `201`
  - the response property `updated_at` became nullable for the status `201`
  - the response property `port` became optional for the status `201`
  - the response property `protocol` became optional for the status `201`
  - the request optional property `created_at` became not read-only
  - the request optional property `updated_at` became not read-only
  - the request property `created_at` became nullable
  - the request property `port` became nullable
  - the request property `protocol` became nullable
  - the request property `updated_at` became nullable
  - the request property `port` became optional
  - the request property `protocol` became optional
  - the response optional property `created_at` became not read-only for the status `201`
  - the response optional property `updated_at` became not read-only for the status `201`
- **2024-12-06** `426663331655` — 1 breaking
  - the request property `tags` became not nullable
- **2024-11-11** `08ead66e9ebb` — 16 breaking, 18 info
  - the request property `host` became required
  - the request property `port` became required
  - the request property `protocol` became required
  - the response property `ca_certificates` became nullable for the status `201`
  - the response property `client_certificate` became nullable for the status `201`
  - the response property `connect_timeout` became nullable for the status `201`
  - the response property `enabled` became nullable for the status `201`
  - the response property `id` became nullable for the status `201`
  - the response property `name` became nullable for the status `201`
  - the response property `path` became nullable for the status `201`
  - the response property `read_timeout` became nullable for the status `201`
  - the response property `retries` became nullable for the status `201`
  - the response property `tags` became nullable for the status `201`
  - the response property `tls_verify` became nullable for the status `201`
  - the response property `tls_verify_depth` became nullable for the status `201`
  - the response property `write_timeout` became nullable for the status `201`
  - the request optional property `id` became not read-only
  - the request property `ca_certificates` became nullable
  - the request property `client_certificate` became nullable
  - the request property `connect_timeout` became nullable
  - the request property `enabled` became nullable
  - the request property `id` became nullable
  - the request property `name` became nullable
  - the request property `path` became nullable
  - the request property `read_timeout` became nullable
  - the request property `retries` became nullable
  - the request property `tags` became nullable
  - the request property `tls_verify` became nullable
  - the request property `tls_verify_depth` became nullable
  - the request property `write_timeout` became nullable
  - the response optional property `id` became not read-only for the status `201`
  - the response property `host` became required for the status `201`
  - the response property `port` became required for the status `201`
  - the response property `protocol` became required for the status `201`

---

[Operation](https://skmtc.dev/kong/apis/konnect-api/docs/v2/control-planes/:controlPlaneId/core-entities/services/post.md) · [API](https://skmtc.dev/kong/apis/konnect-api.md) · [Page](https://skmtc.dev/kong/apis/konnect-api/changes/v2/control-planes/:controlPlaneId/core-entities/services/post)
