hosted:node:create
Create a node from --title or the full six-field JSON values file. Without --repository-id the server places it: under --parent, in the parent's repository when you hold a write role there, otherwise in your fork of that repository, where the node starts private unless you have added members to that fork; with no --parent, as a root in your default workspace. With --repository-id, commit a root node in that hosted repository.
Reference for flywheel hosted:node:create.
Create and commit one node. Without --repository-id, the server chooses the repository: with --parent, the node goes into the parent's repository when you hold a write role there and into your fork of that repository otherwise, where it starts private unless you have added members to that fork; with no --parent, it becomes a root in your default workspace. The result names the node, the repository it landed in and the placement. With --repository-id, the node is committed as a root in that hosted repository and requires a sufficient repository role. An existing repository refuses insufficient membership with 403 repository_forbidden (CLI exit 3). Instead, to add under a node you can read, run flywheel hosted:node:create --parent <node_id> --title 'My addition'; without a write role there, it lands in your fork. Missing and unreadable parents still return 404, and nothing is created. See Add to a graph you don't own for creation, visibility read-back and sharing.
Command Group
Hosted Repository
Summary
Create a node from --title or the full six-field JSON values file. Without --repository-id the server places it: under --parent, in the parent's repository when you hold a write role there, otherwise in your fork of that repository, where the node starts private unless you have added members to that fork; with no --parent, as a root in your default workspace. With --repository-id, commit a root node in that hosted repository.
Usage
flywheel hosted:node:create [FLAGS]Required flags
None.
Optional flags
| Flag | Value | Default | Choices | Description |
|---|---|---|---|---|
--repository-id | string | Hosted repository UUID to commit to. Omit it to let the server choose the repository. | ||
--parent | string | Parent node UUID, any node you can read; repeat --parent for more parents, and the first one decides the repository. Not with --repository-id. | ||
--title | string | Minimal node title. | ||
--values-file | string | JSON file containing exactly six node fields. | ||
--message | string | Hosted commit message. Only with --repository-id. | ||
--expected-head | string | Expected hosted head; skips the automatic head read. Only with --repository-id. | ||
--format | FORMAT | json, tsv, csv, table | Output format for command results. | |
--env | PROFILE | Use a configured CLI profile for this invocation. | ||
--out | PATH | Write output to a file path, or use - for stdout. | ||
--open | Open browser-bound URLs when supported. | |||
--no-retry | Disable transient-error retries. | |||
--retry-max | N | Maximum transient-error retry attempts. | ||
--wait | Block on async operations until a terminal state is reached. | |||
--wait-timeout | SECONDS | 600 | Seconds to wait for --wait before timing out. Defaults to 600. | |
--allow-self | Allow mutating the currently active credential. | |||
--timeout | SECONDS | Set the per-request timeout budget in seconds. | ||
--idempotency-key | KEY | Reuse an Idempotency-Key so ambiguous write failures can be retried with the same key. | ||
--force | Force safety-gated operations where supported. | |||
--yes | Skip confirmation prompts for destructive operations. | |||
--debug | Print structured request debugging with secrets masked. | |||
--verbose | Print verbose progress for long-running operations. | |||
-h, --help | Show this help. |
Examples
Add a node under a node you can read; it lands in the parent's repository or in your fork of it.
flywheel hosted:node:create --parent=<node_id> --title "Next step" --format=jsonCreate a root node in your default workspace.
flywheel hosted:node:create --title "First node" --format=jsonCommit the first graph node with documented null defaults.
flywheel hosted:node:create --repository-id=<uuid> --title "First node"hosted:node:branch
Create one branched node and one lineage relation from the source, copying the source's title. Without --repository-id the server places it in the source's repository when you hold a write role there, otherwise in your fork of that repository, where the node starts private unless you have added members to that fork. With --repository-id, commit it in that hosted repository, which must hold the source.
hosted:node:get
Fetch one node by identifier. Use relationship paging commands for complete direct-neighbor traversal.