Sazabi
CLI

sazabi billing

Command reference for sazabi billing.

sazabi billing — View and manage billing — usage, plans, credits, and subscribe. Subcommands: summary, usage, charges, invoices, transactions, auto-top-up, credits, plans, payment-methods.

sazabi billing

View and manage billing — usage, plans, credits, and subscribe

sazabi billing <subcommand>
sazabi billing summary  # Show billing plan and balance
sazabi billing plans subscribe --plan team-v1 --yes  # Subscribe from the terminal
sazabi billing credits purchase --amount 50  # Buy credits
sazabi billing auto-top-up set --enable --trigger-balance 10 --amount 50 --cycle-limit 200  # Enable auto top-up

sazabi billing summary

Show the billing summary for your organization

sazabi billing summary [options]
FlagTypeRequiredDescription
--tokenstringNoOverride token
--api-base-urlstringNoOverride API base URL
--jsonbooleanNoOutput as JSON
sazabi billing summary  # Show billing summary
sazabi billing summary --json  # Output as JSON

sazabi billing usage

Show per-dimension usage for the current or previous cycle

sazabi billing usage [options]
FlagTypeRequiredDescription
--tokenstringNoOverride token
--api-base-urlstringNoOverride API base URL
--jsonbooleanNoOutput as JSON
--cyclestringNoWhich cycle to report (current or previous)
sazabi billing usage  # Current cycle usage
sazabi billing usage --cycle previous  # Previous cycle usage
sazabi billing usage --json  # Output as JSON

sazabi billing charges

Show usage charges accrued so far in the open billing cycle

sazabi billing charges [options]
FlagTypeRequiredDescription
--tokenstringNoOverride token
--api-base-urlstringNoOverride API base URL
--jsonbooleanNoOutput as JSON
sazabi billing charges  # Accrued this cycle

sazabi billing invoices

List cycle-end usage invoices (the local settlement record)

sazabi billing invoices [options]
FlagTypeRequiredDescription
--tokenstringNoOverride token
--api-base-urlstringNoOverride API base URL
--jsonbooleanNoOutput as JSON
--limitstringNoMaximum invoices to return (default 24, max 100)
sazabi billing invoices  # Recent usage invoices
sazabi billing invoices --limit 5 --json  # Five newest, as JSON

sazabi billing transactions

List credit ledger transactions

sazabi billing transactions <subcommand> [options]
FlagTypeRequiredDescription
--tokenstringNoOverride token
--api-base-urlstringNoOverride API base URL
--jsonbooleanNoOutput as JSON
--limitstringNoMax results per page (default 10, max 100)
--pagestringNoPage number (1-indexed)

sazabi billing transactions list

List credit ledger transactions

sazabi billing transactions list [options]
FlagTypeRequiredDescription
--tokenstringNoOverride token
--api-base-urlstringNoOverride API base URL
--jsonbooleanNoOutput as JSON
--limitstringNoMax results per page (default 10, max 100)
--pagestringNoPage number (1-indexed)
sazabi billing transactions list --page 2  # List the second page

sazabi billing auto-top-up

View or configure credit auto top-up

sazabi billing auto-top-up <subcommand>

sazabi billing auto-top-up get

Show the current auto top-up settings

sazabi billing auto-top-up get [options]
FlagTypeRequiredDescription
--tokenstringNoOverride token
--api-base-urlstringNoOverride API base URL
--jsonbooleanNoOutput as JSON
sazabi billing auto-top-up get  # Show current auto top-up settings

sazabi billing auto-top-up set

Enable/disable and configure auto top-up

sazabi billing auto-top-up set [options]
FlagTypeRequiredDescription
--tokenstringNoOverride token
--api-base-urlstringNoOverride API base URL
--jsonbooleanNoOutput as JSON
--enablebooleanNoEnable auto top-up
--disablebooleanNoDisable auto top-up
--trigger-balancestringNoCredit balance that triggers a top-up
--amountstringNoCurrency amount to charge per top-up
--cycle-limitstringNoMaximum auto top-up spend per cycle
--yesbooleanNoSkip the confirmation prompt
sazabi billing auto-top-up set --enable --trigger-balance 10 --amount 50 --cycle-limit 200  # Enable auto top-up
sazabi billing auto-top-up set --disable  # Turn auto top-up off

