Skip to main content
POST
Create 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

Body

application/json
spec
ResourceSpecification · object
required
expected_digest
string | null

The change-set digest the caller reviewed, as GET /drafts/stacks/{draft_id}/diff reports it for the draft_id the spec's stack names. 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, ships the draft as it stands there, 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.

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[]