CLI Tools
sop-cli is the administrative command-line client for the Taiso API. It covers user management, API key issuance, usage reporting, and request logs. It requires an admin key — day-to-day API work needs only a normal key and no CLI.
Configuration
Two environment variables control which deployment you are talking to:
export SOPENGINE_API_URL=https://api.taiso.ai # default: http://localhost:8801
export SOPENGINE_ADMIN_KEY=<admin-api-key>The CLI prints the resolved environment before acting, so you can confirm you are not pointed at production by accident.
Users
sop-cli.py users list
sop-cli.py users list --admin # admins only
sop-cli.py users show --email user@example.com
sop-cli.py users create --email user@example.com --name "Jane Doe"
sop-cli.py users update --email user@example.com --is-admin true
sop-cli.py users delete --email user@example.comAPI keys
sop-cli.py keys create user@example.com --name "Production Key"
sop-cli.py keys revoke user@example.com --key-id <id>A newly created key is printed once. Capture it at that moment — it is stored hashed and cannot be shown again. Most users should instead manage their own keys from the Hub API keys page.
Usage and logs
sop-cli.py usage
sop-cli.py logs --limit 100
sop-cli.py health # no admin key requiredGetting help
Every command and subcommand supports --help, which lists its current flags:
sop-cli.py --help
sop-cli.py users --help
sop-cli.py users update --helpNeed help?
This page is a starting point. For anything it does not cover, reach out.