Update Cluster Component Bundle

PATCH

/clusters/{cluster_id}/component-bundle

curl --request PATCH \
  --url https://api.mengi.cloud/clusters/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/component-bundle \
  --header 'Content-Type: application/json' \
  --data '{ "version": "example" }'

Update the component bundle version for a cluster.

The component bundle determines which version of cluster components (cert-manager, traefik, etc.) are deployed via ArgoCD ApplicationSets.

Valid values:

• ‘latest’: Always use HEAD (latest) from the component repository
• ‘stable’: Use the current stable release
• ‘v1.2.0’: Use a specific version tag

Note: Changes take effect on the next ArgoCD sync. For immediate effect, you may need to trigger a sync manually via the ArgoCD UI.

Parameters

Path Parameters

cluster_id

required

Cluster Id

string format: uuid

Request Body ^required

Media type application/json

ComponentBundleUpdate

Update a cluster’s component bundle version.

object

version

required

Version

string

Example ^generated

{
  "version": "example"
}

Responses

200

Successful Response

Media type application/json

ClusterResponse

object

id

required

Id

string format: uuid

name

required

Name

string

provider

required

Provider

string

region

required

Region

string

tier

required

ClusterTier

string

Allowed values: shared testing production

status

required

ClusterStatus

string

Allowed values: pending provisioning importing running upgrading error deleting

kubernetes_version

Any of:

string

string

null

null

server_type

Any of:

string

string

null

null

argocd_url

Any of:

string

string

null

null

git_repo_url

Any of:

string

string

null

null

error_message

Any of:

string

string

null

null

status_message

Any of:

string

string

null

null

created_at

required

Created At

string format: date-time

updated_at

required

Updated At

string format: date-time

provisioning_started_at

Any of:

string

string format: date-time

null

null

provisioning_completed_at

Any of:

string

string format: date-time

null

null

autoscaling_enabled

Autoscaling Enabled

boolean

min_nodes

Any of:

integer

integer

null

null

max_nodes

Any of:

integer

integer

null

null

target_kubernetes_version

Any of:

string

string

null

null

upgrade_available

Upgrade Available

boolean

upgrade_available_version

Any of:

string

string

null

null

scheduled_upgrade_date

Any of:

string

string format: date-time

null

null

scheduled_upgrade_id

Any of:

string

string format: uuid

null

null

component_bundle_version

Component Bundle Version

string

default: latest

multi_region

Multi Region

boolean

region_locations

Any of:

Array<string>

Array<string>

null

null

is_byoc

Is Byoc

boolean

cloud_credential_id

Any of:

string

string format: uuid

null

null

is_imported

Is Imported

boolean

is_autopilot

Is Autopilot

boolean

display_order

Any of:

integer

integer

null

null

Example

{
  "tier": "shared",
  "status": "pending",
  "autoscaling_enabled": false,
  "upgrade_available": false,
  "component_bundle_version": "latest",
  "multi_region": false,
  "is_byoc": false,
  "is_imported": false,
  "is_autopilot": false
}

422

Validation Error

Media type application/json

HTTPValidationError

object

detail

Detail

Array<object>

ValidationError

object

loc

required

Location

Array

msg

required

Message

string

type

required

Error Type

string

Example ^generated

{
  "detail": [
    {
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example"
    }
  ]
}