> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://platform.bctrl.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://platform.bctrl.ai/_mcp/server.

# Account Commands

> Manage branding, API keys, notification recipients, subaccounts, and usage.

Manage branding, API keys, notification recipients, subaccounts, and usage.

Output formatting flags (`--json`, `--jq`, and `--template`) are documented once in [Output Formatting](/cli/output) and are omitted from the tables below.

## `bctrl account get`

Get organization settings

```bash
bctrl account get
```

## `bctrl account patch`

Update organization settings (use --body for branding merge-patch JSON)

```bash
bctrl account patch [flags]
```

| Flag        | Description                             |
| ----------- | --------------------------------------- |
| `--dry-run` | Validate and resolve without persisting |

## `bctrl api-key list`

List API keys

```bash
bctrl api-key list [flags]
```

| Flag                   | Description                                        |
| ---------------------- | -------------------------------------------------- |
| `--subaccount-id <id>` | Filter by subaccount id                            |
| `--type <type>`        | Filter by API key type: organization or subaccount |
| `-L, --limit <number>` | Maximum number of results to return                |
| `--cursor <cursor>`    | Pagination cursor                                  |

## `bctrl api-key create`

Create an API key

```bash
bctrl api-key create [flags]
```

| Flag                   | Description                              |
| ---------------------- | ---------------------------------------- |
| `--name <name>`        | API key name                             |
| `--subaccount-id <id>` | Create a key confined to this Subaccount |
| `--expires-at <iso>`   | Expiration timestamp                     |

## `bctrl api-key delete`

Delete an API key

```bash
bctrl api-key delete <keyId> [flags]
```

| Flag        | Description      |
| ----------- | ---------------- |
| `-y, --yes` | Confirm deletion |

## `bctrl notification-recipient list`

List notification recipients

```bash
bctrl notification-recipient list [flags]
```

| Flag                   | Description                                                    |
| ---------------------- | -------------------------------------------------------------- |
| `--type <type>`        | Filter by recipient type. Choices: `email`, `sms`, `whatsapp`. |
| `--enabled <enabled>`  | Filter by enabled state. Choices: `true`, `false`.             |
| `-L, --limit <number>` | Maximum number of results to return                            |
| `--cursor <cursor>`    | Pagination cursor                                              |

## `bctrl notification-recipient create`

Create a notification recipient

```bash
bctrl notification-recipient create [flags]
```

| Flag              | Description                                          |
| ----------------- | ---------------------------------------------------- |
| `--type <type>`   | Recipient type. Choices: `email`, `sms`, `whatsapp`. |
| `--value <value>` | Email address, SMS number, or WhatsApp number        |
| `--name <name>`   | Display name                                         |

## `bctrl notification-recipient patch`

Update a notification recipient

```bash
bctrl notification-recipient patch <recipientId> [flags]
```

| Flag                  | Description                                   |
| --------------------- | --------------------------------------------- |
| `--value <value>`     | Email address, SMS number, or WhatsApp number |
| `--name <name>`       | Display name                                  |
| `--clear-name`        | Clear the display name                        |
| `--enabled <enabled>` | Set enabled state. Choices: `true`, `false`.  |

## `bctrl notification-recipient delete`

Delete a notification recipient

```bash
bctrl notification-recipient delete <recipientId> [flags]
```

| Flag        | Description      |
| ----------- | ---------------- |
| `-y, --yes` | Confirm deletion |

## `bctrl subaccount list`

List subaccounts

```bash
bctrl subaccount list [flags]
```

| Flag                   | Description                         |
| ---------------------- | ----------------------------------- |
| `-L, --limit <number>` | Maximum number of results to return |
| `--cursor <cursor>`    | Pagination cursor                   |
| `--include-usage`      | Inline current usage                |
| `--status <status>`    | Filter by status                    |
| `--external-id <id>`   | Filter by external id               |
| `--q <text>`           | Search by id, name, or external id  |

## `bctrl subaccount get`

Get a subaccount

```bash
bctrl subaccount get <subaccountId> [flags]
```

| Flag                | Description                             |
| ------------------- | --------------------------------------- |
| `--include <value>` | Include related data, for example usage |

## `bctrl subaccount create`

Create a subaccount

```bash
bctrl subaccount create [flags]
```

| Flag                     | Description        |
| ------------------------ | ------------------ |
| `--name <name>`          | Subaccount name    |
| `--external-id <id>`     | External id        |
| `--metadata-file <path>` | Metadata JSON file |

## `bctrl subaccount patch`

Update a subaccount

```bash
bctrl subaccount patch <subaccountId> [flags]
```

| Flag                     | Description        |
| ------------------------ | ------------------ |
| `--name <name>`          | Subaccount name    |
| `--external-id <id>`     | External id        |
| `--metadata-file <path>` | Metadata JSON file |

## `bctrl subaccount archive`

Archive a subaccount

```bash
bctrl subaccount archive <subaccountId> [flags]
```

| Flag        | Description     |
| ----------- | --------------- |
| `-y, --yes` | Confirm archive |

## `bctrl subaccount usage`

Show subaccount usage

```bash
bctrl subaccount usage [id] [flags]
```

| Flag                   | Description                               |
| ---------------------- | ----------------------------------------- |
| `-L, --limit <number>` | Maximum number of usage records to return |
| `--cursor <cursor>`    | Pagination cursor                         |

## `bctrl usage get`

Get organization usage

```bash
bctrl usage get
```