Skip to content
Rack Gateway

API Tokens

API tokens provide programmatic access to the gateway for CI/CD pipelines and automation.

Viewing Tokens

Section titled “Viewing Tokens”

Navigate to API Tokens in the sidebar to see all tokens:

ColumnDescription
Token IDPublic UUID for the token
NameDescriptive name
StatusActive or expired
Created ByUser who created the token
Last UsedMost recent API call using this token
CreatedWhen the token was created

Creating a Token

Section titled “Creating a Token”
  1. Click Create Token
  2. Enter a descriptive name
  3. Choose permissions (or use a role shortcut like Viewer, Ops, Deployer, CI/CD, Admin)
  4. Click Create
  5. Copy the token secret immediately

Token Format

Section titled “Token Format”

Tokens are prefixed with rgw_:

  • rgw_xxxxxxxxxxxxxxxxxxxxx

The token string does not encode the role; permissions are stored server-side.

Using Tokens

Section titled “Using Tokens”

Rack Gateway CLI

Section titled “Rack Gateway CLI”
Terminal window
export RACK_GATEWAY_API_TOKEN="rgw_..."
export RACK_GATEWAY_URL="https://gateway.example.com"


rack-gateway apps
rack-gateway deploy -a myapp

Direct API Call

Section titled “Direct API Call”
Terminal window
curl -H "Authorization: Bearer rgw_..." \
  https://gateway.example.com/api/v1/rack-proxy/apps

Editing or Deleting Tokens

Section titled “Editing or Deleting Tokens”
  • Edit lets admins (or deployers who own the token) update name and permissions.
  • Delete Token permanently removes the token.

Best Practices

Section titled “Best Practices”
  • Use CI/CD role shortcuts for automation tokens
  • Rotate tokens regularly
  • Delete unused tokens
Section titled “Related”