Reference

REST API and CLI

Authenticate automation and use the ripton command-line client safely.

For: Developers and operators
Updated: August 11, 2026

Configure the CLI

export RIPTON_SERVER=https://ripton.example.com
export RIPTON_ACCESS_TOKEN='<access-token>'

ripton nodes list --query enabled=true
ripton users capacity
ripton transfers list --query status=running
ripton jobs overview

Use environment variables or a secret manager for credentials. The CLI intentionally has no secret command-line flags because process arguments and shell history may be visible to other users.

Permissions

API credentials can be limited to node, user, transfer, job, or generic API read/write scopes. The CLI never elevates a credential: backend role, scope, ownership, membership, and resource-grant checks are the authority.