Skip to main content
Version: v5.8.0

opschain changes

Included from Basic tier

Change records: one approved change with every run, retry and by-hand act under it. A record is owned by the organisation (/) or a project, names the nodes the change may touch (its scope), and moves pending → approved → closed with a verdict. While it is approved — and inside its window, when it declares one — a run created inside its scope joins it automatically (a workflow run by the one node all its change steps target); opschain runs create and opschain runs retry name it explicitly with their change flag, nested runs, triggered runs and retries inherit it, and changes link attaches a run after the fact. changes show renders the record's story.

SubcommandDoes
opschain changes createOpen a pending record — opschain docs cli/changes-create
opschain changes listRecords newest first, by owner, state or code — opschain docs cli/changes-list
opschain changes showThe record and its story — opschain docs cli/changes-show
opschain changes approveApprove a pending record — opschain docs cli/changes-approve
opschain changes linkAttach a run after the fact — opschain docs cli/changes-link
opschain changes unlinkDetach a mis-joined run, with a reason — opschain docs cli/changes-unlink
opschain changes closeClose with a verdict and a note — opschain docs cli/changes-close
opschain changes cancelClose with the cancelled verdict — opschain docs cli/changes-cancel
opschain changes exportThe record and its whole story as NDJSON — opschain docs cli/changes-export

Every verb runs against the targeted server, or the home's local store when no server is targeted (--local forces it). Wherever a verb takes a record, it takes its id or its code; a code two owners both hold is refused by name — narrow it with --owner or use the id.

The record's attributes, how runs join, the story and who may do what are on opschain docs resources/change_record.

See also​

  • opschain docs resources/change_record — the record, the join rules, the story and its retention.
  • opschain docs cli/runs-create-change — naming a record at run creation.
  • opschain docs cli/breakglass-record — attaching a by-hand act.
  • opschain docs events — audit:change_record:*.