---
title: "Changes to Upsert a Certificate"
method: PUT
path: "/v2/control-planes/{controlPlaneId}/core-entities/certificates/{CertificateId}"
---

# Changes to Upsert a Certificate

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

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 87 revisions.

- **2026-10-15** `7aab863a6daa`: 1 breaking, 1 info
- **2026-08-12** `fbe6ce110ba4`: 1 breaking
- **2026-06-23** `bb5e056b7c6d`: 2 breaking, 9 warning
- **2025-07-22** `76b0fefddb0d`: 1 breaking, 1 info

## Changes

- **2026-10-15** `7aab863a6daa`: 1 breaking, 1 info
  - removed `subschema #1, subschema #2` from the `allOf[subschema #2]/` request property `anyOf` list
  - added `subschema #1: CertificateWithVault, subschema #2: CertificateWithCertAndKey` to the `allOf[subschema #2]/` request property `anyOf` list
- **2026-08-12** `fbe6ce110ba4`: 1 breaking
  - the request property `allOf[subschema #1]/managed_by` became not nullable
- **2026-06-23** `bb5e056b7c6d`: 2 breaking, 9 warning
  - added `subschema #1, subschema #2` to the request body `allOf` list
  - the request's body type changed from `object` to no type
  - removed the request property `cert`
  - removed the request property `cert_alt`
  - removed the request property `created_at`
  - removed the request property `id`
  - removed the request property `key`
  - removed the request property `key_alt`
  - removed the request property `snis`
  - removed the request property `tags`
  - removed the request property `updated_at`
- **2025-07-22** `76b0fefddb0d`: 1 breaking, 1 info
  - the response property `tags` became nullable for the status `200`
  - the request property `tags` became nullable

---

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