---
title: "Changes to Update Backend Cluster"
method: PUT
path: "/v1/event-gateways/{gatewayId}/backend-clusters/{backendClusterId}"
---

# Changes to Update Backend Cluster

`PUT /v1/event-gateways/{gatewayId}/backend-clusters/{backendClusterId}`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 6 of 30 revisions.

- **2026-08-18** `658ffb748f95` — 1 breaking, 3 info
- **2026-02-16** `106b373707f3` — 5 breaking, 4 info
- **2025-11-06** `5d2b35832e3f` — 2 breaking, 1 warning, 6 info
- **2025-10-17** `564d63b800a1` — 1 breaking
- **2025-10-10** `2724f73e1d49` — 2 breaking, 2 info
- **2025-10-02** `ecce2daf9de6` — 1 info

## Changes

- **2026-08-18** `658ffb748f95` — 1 breaking, 3 info
  - added `#/components/schemas/BackendClusterAuthenticationSaslAwsIam` to the `authentication` response property `oneOf` list for the response status `200`
  - added `sasl_aws_iam` discriminator mapping keys to the `authentication` request property
  - added `#/components/schemas/BackendClusterAuthenticationSaslAwsIam` to the `authentication` request property `oneOf` list
  - added `sasl_aws_iam` discriminator mapping keys to the `authentication` response property for the response status `200`
- **2026-02-16** `106b373707f3` — 5 breaking, 4 info
  - the `authentication/oneOf[#/components/schemas/BackendClusterAuthenticationSaslPlainSensitiveDataAware]/password` request property's minLength was increased from `0` to `1`
  - the `authentication/oneOf[#/components/schemas/BackendClusterAuthenticationSaslPlainSensitiveDataAware]/username` request property's minLength was increased from `0` to `1`
  - the `authentication/oneOf[#/components/schemas/BackendClusterAuthenticationSaslScramSensitiveDataAware]/password` request property's minLength was increased from `0` to `1`
  - the `authentication/oneOf[#/components/schemas/BackendClusterAuthenticationSaslScramSensitiveDataAware]/username` request property's minLength was increased from `0` to `1`
  - the `tls/ca_bundle` request property's minLength was increased from `0` to `1`
  - added the new optional request property `tls/client_identity`
  - the `description` request property default value `` was added
  - added the optional property `tls/client_identity` to the response with the `200` status
  - the `description` response's property default value `` was added for the status `200`
- **2025-11-06** `5d2b35832e3f` — 2 breaking, 1 warning, 6 info
  - removed `#/components/schemas/BackendClusterAuthenticationSaslPlain, #/components/schemas/BackendClusterAuthenticationSaslScram` from the `authentication` request property `oneOf` list
  - added `#/components/schemas/BackendClusterAuthenticationSaslPlainSensitiveDataAware, #/components/schemas/BackendClusterAuthenticationSaslScramSensitiveDataAware` to the `authentication` response property `oneOf` list for the response status `200`
  - added the new `type` enum value to the `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterStandard]/rule` response property for the response status `400`
  - mapped value for discriminator key `sasl_plain` changed from `#/components/schemas/BackendClusterAuthenticationSaslPlain` to `#/components/schemas/BackendClusterAuthenticationSaslPlainSensitiveDataAware` for `authentication` request property
  - mapped value for discriminator key `sasl_scram` changed from `#/components/schemas/BackendClusterAuthenticationSaslScram` to `#/components/schemas/BackendClusterAuthenticationSaslScramSensitiveDataAware` for `authentication` request property
  - added `#/components/schemas/BackendClusterAuthenticationSaslPlainSensitiveDataAware, #/components/schemas/BackendClusterAuthenticationSaslScramSensitiveDataAware` to the `authentication` request property `oneOf` list
  - mapped value for discriminator key `sasl_plain` changed from `#/components/schemas/BackendClusterAuthenticationSaslPlain` to `#/components/schemas/BackendClusterAuthenticationSaslPlainSensitiveDataAware` for `authentication` response property for the response status `200`
  - mapped value for discriminator key `sasl_scram` changed from `#/components/schemas/BackendClusterAuthenticationSaslScram` to `#/components/schemas/BackendClusterAuthenticationSaslScramSensitiveDataAware` for `authentication` response property for the response status `200`
  - removed `#/components/schemas/BackendClusterAuthenticationSaslPlain, #/components/schemas/BackendClusterAuthenticationSaslScram` from the `authentication` response property `oneOf` list for the response status `200`
- **2025-10-17** `564d63b800a1` — 1 breaking
  - the request property `description` became not nullable
- **2025-10-10** `2724f73e1d49` — 2 breaking, 2 info
  - added the new required request property `tls/enabled`
  - the request property `tls` became required
  - the response property `tls` became required for the status `200`
  - added the required property `tls/enabled` to the response with the `200` status
- **2025-10-02** `ecce2daf9de6` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/kong/apis/konnect-api-beta/docs/v1/event-gateways/:gatewayId/backend-clusters/:backendClusterId/put.md) · [API](https://skmtc.dev/kong/apis/konnect-api-beta.md) · [Page](https://skmtc.dev/kong/apis/konnect-api-beta/changes/v1/event-gateways/:gatewayId/backend-clusters/:backendClusterId/put)