sazabi billing credits

Purchase credits

sazabi billing credits <subcommand>

sazabi billing credits purchase

Buy a one-time amount of credits with the saved payment method

sazabi billing credits purchase [options]
FlagTypeRequiredDescription
--tokenstringNoOverride token
--api-base-urlstringNoOverride API base URL
--jsonbooleanNoOutput as JSON
--amountstringNoDollar amount of credits to purchase (e.g. 50)
--idempotency-keystringNoExplicit idempotency key (advanced; auto-generated otherwise)
--yesbooleanNoSkip the confirmation prompt
sazabi billing credits purchase --amount 50  # Buy $50 of credits (prompts to confirm)
sazabi billing credits purchase --amount 50 --yes  # Buy without a prompt

sazabi billing plans

View and manage subscription plans

sazabi billing plans <subcommand>

sazabi billing plans list

List the self-serve plans available for checkout

sazabi billing plans list [options]
FlagTypeRequiredDescription
--tokenstringNoOverride token
--api-base-urlstringNoOverride API base URL
--jsonbooleanNoOutput as JSON
sazabi billing plans list  # List plans available for checkout

sazabi billing plans current

Show the current plan

sazabi billing plans current [options]
FlagTypeRequiredDescription
--tokenstringNoOverride token
--api-base-urlstringNoOverride API base URL
--jsonbooleanNoOutput as JSON

sazabi billing plans subscribe

Subscribe or resubscribe through secure checkout

sazabi billing plans subscribe [options]
FlagTypeRequiredDescription
--tokenstringNoOverride token
--api-base-urlstringNoOverride API base URL
--jsonbooleanNoOutput as JSON
--planstringNoTarget plan slug (see sazabi billing plans list)
--yesbooleanNoSkip confirmation
--no-browserbooleanNoDo not launch a browser; print the URL to stderr
--waitbooleanNoWait for the browser handoff to complete

sazabi billing plans preview

Preview the financial effect of switching plans

sazabi billing plans preview [options]
FlagTypeRequiredDescription
--tokenstringNoOverride token
--api-base-urlstringNoOverride API base URL
--jsonbooleanNoOutput as JSON
--planstringNoTarget plan slug (see sazabi billing plans list)

sazabi billing plans switch

Switch plans after preview and confirmation

sazabi billing plans switch [options]
FlagTypeRequiredDescription
--tokenstringNoOverride token
--api-base-urlstringNoOverride API base URL
--jsonbooleanNoOutput as JSON
--planstringNoTarget plan slug (see sazabi billing plans list)
--yesbooleanNoSkip confirmation

sazabi billing plans cancel

Schedule cancellation at the end of the paid period

sazabi billing plans cancel [options]
FlagTypeRequiredDescription
--tokenstringNoOverride token
--api-base-urlstringNoOverride API base URL
--jsonbooleanNoOutput as JSON
--yesbooleanNoSkip confirmation

sazabi billing plans resume

Clear a not-yet-effective cancellation

sazabi billing plans resume [options]
FlagTypeRequiredDescription
--tokenstringNoOverride token
--api-base-urlstringNoOverride API base URL
--jsonbooleanNoOutput as JSON
--yesbooleanNoSkip confirmation

sazabi billing payment-methods

View or update the saved payment method

sazabi billing payment-methods <subcommand>

sazabi billing payment-methods current

Show safe current payment method metadata

sazabi billing payment-methods current [options]
FlagTypeRequiredDescription
--tokenstringNoOverride token
--api-base-urlstringNoOverride API base URL
--jsonbooleanNoOutput as JSON

sazabi billing payment-methods update

Open the secure billing portal to update the payment method

sazabi billing payment-methods update [options]
FlagTypeRequiredDescription
--tokenstringNoOverride token
--api-base-urlstringNoOverride API base URL
--jsonbooleanNoOutput as JSON
--yesbooleanNoSkip confirmation
--no-browserbooleanNoDo not launch a browser; print the URL to stderr
--waitbooleanNoWait before refreshing