Sharing & ownership

CLI commands to share, unshare, transfer, and administer sandboxes.

Command reference for sandbox sharing and ownership. For how sharing, access levels, and ownership transfer work, and who can do what, see the Sharing Sandboxes guide.

List

tektona sandbox ls                              # your sandboxes in the current project (scope=mine)
tektona sandbox ls --scope shared               # shared with you
tektona sandbox ls --scope all                  # everything you can access
tektona sandbox ls --all-projects               # your sandboxes across every project in the org
tektona sandbox ls --all-projects --scope all   # everything you can access, org-wide

--scope selects whose sandboxes (mine default / shared / all), and --all-projects selects which projects (current vs the whole org). They are independent: --all-projects alone still shows only your own sandboxes. To see other members' sandboxes, use tektona admin sandbox ls.

Share / unshare

tektona sandbox share <sandbox-id>                 # share for use (default)
tektona sandbox share <sandbox-id> --type manage   # members can also delete
tektona sandbox unshare <sandbox-id>               # make private again

--type is use (default) or manage.

Transfer ownership

tektona sandbox transfer <sandbox-id> dev@acme.com
tektona sandbox chown <sandbox-id> <user-id>       # alias

The new owner must be a project writer or higher. Transfer revokes the previous owner's outstanding SSH, VNC, and preview tokens.

Administer (admin only)

tektona admin sandbox ls [--all-projects] [--owner <email>] [--orphaned] [--older-than 24h] [--state running]
tektona admin sandbox get <sandbox-id>
tektona admin sandbox pause <sandbox-id> [--mode hibernate|suspend]
tektona admin sandbox rm <sandbox-id> [--yes]

Requires project-admin (or org-owner for --all-projects).

See the Sharing Sandboxes guide for the full model, access levels, and the screen-disclosure warning.

On this page