โ† API reference
Mutation / admin

iacApplyChange

Atomically Apply the reviewed plan as the actual user, publishing main only on success. The stack's rules must be met (REVIEW_REQUIRED, CHANGES_REQUESTED) unless a stack admin bypasses them.

Arguments

stackIdIaCStackID!

Owning stack.

planIdIaCPlanID!

Server-produced plan reviewed by this user.

digestString!

Exact digest approved by this user; stale plans fail closed.

bypassReasonString

Apply without meeting the stack's rules, recording this reason (at most 2 KiB). Only stack admins, and only when the rules allow bypass (otherwise BYPASS_NOT_ALLOWED). A blank reason is no bypass.

Returns IaCHostedValue!

Scalar fields at a glance

payloadString!
โ†— View the complete IaCHostedValue type

Explore in a view

Administration and IAM
View exact SDL
"""
Atomically Apply the reviewed plan as the actual user, publishing main only on success. The stack's rules must be met (REVIEW_REQUIRED, CHANGES_REQUESTED) unless a stack admin bypasses them.
"""
iacApplyChange(
  """Owning stack."""
  stackId: IaCStackID!
  """Server-produced plan reviewed by this user."""
  planId: IaCPlanID!
  """Exact digest approved by this user; stale plans fail closed."""
  digest: String!
  """
  Apply without meeting the stack's rules, recording this reason (at most 2 KiB). Only stack admins, and only when the rules allow bypass (otherwise BYPASS_NOT_ALLOWED). A blank reason is no bypass.
  """
  bypassReason: String
): IaCHostedValue! @topic(names: ["admin"])

Schema reference describes the API contract. Actual access is checked by the platform for every operation.