Trigger a Run. By default, this mutation triggers a tracked run for the
commit currently tracked by a Stack or, if the Stack is not yet tracking any
commit, against the HEAD of the Stack's tracked branch. These defaults can
be overridden.
- stack
- commitSha
- runTypeRunType
- runtimeConfigRuntimeConfigInput
- forceApplyForceApplyMode
Run!
Run!
- idGlobally unique ID (ULID) of the Run.
- stackIdThe ID (slug) of the Stack this Run belongs to.
- workflowIdID (ULID) of the workflow this Run belongs to. All Runs triggered as part of the same chain (stack-dependency fan-out, trigger policies, promotion) share this value, so it can be used to group a run chain without walking the dependency graph. A standalone Run's workflowId is its own id.
- branchName of the branch for which this Run has been created.
- canPromoteChecks if a proposed run can be promoted to a tracked one.
- canConfirmChecks if a run can be confirmed.
- canRetryChecks if a run can be retried.
- Entities changed by this Run.
- Entities changed by this Run. If phase is not passed, the changes for latest phase are returned.
- searchEntityChangesSuggestions returns search suggestions for run changes.
- searchEntityChanges allows to search changes of a run.
- commandCommand - only useful for Tasks.
- comments[RunComment!]!Comments on the Run, if any.
- commitCommit!Commit representing the HEAD of the branch at the time of triggering the Run.
- createdAtUnix timestamp representing Run creation.
- deltaDeltaChange in resources tracked by the Stack's state that will be caused by this Run.
- dependsOn[RunDependency!]!The run that this run depends on.
- isDependedOnBy[RunDependency!]!The runs that depend on this run.
- triggeredRuns[RunDependency!]!Runs on dependent stacks that were triggered as a result of this run finishing. Does not include runs in the Skipped state.
- driftDetectionIndicates whether this run belongs to a drift detection workflow.
- expectFailureIf the run is a module test case, is the test case expected to fail? This field will be null for non-module runs.
- forceApplyModeForceApplyModeControls whether this run will force apply even when delta is zero. Null means normal behavior. SINGLE: force apply this run only. CASCADE: force apply and propagate to dependents.
- expiredExpired run is one that's been waiting for user approval for long enough to have its pending plan file garbage-collected.
- externalDependencies[RunExternalDependency!]!any external dependencies that this run has
- finishedConvenience helper, allowing a quick check on whether the Run has finished.
- history[RunStateTransition!]!Run history as a list of state transitions.
- isMostRecentIndicates whether the run is the most recent one its current Stack - ie. it is the one that has last changed the stack state.
- Paginated slice of Run logs associated with one of the current Run's (past or present) states. Set sanitize to strip ANSI codes, timestamps and noise lines - useful when feeding logs to an LLM.
- A download URL for the logs of a run state
- pluginLogs[PluginLogsResponse!]!The logs associated with the plugins of a run.
- A download URL for the logs of a plugin.
- otelTraceForJaegerDownloadURLLogsDownloadURLA download URL for the run's captured OTEL trace as a single Jaeger JSON document.
- observabilityStatusRunObservabilityStatusHow far the run's observability data got through the pipeline that produces it. Null when the status could not be read.
- A download URL for a CPU profile (.pprof) captured during the given phase of the run (e.g. "init", "plan", "apply").
- nextRunNext run, if any. Next indicates a run of the same type, on the same branch, created right after the current one.
- needsApprovalIndicates whether the Run needs approval before it can proceed.
- planPoliciesOutcomes[PlanPoliciesOutcome!]!List of outcomes for policies evaluated against this runs plan.
- policyReceipts[RunPolicyReceipt!]!List of policy evaluations events that affected this run.
- Policy evaluation sample for a given key, if available.
- previousRunPrevious run, if any. Previous indicates a run of the same type, on the same branch, created right before the current one.
- promoteBlockerReason why the run cannot be promoted, if any.
- confirmBlockerReturns a message explaining why a run cannot be confirmed.
- reviews[RunReview!]!List of reviews for this run.
- retryBlockerReason why the run cannot be retried.
- runtimeConfigRuntimeConfigIndividual runtime configuration for this Run.
- customRuntimeConfigRuntimeConfigCustomer provided runtime configuration for this Run.
- stateRunStateCurrent state of the Run.
- titleTitle of the Run for UI consumption.
- triggeredByThe user who manually triggered this Run, if any.
- typeRunTypeType of the Run.
- updatedAtUnix timestamp of the last update.
- supportsDetailedResourcesIndicates whether the run supports detailed resources.
- isPrioritizedIndicates whether the run has been prioritized. Equivalent to priorityPreset being high.
- priorityPresetRunPriorityPresetThe scheduling tier of the run within its worker pool queue. High runs are scheduled before all others, low runs after all others, and normal runs are ordered by run type.
- Metrics the workers reported while executing this run, next to the same metrics across finished tracked runs of the same stack that measured an apply, created within `comparisonWindowDays` before this run. Null unless `observabilityStatus.metrics` is AVAILABLE, and when the metrics could not be read.