Publishing and revisions
An action has a mutable draft (the YAML you edit) and immutable revisions. Editing the draft never affects running or future workflow runs by itself: only published revisions can be referenced from a workflow.
Publishing
Publishing an action validates the YAML and snapshots the current draft into a new immutable revision. Each publish creates a new revision, even if the source is unchanged. Revisions are identified by an opaque, generated ID and ordered by creation time.
The publish response returns the new revision's canonical ID - use it to pin callers to exactly that snapshot.
Referencing a revision
A uses: reference names a revision by its canonical ID or by the reserved alias latest:
- Pinned (
global:greet@c7cfa2a8): the step always runs that exact snapshot. Pin for reproducible runs. latest(global:greet@latest): resolved to the newest revision when the step runs, so callers automatically pick up new publishes - including in the middle of a workflow's lifetime between two runs.
See Reference formats for the full syntax.
Validation
Action YAML is validated when you publish. You can also validate a draft ahead of time - during
editing or before creating the action - via the ValidateAction API, which checks syntax and
structure without creating anything.
Deleting an action
Deleting an action deletes all its revisions. Workflow steps that reference the deleted action fail to resolve on their next run.
- Submit and view feedback for this page
- Send feedback about H2O Workflows to cloud-feedback@h2o.ai