← API reference
Mutation / jobs

upsertOperationGraph

Replace a job's entire operation dependency graph: all existing edges for the job are deleted and the supplied ones inserted, in a single transaction that also applies any operation scheduling preferences. Validation (endpoints in-job, no self-loops, no duplicates, no cycles) runs before anything is written; on failure nothing changes and the errors are returned in the payload. Requires operation:write permission.

Arguments

The job's complete edge set, plus optional operation scheduling-preference patches.

Returns UpsertOperationGraphPayload!

Explore in a view

Production Floor
View exact SDL
"""
Replace a job's entire operation dependency graph: all existing edges for the job are deleted and the supplied ones inserted, in a single transaction that also applies any operation scheduling preferences. Validation (endpoints in-job, no self-loops, no duplicates, no cycles) runs before anything is written; on failure nothing changes and the errors are returned in the payload. Requires operation:write permission.
"""
upsertOperationGraph(
  """
  The job's complete edge set, plus optional operation scheduling-preference patches.
  """
  input: UpsertOperationGraphInput!
): UpsertOperationGraphPayload! @topic(names: ["jobs"])

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