opschain admin nodes restore
Included from Basic tier
opschain admin nodes restore <path>
Restores a soft-deleted node and its subtree — the full undo of
opschain admin nodes delete. The subtree reappears in lists and routes,
new work is accepted again and triggers under it resume. No preview and no
confirmation flag: restore destroys nothing. It applies only to a
soft-deleted node; once a node has been destroyed there is nothing left to
restore (import the export archive instead).
A node left behind by a promote or demote is an ordinary archived node
and restores like any other.
No local flags. The path is the node's address as it was before the delete (the path stayed reserved). In the GUI the same restore is Restore on a row of the project, environment or asset list's Show deleted view.
Output
opschain admin nodes restore demo/environments/dev
restored environment /projects/demo/environments/dev
-o json / -o yaml print the restored node object.
Exit codes
| Code | Meaning |
|---|---|
| 0 | Restored. |
| 1 | The server refused (not deleted, missing, authorisation). |
| 2 | Usage error — malformed path, no server target. |
Named errors
expected a node path like demo, demo/environments/dev, /projects/demo/environments/dev/assets/web or demo/entities/rack_1, got "…"nodes operate on a server's estate — pass --server <url> or 'opschain context use <name>'
Both exit 2.
See also
opschain docs cli/admin-nodes-delete— what restore undoes.opschain docs cli/admin-nodes-import— recreate definitions after a destroy.