forge wallet

Operator CLI for workspace wallets — balance, transactions, debits, credits, and auto-refill.

Command

forge wallet <subcommand> <workspaceId> [flags]

None. Use a

<subcommand>

— run

forge --help

for per-subcommand arguments.

None.

Subcommand	Usage
`balance`	`forge wallet balance <workspaceId>`
`transactions`	`forge wallet transactions <workspaceId> [--limit N] [--cursor X] [--category Y]`
`debit`	`forge wallet debit <workspaceId> --amount <cents> [--source S] [--description D] [--idempotency-key K]`
`credit`	`forge wallet credit <workspaceId> --amount <cents>`
`freeze`	`forge wallet freeze <workspaceId> --reason "..."`
`unfreeze`	`forge wallet unfreeze <workspaceId>`
`refill`	`forge wallet refill <workspaceId> --amount <cents> [--success-url U] [--cancel-url U]`
`auto-refill`	`forge wallet auto-refill <workspaceId> [--threshold N] [--amount N] [--enabled\|--disabled]`
`alerts`	`forge wallet alerts <workspaceId>`

Check balance:

forge wallet balance ws_xxxxx
# → Balance: 4500 credits ($45.00)

Debit a wallet:

forge wallet debit ws_xxxxx --amount 500 --source compute --description "GPU job #42"

Credit a wallet (admin only):

forge wallet credit ws_xxxxx --amount 1000

Set up auto-refill:

forge wallet auto-refill ws_xxxxx --threshold 1000 --amount 5000 --enabled

Debit returns 422 for insufficient funds, 423 for frozen wallets.
Credit is admin-only — only admin API keys can credit wallets.
Refill amounts must be between 500 and 50000 cents.
Idempotency key — use
```
--idempotency-key
```
to safely retry debit operations.

{auto-injected}