Skip to main content
Use these commands for your own account and for the people who work on a chatbot. For every option, see the command reference: Account, Usage, Limits, Billing, API tokens, Members, and Member invites.

​
Before you start

  • A SiteGPT account on the Growth plan or above. See Plans and limits.
  • The CLI installed and logged in. See Install and log in.
  • The default access from sitegpt login covers most tasks on this page. It cannot create, rotate, or revoke API tokens. For those tasks, see Create an API token.
  • For billing, you must be the account owner.
  • For team tasks, your chatbot ID and a role that can manage members. See Team members.

​
Check who you are logged in as

To see your account details, run sitegpt account show. Check that it works: account show prints your email, your name, your profile picture, and the credential type.

​
Change your name or profile picture

To remove the picture, run sitegpt account picture delete --yes. picture add does the same as picture upload, and picture remove does the same as picture delete. Check that it works: The CLI prints Updated account name to Jane Doe. and Updated profile picture for with your email.

​
Check usage and limits

Check that you have enough capacity before a large import:
  • usage shows each metric with the amount used, the quota, and what remains.
  • limits shows the total, the amount assigned, and what is available. It also shows what each chatbot has.
Check that it works: The usage table has the columns Metric, Used, Quota, and Remaining.

​
Read your subscription and invoices

The token needs the billing:read scope. These commands only read data. You cannot change your plan or payment details from the CLI. See Billing. Check that it works: billing subscription prints the status and the next billing date. If you have no subscription, it prints No active subscription found. billing invoices lists your invoices with download links when available.

​
Create an API token

Create a separate token for each tool or AI agent, with only the scopes that it needs. For the list of scopes, see Authentication.
1

Log in with token access

The token that you use must have the tokens:write scope. The default login does not include it. Log in with full access:
You can also create tokens on the Agents page in the dashboard.
2

Create the token

  • --name and at least one --scope are required.
  • --chatbot limits the token to one chatbot. You can repeat it.
  • The token expires after 90 days by default. Use --expires-in-days (1 to 365) or --expires-at to change it.
3

Save the token

Copy the token value from the output and store it in a safe place. SiteGPT shows it only once.
Check that it works: sitegpt tokens list shows the new token with its scopes and expiry date.

​
Rotate or revoke a token

Rotate a token to get a new value with the same settings. The old value stops working.
Revoke a token to stop it at once:
Both commands need the tokens:write scope. Find the token ID with sitegpt tokens list. Check that it works: rotate prints Rotated token and the new value. Store it, because SiteGPT shows it only once. revoke prints Revoked token. sitegpt tokens list --include-revoked shows the token as revoked.

​
Add a team member

There are two ways to add a person to a chatbot:
  • members add adds the person at once. It sends no invite email. If the person has no SiteGPT account, SiteGPT creates one. Use it for scripted setup.
  • members invite sends an invite email. The person must accept it.
The roles are AGENT, MANAGER, ADMIN, and SUPER_ADMIN. The default is AGENT. See Team members. Check that it works: The CLI prints Added or Invited, the email, and the role. sitegpt members list --chatbot YOUR_CHATBOT_ID shows the member. Pending invites show under Pending invites.

​
Remove a team member

Find the user ID with sitegpt members list --chatbot YOUR_CHATBOT_ID. members delete does the same as members remove. Check that it works: The CLI prints Removed and the email. The person is no longer in members list.

​
Cancel a pending invite

member-invites delete does the same as member-invites cancel. Check that it works: The CLI prints Canceled invite for and the email. The invite is no longer in member-invites list.

​
Check the account before an AI agent makes changes

Ask the agent to run these commands at the start of a session:
The agent then knows the active account and profile, the capacity that is left, and the chatbot IDs before it changes anything. See Use the CLI with AI agents. Check that it works: Each command returns JSON with "ok": true.