nodes:sharing:get

Read who can see or edit a node. Returns owner_user_id, owner_email, is_owner, is_private, effective (your can_view, can_write, can_admin), link and public viewing rules, link_write, users (each with write, admin and repository_role) and updated_at. The same policy also comes as sharing_mode (private, unlisted or public), visibility (also shared when a private node has collaborators) and collaborators (email and/or user_id, role viewer, editor or admin), the fields the MCP tool flywheel_get_node_sharing returns. Only the owner or an admin may read it; others get 403. Use nodes:sharing:set to change it.

Reference for flywheel nodes:sharing:get.

Command Group

Nodes & Graph Commands

Summary

Read who can see or edit a node. Returns owner_user_id, owner_email, is_owner, is_private, effective (your can_view, can_write, can_admin), link and public viewing rules, link_write, users (each with write, admin and repository_role) and updated_at. The same policy also comes as sharing_mode (private, unlisted or public), visibility (also shared when a private node has collaborators) and collaborators (email and/or user_id, role viewer, editor or admin), the fields the MCP tool flywheel_get_node_sharing returns. Only the owner or an admin may read it; others get 403. Use nodes:sharing:set to change it.

Effect

read-only

Usage

flywheel nodes:sharing:get <FLAGS>

Required flags

FlagValueDefaultChoicesDescription
--node_idstringNode UUID (not a slug) from node_id in hosted:node:list or graph:get. Missing or hidden: 404 where the command loads it.

Optional flags

FlagValueDefaultChoicesDescription
--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

Read sharing for a node.

flywheel nodes:sharing:get --node_id n_abc

Output

Default format: json.

FieldType
node_idstring
owner_user_idstring
owner_email (optional)string | null
is_ownerboolean
is_privateboolean
effectiveobject
linkobject
link_writeboolean
publicobject
usersarray<object>
sharing_mode"private" | "public" | "unlisted"
visibility"private" | "shared" | "unlisted" | "public"
collaboratorsarray<object>
updated_atstring