Skip to main content
Version: v5.7.0

opschain workflows

Included from Basic tier

Browse, inspect and manage workflow definitions. list reads the local repository's workflows (under .opschain/workflows) or — with a project named — a project's stored workflows on a server; every other verb operates on stored server workflows addressed as <project>/<code>.

There is deliberately no create or update verb: creating or updating a stored workflow is workflows import (with --update to mint the next version of an existing workflow). The import path mints versions through the same authorised endpoints a GUI edit uses, so there is no separate authoring lane to drift from the server's own validation.

SubcommandPurpose
opschain docs cli/workflows-listList local repository workflows, or a project's stored workflows.
opschain docs cli/workflows-showShow a stored workflow's summary, or print its authored YAML definition.
opschain docs cli/workflows-archiveHide a stored workflow from new runs, keeping its history.
opschain docs cli/workflows-unarchiveMake an archived workflow runnable again.
opschain docs cli/workflows-exportExport the current definition as envelope YAML for backup and change control.
opschain docs cli/workflows-importCreate a workflow — or mint its next version — from an envelope.

Archive is the reversible retirement: hidden from new runs, history kept. Permanent destruction of an archived workflow is the admin verb opschain admin workflows destroy (opschain docs cli/admin-workflows-destroy).

See also​

  • opschain docs cli/runs-create — running a workflow, locally or on a server.
  • opschain docs cli/admin-workflows-destroy — permanently destroy an archived workflow.
  • opschain learn 4.1 (workflows) and opschain learn 8.1 (backup and interchange).