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.
This page covers account-level commands and chatbot team-management commands.
Account profile
sitegpt account show
sitegpt account show --json
Update your account name:
sitegpt account update --name "Jane Doe"
Upload or remove your profile picture:
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.
sitegpt usage
sitegpt usage --json
sitegpt limits
sitegpt limits --json
Use these before large knowledge operations:
sitegpt limits --json
sitegpt knowledge sitemap add --chatbot <chatbot-id> https://example.com/sitemap.xml --max-links 500
Billing
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.
Billing access requires billing:read. Write actions for billing are not normally needed by day-to-day CLI users.
API tokens
Token commands create, list, rotate, and revoke scoped SiteGPT credentials. See Authentication and scopes for scope details.
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.
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 remove --chatbot <chatbot-id> <user-id> --yes
Allowed member roles:
AGENT, MANAGER, ADMIN, SUPER_ADMIN
members delete is an alias for members remove.
Member invites
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:
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