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

# Changes to Create a new Certificate

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

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 6 of 52 revisions.

- **2026-07-06** `36da5cb9a674` — 9 info
- **2025-08-22** `96118a9cd7f4` — 2 info
- **2025-07-22** `2c77aeaee5fb` — 1 breaking, 1 info
- **2025-04-15** `fc6abbc537f3` — 2 breaking, 6 info
- **2024-12-06** `426663331655` — 1 breaking
- **2024-11-11** `08ead66e9ebb` — 6 breaking, 10 info

## Changes

- **2026-07-06** `36da5cb9a674` — 9 info
  - added the new optional request property `description`
  - added the new optional request property `managed_by`
  - added the new optional request property `vault`
  - added the new optional request property `vault_alt`
  - the request optional property `snis` became not read-only
  - the request property `cert` became nullable
  - the request property `key` became nullable
  - the request property `cert` became optional
  - the request property `key` became optional
- **2025-08-22** `96118a9cd7f4` — 2 info
  - the request optional property `snis` became read-only
  - the response optional property `snis` became read-only 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-04-15** `fc6abbc537f3` — 2 breaking, 6 info
  - the response property `created_at` became nullable for the status `201`
  - the response property `updated_at` became nullable 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 `updated_at` became nullable
  - 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` — 6 breaking, 10 info
  - the request property `cert` became required
  - the request property `key` became required
  - the response property `cert_alt` became nullable for the status `201`
  - the response property `id` became nullable for the status `201`
  - the response property `key_alt` became nullable for the status `201`
  - the response property `tags` became nullable for the status `201`
  - added the new optional request property `snis`
  - the request optional property `id` became not read-only
  - the request property `cert_alt` became nullable
  - the request property `id` became nullable
  - the request property `key_alt` became nullable
  - the request property `tags` became nullable
  - added the optional property `snis` to the response with the `201` status
  - the response optional property `id` became not read-only for the status `201`
  - the response property `cert` became required for the status `201`
  - the response property `key` became required for the status `201`

---

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