โ† API reference
Mutation / admin

iacGitUpdateWorkingRef

Compare and update a working branch; never publishes main or applies configuration.

Arguments

stackIdIaCStackID!

Owning stack.

nameString!

Working branch; protected main is rejected.

expectedString

Expected current commit; null means the branch must not exist.

targetString!

Fully staged valid commit history; must fast-forward an existing branch.

Returns IaCGitRefValue!

Scalar fields at a glance

nameString!
oidString!
โ†— View the complete IaCGitRefValue type

Explore in a view

Administration and IAM
View exact SDL
"""
Compare and update a working branch; never publishes main or applies configuration.
"""
iacGitUpdateWorkingRef(
  """Owning stack."""
  stackId: IaCStackID!
  """Working branch; protected main is rejected."""
  name: String!
  """Expected current commit; null means the branch must not exist."""
  expected: String
  """
  Fully staged valid commit history; must fast-forward an existing branch.
  """
  target: String!
): IaCGitRefValue! @topic(names: ["admin"])

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