CLI

Commands

The graphon command surface: workspaces, members, keys, buckets, objects, uploads, and shares.

Every command accepts the global flags --json, --workspace, and --token. Run graphon <group> --help for the full flag list.

Account

Account

graphon whoami
graphon workspaces list
graphon workspaces use <workspaceId>

Members

Members

graphon members list --query "alex"
graphon members update <memberId> --role editor
graphon members remove <memberId>

Invitations

Invitations

graphon invitations create --role editor --email person@acme.dev
graphon invitations list
graphon invitations revoke <invitationId>

Service accounts

Service accounts

graphon service-accounts create --name "ci" --role editor
graphon service-accounts list
graphon service-accounts delete <id>

API keys

A workspace key calls the management API. A storage key calls G4 and can be scoped to one or more buckets. The secret prints once.

API keys

graphon api-keys create --name "Local CLI" --kind workspace --role viewer
graphon api-keys create --name "Backups" --kind storage --bucket <bucketId>
graphon api-keys list
graphon api-keys revoke <keyId>

Buckets

Buckets

graphon buckets create support-tickets \
  --provider gcp --location us-central1 --search enable
graphon buckets list
graphon buckets get support-tickets
graphon buckets usage support-tickets
graphon buckets delete support-tickets --confirm-name support-tickets

Objects

objects put switches to a multipart upload automatically for files over 8 MiB.

Objects

graphon objects put support-tickets incidents/timeout.json --file ./timeout.json
graphon objects list support-tickets --prefix incidents/
graphon objects get support-tickets incidents/timeout.json --output ./timeout.json
graphon objects delete support-tickets incidents/timeout.json

Shares

Shares

graphon shares create support-tickets incidents/timeout.json \
  --expires-in 3600 --disposition attachment
graphon shares list support-tickets incidents/timeout.json
graphon shares revoke support-tickets <shareId>

Uploads

Drive a multipart upload by hand when you need per-part control.

Uploads

graphon uploads create support-tickets --key backups/2026-09.tar
graphon uploads put-part support-tickets <uploadId> 1 --file ./part-1.bin
graphon uploads complete support-tickets <uploadId> --part 1:<etag>

Jobs

Check the status of a background job, such as a bucket empty.

Jobs

graphon jobs get <jobId>
Was this page helpful?