> ## Documentation Index
> Fetch the complete documentation index at: https://docs.60db.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Credits

> Credit management commands

# Credits

## Workspace Wallet

All credits and wallet balances are managed at the **workspace level**. Each workspace has its own USD wallet. When you add credits, they go to the specified workspace — not to a user account.

## Commands

### Add Bonus Credits

```bash theme={null}
60db credits:add --user-id 123 --workspace-id 24 --tts 1000 --stt 60 --voice 10
```

### Add Wallet Amount (to workspace)

```bash theme={null}
60db credits:add --user-id 123 --workspace-id 24 --amount 50.00 --description "Refund"
```

### Add Both Bonus Credits and Amount

```bash theme={null}
60db credits:add --user-id 123 --workspace-id 24 --tts 1000 --amount 25.00
```

### Get Workspace Balance

```bash theme={null}
60db credits:balance --user-id 123
```

### Get Transaction History

```bash theme={null}
60db credits:history --user-id 123 --limit 20
```

## Options

### Add Credits

* `--user-id <id>` - User ID (required)
* `--workspace-id <id>` - Workspace ID (if omitted, uses user's primary workspace)
* `--tts <number>` - TTS bonus credits (characters)
* `--stt <number>` - STT bonus credits (in seconds)
* `--voice <number>` - Voice cloning bonus credits
* `--amount <number>` - Wallet amount in USD
* `--description <text>` - Transaction description

### Get Balance

* `--user-id <id>` - User ID (required)

### Get History

* `--user-id <id>` - User ID (required)
* `--limit <number>` - Number of transactions to return
* `--offset <number>` - Offset for pagination

<Info>
  All wallet amounts are in **USD only**. Multi-currency is not supported.
</Info>

## Examples

### Add Credits to a Workspace

```bash theme={null}
60db credits:add --user-id 123 --workspace-id 24 --amount 10 --description "Monthly bonus"
```

### Add Credits to Multiple Workspaces

```bash theme={null}
for ws_id in 24 25 26; do
  60db credits:add --user-id 123 --workspace-id $ws_id --amount 10 --description "Monthly bonus"
done
```
