Skip to main content
PATCH
Update a cluster stack

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

authorization
string | null
x-ankra-organisation-id
string | null

Path Parameters

cluster_id
string<uuid4>
required
stack_name
string
required

Body

application/json
spec
ResourceSpecification · object
required
allow_chart_downgrade
boolean
default:false
deprecated

Retired. It used to admit every chart downgrade in the write, including ones the person was never shown; it is still accepted as a boolean, but it admits nothing. Send confirmed_chart_downgrades instead.

confirmed_chart_downgrades
ConfirmedChartDowngrade · object[]

The chart downgrades the person confirmed. A write that moves a member's chart_version BELOW the currently declared version is refused with 422 CHART_VERSION_DOWNGRADE, whose detail.details.downgrades names every move, so that a stale whole-stack snapshot cannot silently revert somebody else's chart bump. Re-send the write with those rows here: each admits exactly the move it names, and a downgrade the list does not name (a version that moved while the question was open) is refused again, naming every move with confirmed marking the ones already named.

Maximum array length: 200
draft_id
string<uuid4> | null
expected_digest
string | null

The change-set digest the caller reviewed, as GET /drafts/stacks/{draft_id}/diff reports it for draft_id. Optional: omit it and the write behaves exactly as before. When sent, the server recomputes the change set inside the write transaction, under the cluster lock, and refuses with 422 CHANGE_SET_DRIFTED if it no longer matches - so an approval cannot ship a draft that moved since it was read.

partial_stack
boolean
default:false
resource_version
string | null

Response

Successful Response

stack_name
string
required
commit_sha
string | null
commit_url
string | null
errors
ResourceError · object[]
job_count
integer
default:0
noop_count
integer
default:0
operation_id
string<uuid4> | null
settings_only_count
integer
default:0
warnings
ValidationWarning · object[]