---
title: "Update cluster"
method: PATCH
path: "/clusters/{id}"
tags: ["clusters"]
---

# Update cluster

`PATCH /clusters/{id}`

Update cluster

## Path parameters

- `id` string, id, required

## Request body

- object
  - `configuration` ClusterConfigurationInput
    - `clusterFormSettings` object
    - `globalDefaultDeny` boolean, required
    - `istioGlobalDefaultDeny` boolean
    - `linkerdGlobalDefaultDeny` boolean
    - `useAWSIAMInAccessGraphStates` boolean
    - `useAzureIAMInAccessGraphStates` boolean
    - `useDatabaseInAccessGraphStates` boolean
    - `useGCPIAMInAccessGraphStates` boolean
    - `useIstioPoliciesInAccessGraphStates` boolean, required
    - `useKafkaACLsInAccessGraphStates` boolean, required
    - `useLinkerdPoliciesInAccessGraphStates` boolean, required
    - `useNetworkPoliciesInAccessGraphStates` boolean, required
  - `name` string, custom-name

## Response `200`

Update cluster

- Cluster
  - `components` IntegrationComponents, required
    - `credentialsOperator` CredentialsOperatorComponent, required
      - `status` ComponentStatus, required
        - `lastSeen` string, date-time
        - `type` 'NOT_INTEGRATED' | 'CONNECTED' | 'DISCONNECTED', required
      - `type` 'INTENTS_OPERATOR' | 'CREDENTIALS_OPERATOR' | 'NETWORK_MAPPER', required
    - `intentsOperator` IntentsOperatorComponent, required
      - `configuration` IntentsOperatorConfiguration
        - `awsIAMPolicyEnforcementEnabled` boolean, required
        - `azureIAMPolicyEnforcementEnabled` boolean, required
        - `databaseEnforcementEnabled` boolean, required
        - `egressNetworkPolicyEnforcementEnabled` boolean, required
        - `enforcedNamespaces` string[]
        - `gcpIAMPolicyEnforcementEnabled` boolean, required
        - `globalEnforcementEnabled` boolean, required
        - `istioPolicyEnforcementEnabled` boolean, required
        - `kafkaACLEnforcementEnabled` boolean, required
        - `linkerdPolicyEnforcementEnabled` boolean, required
        - `networkPolicyEnforcementEnabled` boolean, required
        - `protectedServices` object[], required
          - `id` string, required
        - `protectedServicesEnabled` boolean, required
      - `status` ComponentStatus, required
        - `lastSeen` string, date-time
        - `type` 'NOT_INTEGRATED' | 'CONNECTED' | 'DISCONNECTED', required
      - `type` 'INTENTS_OPERATOR' | 'CREDENTIALS_OPERATOR' | 'NETWORK_MAPPER', required
    - `networkMapper` NetworkMapperComponent, required
      - `status` ComponentStatus, required
        - `lastSeen` string, date-time
        - `type` 'NOT_INTEGRATED' | 'CONNECTED' | 'DISCONNECTED', required
      - `type` 'INTENTS_OPERATOR' | 'CREDENTIALS_OPERATOR' | 'NETWORK_MAPPER', required
  - `configuration` ClusterConfiguration
    - `clusterFormSettings` ClusterFormSettings, required
      - `certificateProvider` 'SPIRE' | 'CERT_MANAGER' | 'CLOUD' | 'NONE', required
      - `enforcement` boolean, required
    - `globalDefaultDeny` boolean, required
    - `istioGlobalDefaultDeny` boolean, required
    - `linkerdGlobalDefaultDeny` boolean, required
    - `useAWSIAMInAccessGraphStates` boolean, required
    - `useAzureIAMInAccessGraphStates` boolean, required
    - `useDatabaseInAccessGraphStates` boolean, required
    - `useGCPIAMInAccessGraphStates` boolean, required
    - `useIstioPoliciesInAccessGraphStates` boolean, required
    - `useKafkaACLsInAccessGraphStates` boolean, required
    - `useLinkerdPoliciesInAccessGraphStates` boolean, required
    - `useNetworkPoliciesInAccessGraphStates` boolean, required
  - `createdAt` string, date-time, required
  - `defaultEnvironment` object
    - `id` string, required
  - `id` string, required
  - `integration` object
    - `id` string, required
  - `integrations` object[], required
    - `id` string, required
  - `name` string, required
  - `namespaces` object[], required
    - `id` string, required
  - `serviceCount` integer, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `408` — Request Timeout
- `409` — Conflict
- `422` — Unprocessable Entity
- `500` — Internal Server Error
- `default`

## Changes

- **2025-04-16** `6b4369907cb8` — 1 breaking, 5 info
  - added the new required request property `configuration/useLinkerdPoliciesInAccessGraphStates`
  - added the new optional request property `configuration/linkerdGlobalDefaultDeny`
  - added the non-success response with the status `408`
  - added the required property `components/intentsOperator/configuration/linkerdPolicyEnforcementEnabled` to the response with the `200` status
  - …2 more
- **2024-10-21** `7aec65a7fcfd` — 7 info
  - added the new optional request property `configuration/useAzureIAMInAccessGraphStates`
  - added the new optional request property `configuration/useGCPIAMInAccessGraphStates`
  - added the optional property `components/intentsOperator/configuration/enforcedNamespaces` to the response with the `200` status
  - added the required property `components/intentsOperator/configuration/azureIAMPolicyEnforcementEnabled` to the response with the `200` status
  - …3 more
- **2024-02-25** `2a77cd72324f` — 2 breaking, 7 info
  - the request property `configuration/useIstioPoliciesInAccessGraphStates` became required
  - the request property `configuration/useKafkaACLsInAccessGraphStates` became required
  - added the new optional request property `configuration/useAWSIAMInAccessGraphStates`
  - added the new optional request property `configuration/useDatabaseInAccessGraphStates`
  - …5 more
- …earlier changes not shown

[Full history](https://skmtc.dev/otterize/apis/otterize-api-server/changes/clusters/:id/patch.md)

---

[API](https://skmtc.dev/otterize/apis/otterize-api-server.md) · [All operations](https://skmtc.dev/otterize/apis/otterize-api-server/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/otterize/otterize-api-server/revisions/ec9167824493/schema)