graph:get
Read one page of the node graph: roots (records of the starting nodes, each with a node_id), nodes_by_id (nodes keyed by node_id), has_more, next_cursor and page_size. Without --node_id, start at roots in your scopes; with it, walk that node and its descendants, not up to its root. --depth limits the walk. Pass next_cursor as --cursor with all other inputs unchanged until has_more is false. Use hosted:lineage:list for direct neighbours.
Reference for flywheel graph:get.
Read a known graph with --node_id, which includes every readable access scope by default. An unanchored read defaults to your own nodes; request --access_scopes shared or --access_scopes public for discovery. A visibility filter only narrows those scopes, so a public filter needs the public scope too. See Add to a graph you don't own.
Command Group
Nodes & Graph Commands
Summary
Read one page of the node graph: roots (records of the starting nodes, each with a node_id), nodes_by_id (nodes keyed by node_id), has_more, next_cursor and page_size. Without --node_id, start at roots in your scopes; with it, walk that node and its descendants, not up to its root. --depth limits the walk. Pass next_cursor as --cursor with all other inputs unchanged until has_more is false. Use hosted:lineage:list for direct neighbours.
Effect
read-only
Usage
flywheel graph:get [FLAGS]Required flags
None.
Optional flags
| Flag | Value | Default | Choices | Description |
|---|---|---|---|---|
--node_id | string | Node UUID (not a slug) from node_id in hosted:node:list or graph:get. Missing or hidden: 404 where the command loads it. Scopes the read to that node's graph; without --access_scopes, reads it in every scope you can read: owned, shared and public. | ||
--access_scopes | string | Comma-separated scopes to read: owned (your nodes), shared (shared with you, including through a repository role), public. Default: owned, or every scope with --node_id. | ||
--depth | integer | Parent-to-child links to follow below the starting nodes: 0 returns only them, 1 adds their children. Omitted: no limit. | ||
--max_nodes | integer | Max nodes in response. | ||
--page_size | integer | Items per page (omitted: command default). Out of range: clamped or 422, by command. | ||
--cursor | string | next_cursor from the previous page, other inputs unchanged; omitted: first page; stop when none returns. Invalid: 422 from graph:get; admin graph lists restart. | ||
--private_only | false | true: only your own nodes that are shared with nobody and have no repository members; needs owned among the scopes. Not the same as "not public". Omitted: false. | ||
--projection | string | topology | core, topology, full | core: node fields with content and summary, no artifacts. topology: same, content and summary empty (a root may keep its banner artifact). full: core plus artifacts (and executions where returned), where offered. Omitted: command default. Relationship IDs vary by command; tree entries are layout only. |
--filter | string | Node filters, each include:<axis>:<match> or exclude:<axis>:<match> (a bare axis:match is refused here). Axes: owner (an owner's user UUID), root_graph (a root's UUID: that node and its descendants), tag (a tag name, case-insensitive; not a tag ID), visibility (owned, owned_private, shared, public, link), recency (last_24h, last_7d, last_30d, by creation time); node_type is not supported. Includes combine with OR, excludes remove matches; a bad token: 422. Applied on top of your saved filters. Comma-separated values. | ||
--exclude | string | Like filter but each token may be axis:match (meaning exclude) or the full exclude:<axis>:<match>. Same axes and values; a bad token: 422. Comma-separated values. | ||
--format | FORMAT | json, tsv, csv, table | Output format for command results. | |
--env | PROFILE | Select a CLI profile; unconfigured default requires FLYWHEEL_BASE_URL. | ||
--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 | Confirm forced compute:release-all --force. Other runtime commands do not read --yes. | |||
--debug | Print structured request debugging with secrets masked. | |||
--verbose | Print verbose progress for long-running operations. | |||
-h, --help | Show this help. |
Examples
Read one page from a root and its descendants in every scope.
flywheel graph:get --node_id r_root --depth 3Read graphs shared with you.
flywheel graph:get --access_scopes sharedRead public graphs.
flywheel graph:get --access_scopes publicRead the first graph page.
flywheel graph:get --page_size 10000Read the next page with the same page size and other inputs unchanged.
flywheel graph:get --page_size 10000 --cursor <next_cursor>Include a tag name (not a tag ID) and exclude an owner UUID.
flywheel graph:get --filter include:tag:priority --exclude owner:<user_uuid>Output
Default format: json.
| Field | Type |
|---|---|
roots | array<object> |
nodes_by_id | object |
has_more (optional) | boolean | null |
next_cursor (optional) | string | null |
page_size (optional) | integer | null |
bucket_versions (optional) | object | null |