CLICommands
subscription
snug subscription <COMMAND>Subscription entitlement timing management.
Subcommands
| Command | What it does |
|---|---|
plan | Plan policy management (admin) |
grant | Grant a subscription to a user |
batch-grant | Grant many subscriptions from a JSON file (array of grant objects) |
check | Check entitlement for a user |
list | List subscriptions for a user |
trial-start | Start a trial |
pause | Pause a subscription |
resume | Resume a subscription |
upgrade | Upgrade or downgrade a subscription (admin) |
cancel | Cancel a subscription (admin) |
group | Group seat management |
usage | Usage-capped time management |
lease | Agent seat lease management |
lapses | Lapse worker introspection (admin) |
Run snug subscription <command> --help for that command's own options.
The global options apply everywhere.
Examples
snug subscription plan create --name Pro --feature advanced_api --feature priority_jobs --default-duration-days 30
snug subscription plan list
snug subscription plan get --plan-id plan_pro
snug subscription plan update --plan-id plan_pro --name "Pro Plus" --feature advanced_api
snug subscription plan update --plan-id plan_pro --retire true
snug subscription grant user_42 --plan-id plan_pro --duration-days 30 --reason promo
snug subscription check user_42 --feature priority_jobs
snug subscription check user_42 --plan-id plan_pro --agent-id agent_verifier
snug subscription list user_42
snug subscription trial-start --subscription-id sub_01 --duration-days 14
snug subscription pause --subscription-id sub_01 --reason "billing hold"
snug subscription resume --subscription-id sub_01
snug subscription upgrade --subscription-id sub_01 --plan-id plan_enterprise
snug subscription cancel --subscription-id sub_01
snug subscription group add-member --subscription-id sub_01 --user-id user_456
snug subscription group remove-member --subscription-id sub_01 --user-id user_456
snug subscription usage record --subscription-id sub_01 --minutes 15
snug subscription lease create --subscription-id sub_01 --agent agent_verifier --minutes 15 --scope priority_jobs
snug subscription lease revoke --subscription-id sub_01 --lease-id lease_01
snug subscription lapses due
snug subscription lapses runNext
- subscription guide - what the service does and when to reach for it.
- API reference - every endpoint these commands call.
- CLI reference - global options, output modes, and exit codes.