Skip to main content
Version: v5.6.1

opschain workflows archive

Included from Basic tier

opschain workflows archive <project>/<code>

Archives a stored server workflow: it is hidden from new runs while its versions and run history are retained. The command flips the workflow's archived flag over the ordinary authorised update endpoint (PATCH /api/projects/{project}/workflows/{code}) — the same lane the GUI's archive action uses, so the same authorisation applies.

On success it prints archived workflow <project>/<code> (-o json|yaml prints the updated workflow document instead). Needs a server target (--server <url>, OPSCHAIN_SERVER, or the active context).

Exit codes​

CodeMeaning
0Workflow archived.
1The command failed (workflow not found, server refused the update).
2Usage error — malformed address, no server target.

Named errors​

  • expected <project>/<workflow-code>, got "<arg>" — exit 2.
  • workflow "<code>" not found in project "<project>" — exit 1.

See also​

  • opschain docs cli/workflows-unarchive — the reverse.
  • opschain docs cli/workflows-show — the summary carries the archived state.