Skip to main content
Version: v5.8.0

opschain changes close

Included from Basic tier

opschain changes close <id|code> --verdict <verdict> --note <text> [--owner /|/projects/<code>]

Closes a record with a verdict and your note, audited as audit:change_record:closed (or …:cancelled for the cancelled verdict) naming the closing principal. Close is refused by name while a run under the record is still running; cancel the run and close with abandoned, or wait for it. A record that was never approved closes only as cancelled. Closing is a human verb: an agent, a service account or a step's credential is refused by name.

Flags​

FlagMeaning
--verdict <verdict>completed, completed_with_incidents, rolled_back, abandoned (the verdict for cancelled work) or cancelled. Required.
--note <text>Why the change closes. Required, not blank.
--owner <path>The record's owner, / or /projects/<code> — narrows a code two owners hold; ignored for an id.

Exit codes​

CodeMeaning
0Closed.
1Refused — a run under it still runs, already closed, an unknown verdict, not found, or you may not close it.
2Usage error — no verdict or note.