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

# Account, team, usage, and billing

> Manage account profile details, members, invites, usage, limits, billing, and API tokens from the CLI.

This page covers account-level commands and chatbot team-management commands.

## Account profile

```bash theme={null}
sitegpt account show
sitegpt account show --json
```

Update your account name:

```bash theme={null}
sitegpt account update --name "Jane Doe"
```

Upload or remove your profile picture:

```bash theme={null}
sitegpt account picture upload ./avatar.png
sitegpt account picture add ./avatar.png
sitegpt account picture delete --yes
sitegpt account picture remove --yes
```

`picture add` is an alias for `picture upload`, and `picture remove` is an alias for `picture delete`.

## Usage and limits

Usage shows current account usage. Limits shows account limits and remaining capacity.

```bash theme={null}
sitegpt usage
sitegpt usage --json
sitegpt limits
sitegpt limits --json
```

Use these before large knowledge operations:

```bash theme={null}
sitegpt limits --json
sitegpt knowledge sitemap add --chatbot <chatbot-id> https://example.com/sitemap.xml --max-links 500
```

## Billing

```bash theme={null}
sitegpt billing subscription
sitegpt billing subscription --json
sitegpt billing invoices
sitegpt billing invoices --json
```

Invoice output includes invoice identifiers, status, billing date, amount, currency, and download links when available.

<Note>
  Billing access requires `billing:read`. Write actions for billing are not normally needed by day-to-day CLI users.
</Note>

## API tokens

Token commands create, list, rotate, and revoke scoped SiteGPT credentials. See [Authentication and scopes](/cli/authentication) for scope details.

```bash theme={null}
sitegpt tokens list
sitegpt tokens list --include-revoked
sitegpt tokens create --name "Knowledge agent" --scope knowledge:read --scope knowledge:write
sitegpt tokens create --name "One-chatbot agent" --chatbot <chatbot-id> --scope chatbots:read --scope knowledge:write
sitegpt tokens rotate <token-id>
sitegpt tokens revoke <token-id>
```

Token create options:

| Option                      | Description                                                       |
| --------------------------- | ----------------------------------------------------------------- |
| `--name <name>`             | Required token name.                                              |
| `--scope <scope>`           | Required scope. Repeatable.                                       |
| `--chatbot <chatbot-id>`    | Restrict token to selected chatbots. Repeatable.                  |
| `--expires-in-days <1-365>` | Relative expiration. Default: `90`.                               |
| `--expires-at <iso-date>`   | Absolute expiration. Cannot be combined with `--expires-in-days`. |

New and rotated tokens are shown once. Store the plaintext token immediately.

## Members

Members are people who can access a chatbot in the dashboard and through role-aware CLI/API permissions.

```bash theme={null}
sitegpt members list --chatbot <chatbot-id>
sitegpt members list --chatbot <chatbot-id> --json
sitegpt members invite --chatbot <chatbot-id> jane@example.com
sitegpt members invite --chatbot <chatbot-id> jane@example.com --role MANAGER
sitegpt members add --chatbot <chatbot-id> jane@example.com --role MANAGER
sitegpt members remove --chatbot <chatbot-id> <user-id> --yes
```

`members add` adds a member directly with no invite email and no expiring link (the account is provisioned if it does not exist yet), whereas `members invite` emails a magic-link invitation the person must accept. Use `add` for backend or scripted onboarding.

Allowed member roles:

```text theme={null}
AGENT, MANAGER, ADMIN, SUPER_ADMIN
```

`members delete` is an alias for `members remove`.

## Member invites

```bash theme={null}
sitegpt member-invites list --chatbot <chatbot-id>
sitegpt member-invites list --chatbot <chatbot-id> --json
sitegpt member-invites cancel --chatbot <chatbot-id> <invite-id> --yes
sitegpt member-invites delete --chatbot <chatbot-id> <invite-id> --yes
```

Use invites to review pending team invitations and cancel old invites.

## Recommended account checks for agents

At the start of a serious automation session, ask the agent to run:

```bash theme={null}
sitegpt whoami --json
sitegpt profiles list --json
sitegpt usage --json
sitegpt limits --json
sitegpt chatbots list --json
```

This gives the agent the active account, profile, remaining capacity, and chatbot IDs before it changes anything.

## Full reference

* [Account](/cli/command-reference#account)
* [Usage](/cli/command-reference#usage)
* [Limits](/cli/command-reference#limits)
* [Billing](/cli/command-reference#billing)
* [API tokens](/cli/command-reference#api-tokens)
* [Members](/cli/command-reference#members)
* [Member invites](/cli/command-reference#member-invites)