opschain settings history
Included from Basic tier
opschain settings history <node-path> [--limit N]
Lists a server node's stored settings versions, newest first — version
numbers and creation times only (the listing excludes the document data; use
opschain settings show with its version flag to read one). Server-only:
pass --server <url> or select a context with opschain context use.
Identical mechanics to opschain properties history: a VERSION /
CREATED table, a trailing more versions exist — raise --limit to list them note when the server truncated the listing, and an array document
under -o json / -o yaml.
Flags
| Flag | Meaning |
|---|---|
--limit N | Maximum versions to list (server default 1000). |
--filter <column>[!]=<value> | Keep only rows matching the term (repeatable; terms AND). Columns are the printed table headers lowercased (spaces/dashes fold to _); * wildcards match the whole cell case-insensitively, != negates, commas mean any-of. Applied client-side within the returned page (--limit). Grammar: opschain docs cli. |
Exit codes
| Code | Meaning |
|---|---|
| 0 | Listed (no versions prints a note and still exits 0). |
| 1 | The node does not exist, has no stored document, or the request failed. |
| 2 | Usage error. |
Named errors
stored settings documents live on a server's nodes — pass --server <url> or 'opschain context use <name>'(exit 2).<node-path> has no stored settings document on this server.
See also
opschain docs cli/settings-show— read one version's data.opschain docs cli/settings-edit— every edit lands here as a new version.