---
title: "Changes to Creates or Updates Mesh entity"
method: PUT
path: "/v1/mesh/control-planes/{cpId}/api/meshes/{name}"
---

# Changes to Creates or Updates Mesh entity

`PUT /v1/mesh/control-planes/{cpId}/api/meshes/{name}`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 3 of 30 revisions.

- **2025-10-09** `1054eea2f638` — 6 breaking, 7 warning, 7 info
- **2025-10-02** `ecce2daf9de6` — 3 info
- **2025-04-28** `d12b4edfb67b` — 1 warning, 8 info

## Changes

- **2025-10-09** `1054eea2f638` — 6 breaking, 7 warning, 7 info
  - the `mtls/backends/items/conf/oneOf[#/components/schemas/ACMCertificateAuthorityConfig]/auth/awsCredentials/accessKey` request property type changed from `object` to no type
  - the `mtls/backends/items/conf/oneOf[#/components/schemas/ACMCertificateAuthorityConfig]/auth/awsCredentials/accessKeySecret` request property type changed from `object` to no type
  - the `mtls/backends/items/conf/oneOf[#/components/schemas/ACMCertificateAuthorityConfig]/caCert` request property type changed from `object` to no type
  - the `mtls/backends/items/conf/oneOf[#/components/schemas/CertManagerCertificateAuthorityConfig]/caCert` request property type changed from `object` to no type
  - the `mtls/backends/items/conf/oneOf[#/components/schemas/ProvidedCertificateAuthorityConfig]/cert` request property type changed from `object` to no type
  - the `mtls/backends/items/conf/oneOf[#/components/schemas/ProvidedCertificateAuthorityConfig]/key` request property type changed from `object` to no type
  - removed the request property `mtls/backends/items/conf/oneOf[#/components/schemas/ACMCertificateAuthorityConfig]/auth/awsCredentials/accessKey/Type`
  - removed the request property `mtls/backends/items/conf/oneOf[#/components/schemas/ACMCertificateAuthorityConfig]/auth/awsCredentials/accessKeySecret/Type`
  - removed the request property `mtls/backends/items/conf/oneOf[#/components/schemas/ACMCertificateAuthorityConfig]/caCert/Type`
  - removed the request property `mtls/backends/items/conf/oneOf[#/components/schemas/CertManagerCertificateAuthorityConfig]/caCert/Type`
  - removed the request property `mtls/backends/items/conf/oneOf[#/components/schemas/ProvidedCertificateAuthorityConfig]/cert/Type`
  - removed the request property `mtls/backends/items/conf/oneOf[#/components/schemas/ProvidedCertificateAuthorityConfig]/key/Type`
  - removed the request property `mtls/backends/items/conf/oneOf[#/components/schemas/VaultCertificateAuthorityConfig]/Mode`
  - added `#/components/schemas/DataSource_File, #/components/schemas/DataSource_Inline, #/components/schemas/DataSource_InlineString, #/components/schemas/DataSource_Secret` to the `mtls/backends/items/conf/oneOf[#/components/schemas/ACMCertificateAuthorityConfig]/auth/awsCredentials/accessKey` request property `oneOf` list
  - added `#/components/schemas/DataSource_File, #/components/schemas/DataSource_Inline, #/components/schemas/DataSource_InlineString, #/components/schemas/DataSource_Secret` to the `mtls/backends/items/conf/oneOf[#/components/schemas/ACMCertificateAuthorityConfig]/auth/awsCredentials/accessKeySecret` request property `oneOf` list
  - added `#/components/schemas/DataSource_File, #/components/schemas/DataSource_Inline, #/components/schemas/DataSource_InlineString, #/components/schemas/DataSource_Secret` to the `mtls/backends/items/conf/oneOf[#/components/schemas/ACMCertificateAuthorityConfig]/caCert` request property `oneOf` list
  - added `#/components/schemas/DataSource_File, #/components/schemas/DataSource_Inline, #/components/schemas/DataSource_InlineString, #/components/schemas/DataSource_Secret` to the `mtls/backends/items/conf/oneOf[#/components/schemas/CertManagerCertificateAuthorityConfig]/caCert` request property `oneOf` list
  - added `#/components/schemas/DataSource_File, #/components/schemas/DataSource_Inline, #/components/schemas/DataSource_InlineString, #/components/schemas/DataSource_Secret` to the `mtls/backends/items/conf/oneOf[#/components/schemas/ProvidedCertificateAuthorityConfig]/cert` request property `oneOf` list
  - added `#/components/schemas/DataSource_File, #/components/schemas/DataSource_Inline, #/components/schemas/DataSource_InlineString, #/components/schemas/DataSource_Secret` to the `mtls/backends/items/conf/oneOf[#/components/schemas/ProvidedCertificateAuthorityConfig]/key` request property `oneOf` list
  - added `#/components/schemas/VaultCertificateAuthorityConfig_FromCp_` to the `mtls/backends/items/conf/oneOf[#/components/schemas/VaultCertificateAuthorityConfig]/` request property `oneOf` list
- **2025-10-02** `ecce2daf9de6` — 3 info
  - the `aggregate` request property default value `` was added
  - the `dnsNames` request property default value `` was added
  - the `tls` request property default value `{}` was added
- **2025-04-28** `d12b4edfb67b` — 1 warning, 8 info
  - removed the request property `mtls/backends/items/conf/oneOf[#/components/schemas/BuiltinCertificateAuthorityConfig]/caCert/RSAbits`
  - added the new optional request property `mtls/backends/items/conf/oneOf[#/components/schemas/BuiltinCertificateAuthorityConfig]/caCert/rsaBits`
  - the `backends` request property default value `` was added
  - the `backends` request property default value `` was added
  - the `backends` request property default value `` was added
  - the `backends` request property default value `` was added
  - the `requirements` request property default value `` was added
  - the `restrictions` request property default value `` was added
  - the `skipCreatingInitialPolicies` request property default value `` was added

---

[Operation](https://skmtc.dev/kong/apis/konnect-api-beta/docs/v1/mesh/control-planes/:cpId/api/meshes/:name/put.md) · [API](https://skmtc.dev/kong/apis/konnect-api-beta.md) · [Page](https://skmtc.dev/kong/apis/konnect-api-beta/changes/v1/mesh/control-planes/:cpId/api/meshes/:name/put)