hosted:node:restore

Restore one deleted node. Restores title, content and history, but not parent or child edges; add them with hosted:lineage:add. Restores one node: after a cascade delete, restore each ID in the delete result's tombstoned_node_ids. Without --repository-id, the server finds the repository and answers 404 if the ID is unknown or you cannot write to its repository.

Reference for flywheel hosted:node:restore.

Command Group

Hosted Repository

Summary

Restore one deleted node. Restores title, content and history, but not parent or child edges; add them with hosted:lineage:add. Restores one node: after a cascade delete, restore each ID in the delete result's tombstoned_node_ids. Without --repository-id, the server finds the repository and answers 404 if the ID is unknown or you cannot write to its repository.

Effect

changes data

Usage

flywheel hosted:node:restore [FLAGS] <node_id>

Arguments

ArgumentRequiredChoicesDescription
<node_id>YesNode UUID.

Required flags

None.

Optional flags

FlagValueDefaultChoicesDescription
--repository-idstringHosted repository UUID to commit to. Omit it and the server finds the repository of the deleted node, if you can write to it.
--messagestringHosted commit message. Only with --repository-id.
--expected-headstringHosted head this write expects, as head from flywheel hosted:repository:head &lt;repository_id&gt;. When set, the automatic head read is skipped; if the head has moved, the write is refused with repository_head_mismatch: read the head again and retry. Only with --repository-id.
--formatFORMATjson, tsv, csv, tableOutput format for command results.
--envPROFILESelect a CLI profile; unconfigured default requires FLYWHEEL_BASE_URL.
--outPATHWrite output to a file path, or use - for stdout.
--openOpen browser-bound URLs when supported.
--no-retryDisable transient-error retries.
--retry-maxNMaximum transient-error retry attempts.
--waitBlock on async operations until a terminal state is reached.
--wait-timeoutSECONDS600Seconds to wait for --wait before timing out. Defaults to 600.
--allow-selfAllow mutating the currently active credential.
--timeoutSECONDSSet the per-request timeout budget in seconds.
--idempotency-keyKEYReuse an Idempotency-Key so ambiguous write failures can be retried with the same key.
--forceForce safety-gated operations where supported.
--yesConfirm forced compute:release-all --force. Other runtime commands do not read --yes.
--debugPrint structured request debugging with secrets masked.
--verbosePrint verbose progress for long-running operations.
-h, --helpShow this help.

Examples

Restore one deleted node by ID.

flywheel hosted:node:restore <node_id> --format=json

Commit the restoration of a tombstoned node; retained semantic edges never block it.

flywheel hosted:node:restore --repository-id=<uuid> <node_id> --format=json

Output

Default format: human.

FieldType
node_idstring
repository_id (optional)string
success (optional)boolean
graph_event_id (optional)string | null
commit_idstring
head (optional)string
cursor (optional)string
receipt_sequence (optional)integer
warnings (optional)array<string>