---
title: "Patch Execution Cluster"
method: PATCH
path: "/execution/clusters/{id}"
tags: ["ExecutionCluster"]
---

# Patch Execution Cluster

`PATCH /execution/clusters/{id}`

Update Execution Cluster

## Path parameters

- `id` string, required

## Headers

- `If-Match` string

## Request body

- PatchExecutionClusterRequest — Patch select Execution Host properties
  - `current_state` ExecutionClusterState — Execution cluster state
    - `instance_type` string — Unique identifies for the instance type (e.g. mac1.metal)
    - `size` integer — Size of the cluster
    - `node_state` ExecutionNodeState — Execution node state
      - `versions` object — Map of software versions running on the cluster
      - `lastUpdatedTime` integer
  - `labels` string[] — Cluster labels
  - `name` string — name of the cluster
  - `zones` string[] — zones the execution cluster is in

## Response `200`

Execution Cluster

- ExecutionCluster — Patch select Execution Host properties
  - `labels` string[] — Cluster labels
  - `name` string, required — name of the cluster
  - `os` 'windows' | 'linux' | 'osx' — Operation system used in the runtime
  - `provider` 'google_cloud' | 'amazon_web_services' | 'customer', required — Cloud where execution host resides
  - `region` string — region the execution cluster is in
  - `cluster_type` 'cloud_function' | 'managed_host' | 'vms' | 'kubernetes' — type of execution cluster
  - `target_state` ExecutionClusterState — Execution cluster state
    - `instance_type` string — Unique identifies for the instance type (e.g. mac1.metal)
    - `size` integer — Size of the cluster
    - `node_state` ExecutionNodeState — Execution node state
      - `versions` object — Map of software versions running on the cluster
      - `lastUpdatedTime` integer
  - `update_config` ExecutionClusterUpdateConfig — Configuration for updating execution cluster
    - `max_unavailable` integer — Maximum number of nodes that can be unavailable at once during updates
  - `workspace_id` string, required — Id of workspace this host is assigned to or 'mabl' for general purpose
  - `zones` string[] — zones the execution cluster is in
  - `current_state` ExecutionClusterState — Execution cluster state
    - `instance_type` string — Unique identifies for the instance type (e.g. mac1.metal)
    - `size` integer — Size of the cluster
    - `node_state` ExecutionNodeState — Execution node state
      - `versions` object — Map of software versions running on the cluster
      - `lastUpdatedTime` integer
  - `id` string, required — API generated globally unique ID
  - `etag` string — API version etag
  - `created_time` integer, required — Creation time, epoch millis
  - `created_by_id` string, required — Creation principal ID
  - `last_updated_time` integer, required — Last updated time, epoch millis
  - `last_updated_by_id` string, required — Last updating principal ID
  - `deleted_time` integer — Deletion time, epoch millis
  - `deleted_by_id` string — Deletion principal ID

## Other responses

- `401` — Missing or invalid credentials
- `403` — Actor is not authorized to make this call
- `404` — No such Execution Cluster
- `409` — Conflict with If-Match header
- `default` — Unknown error

---

[API](https://skmtc.net/mabl/apis/mabl-api.md) · [All operations](https://skmtc.net/mabl/apis/mabl-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mabl/mabl-api/revisions/d0fc0114da66/schema)