Skip to main content
PATCH
Update cluster compute settings

Authorizations

Authorization
string
header
required

workspace API token (sk_akua_...) or OAuth2 JWT. Create tokens at https://akua.dev/developers/api-tokens

Headers

akua-context
string

Optional workspace/scope context for the request. Carries a single workspace wire id (ws_…) today. Only needed for broad tokens — a workspace-owned token implies its workspace.

Required string length: 1 - 53
Example:

"ws_j572abc123def456"

if-match
string

The etag of the resource version the client last read. Required on writes when the resource exposes an etag field. Mismatch returns 409 ABORTED with the current etag in the error metadata.

Required string length: 1 - 256
Example:

"42"

Path Parameters

id
string
required

Cluster ID. Prefixed IDs are canonical; raw IDs remain accepted for compatibility.

Minimum string length: 1

Body

application/json
auto_scaling_enabled
boolean
required
max_machines
integer
Required range: 0 <= x <= 100

Response

Cluster compute settings updated

auto_scaling
enum<string>
required
Available options:
active,
paused
machines
integer
required
Required range: x >= 0
max_machines
integer
required
Required range: x >= 0
updated_at
integer
required

Unix timestamp (seconds)

Required range: x >= 0
etag
string
required