Skip to main content

Company and Account

Four namespaces covering who you are and what your company is spending: user reads your own identity and scope, company administers members and roles, billing exposes the whole self-service billing picture, and payments is Autessa Payments. Reads are broadly open to members; the writes need the matching permission.

Who am I?​

The first command to run when a script misbehaves or a permission error surprises you:

autessa user role
{
  "permissions": [
    { "permission": "AGENTIC_WORKFLOW", "id": "lhQ63Oc2DbO" },
    { "permission": "AUTESSADB", "id": "1NL5iAqgaBP" },
    { "permission": "API_KEY", "id": "zfDFbdhOrxr" },
    { "permission": "SCHEDULED_EVENTS", "id": "Ka62l7LpFzf" },
    { "permission": "APP_BUILDER", "id": "V7ScwapLsCt" },
    { "permission": "SCRIPTING", "id": "oj5g1rED8uP" }
  ]
}

It returns your identity, your effective permissions in the active company, the active company (currentScope), and every company you can access (availableCompanies). When a command fails with a permission error, this tells you whether you lack the permission or are simply scoped to the wrong company.

To change which company you are working in, sign in again with that company selected — autessa login, or a separate profile per tenant. Setting a default scope is web-app-only, and everything else in the user namespace is poweruser API-key management, also done in the browser. See Poweruser keys.
7 commands1 runnable6 in the web app
CommandWhat it does
autessa user generate-poweruser-keyWeb appPoweruser API keys are generated from your account settings in the web app.
autessa user generate-temporary-poweruser-keyWeb appTemporary poweruser API keys are issued from your account settings in the web app.
autessa user poweruser-key-statusWeb appPoweruser API key status is shown in your account settings in the web app.
autessa user revoke-poweruser-keyWeb appPoweruser API keys are revoked from your account settings in the web app.
autessa user roleRead the current user — their identity, effective permissions in the active company, the active company (currentScope), and every company they can access (availableCompanies).
autessa user rotate-poweruser-keyWeb appPoweruser API keys are rotated from your account settings in the web app.
autessa user set-default-scopeWeb appThe default company scope is set from your account settings in the web app.

Company​

Everything here acts on your active company except create, which makes a new one you own.

Members and roles​

autessa company roles
autessa company members

roles lists the six built-in roles plus any custom ones, with their ids. members lists each member and their effective permissions. You need role ids before you can invite or reassign:

autessa company invite \
  --email "teammate@example.com" \
  --roleIds '["<roleId>","<roleId>"]'

autessa company set-member-roles --userId <id> --roleIds '["<roleId>"]'

autessa company remove-member --userId <id>
set-member-roles replaces the member's roles rather than adding to them. Read company members first and send the full intended set, or you will silently strip access.

Administration needs the manage-team-members permission; reads are open to members.

Usage against limits​

autessa company usage-status

Reports current usage against every limit dimension — entities, executions, LLM and vibecode credits, phone, storage, semantic search, browser, and AI-task metering. This is the command to poll before a bulk job, and the one to check first when something starts failing for no obvious reason.

Creating and renaming​

autessa company create --json '{...}'
autessa company update --json '{...}'

create makes a new company owned by you, optionally making it your default scope. update renames the current one. Ownership transfer, billing setup and SSO are web-app-only.

8 commands8 runnable
CommandWhat it does
autessa company createCreate a new company owned by the current user, optionally making it the caller's default scope.
autessa company inviteInvite someone to the company by email, granting them one or more roles; sends an invitation email.
autessa company membersList the company's members and each member's effective permissions.
autessa company remove-memberRemove a member from the company.
autessa company rolesList the roles available in the company (the six built-in roles plus any custom roles).
autessa company set-member-rolesSet the roles assigned to a company member.
autessa company updateRename the company.
autessa company usage-statusRead the company's current usage against every limit dimension (entities, executions, LLM/vibecode credits, phone, storage, semantic search, browser, and AI-task metering).

Billing​

Money is always in cents. Reads are open to members; address and budget writes need the billing permission.

Where the money stands​

autessa billing account          # prepaid balance, payment state, recent ledger entries
autessa billing plan             # commitment, remaining credit, resolved per-task rate, next invoice date
autessa billing budget           # hard caps, soft warning target, accrued usage this period
autessa billing invoices         # newest first
autessa billing invoice-preview  # this period's invoice computed live, persisting nothing

invoice-preview is the useful one mid-month: it runs the same math as month-end without writing anything, so you can see where the period is heading.

Per-task drill-down​

autessa billing tasks --period 202609 --page 0 --pageSize 50
autessa billing task --json '{...}'

tasks lists individual AI-task rows for a period (YYYYMM, defaulting to the current one). task returns the itemized receipt for one — metadata, token/voice/RAG usage, per-component cost at the resolved rate, and whether the amount is frozen because it has been invoiced or is still a live estimate.

Setting budgets​

autessa billing set-budget \
  --userHardBudgetCents 50000 \
  --userSoftWarnPercents '[50,80,95]' \
  --budgetNotifyEmails '["finance@example.com"]'

autessa billing set-address --json '{...}'

A hard cap stops spend; a soft target only warns. userSoftWarnPercents are percentages of the cap at which warnings fire, and up to five extra recipients can be warned alongside the owner.

Paying an invoice, prepaying, changing your plan commitment, configuring auto-evaluation, and adding or removing payment methods are deliberately not in the CLI — they are done on the billing page in the web app. Reading all of it, including sources and payment-config, is available here.
19 commands12 runnable7 in the web app
CommandWhat it does
autessa billing accountRead the company's billing account standing — prepaid balance, payment state, and the most recent prepaid-ledger entries.
autessa billing addressRead the company's billing/tax address — the jurisdiction used for tax and the invoice bill-to.
autessa billing budgetRead the company's budget limits and current spend this period — hard cost/task caps, the soft warning target and thresholds, extra notification recipients, and accrued usage.
autessa billing configure-autoevalWeb appAuto-evaluation billing is configured from your company's billing page in the web app.
autessa billing invoice-linkWeb appHosted invoice links are generated from your company's billing page in the web app.
autessa billing invoice-previewPreview the current period's invoice mid-month — the same math as month-end, computed live and persisting nothing.
autessa billing invoicesList the company's invoices, newest first.
autessa billing pay-invoiceWeb appInvoices are paid from your company's billing page in the web app.
autessa billing payment-configRead the company's payment configuration — whether a card is on file (with its brand and last four), the billing currency, and whether bank linking is available.
autessa billing planRead the company's plan — active monthly commitment and any scheduled change, remaining commitment credit, the resolved per-task rate in effect now, the public rate-curve anchors, any enterprise grant allowance, and the next invoice date and payment term.
autessa billing prepayWeb appPrepayments are made from your company's billing page in the web app.
autessa billing remove-sourceWeb appPayment methods are removed from your company's billing page in the web app.
autessa billing set-addressSet the company's billing/tax address (tax jurisdiction + invoice bill-to).
autessa billing set-budgetSet the company's budget limits — hard cost/task caps, the soft warning target and thresholds, and extra notification recipients.
autessa billing set-commitmentWeb appPlan commitments are changed from your company's billing page in the web app.
autessa billing set-default-sourceWeb appThe default payment method is set from your company's billing page in the web app.
autessa billing sourcesList the company's saved payment methods (cards and bank accounts) with their brand/bank, last four, status, and which is the default.
autessa billing taskRead the itemized cost receipt for one AI task (the per-task drill-down) — its metadata, token/voice/RAG usage, per-component cost at the resolved rate, and whether the amount is frozen (invoiced) or a live estimate.
autessa billing tasksList the company's individual AI-task rows for one period (the billing usage drill-down), paginated.

Payments​

Autessa Payments — onboarding to accept payments, payout bank accounts and schedule, tax registrations, wallet domains, transactions and tax summaries.

Every command in this namespace is web-app-only. Payment onboarding uses embedded components that need a browser, and payout/bank changes are deliberately gated behind a human step:

autessa payments add-bank-account
Payout bank accounts are linked from your Autessa Payments settings in the web app.
15 commands15 in the web app
CommandWhat it does
autessa payments add-bank-accountWeb appPayout bank accounts are linked from your Autessa Payments settings in the web app.
autessa payments create-bank-link-sessionWeb appPayout bank accounts are linked from your Autessa Payments settings in the web app.
autessa payments create-invoice-intentWeb appInvoice payments are collected through the Autessa Payments checkout in the web app.
autessa payments create-tax-registrationWeb appTax registrations are added from your Autessa Payments settings in the web app.
autessa payments get-account-sessionWeb appAutessa Payments account setup is managed with embedded components in the web app.
autessa payments get-statusWeb appAutessa Payments account status is viewed from your payments settings in the web app.
autessa payments get-tax-summaryWeb appThe tax summary is viewed from your Autessa Payments dashboard in the web app.
autessa payments initiate-onboardingWeb appAutessa Payments onboarding is started from your payments settings in the web app.
autessa payments list-bank-accountsWeb appLinked payout bank accounts are viewed from your Autessa Payments settings in the web app.
autessa payments list-tax-registrationsWeb appTax registrations are viewed from your Autessa Payments settings in the web app.
autessa payments list-transactionsWeb appAutessa Payments transactions are viewed from your payments dashboard in the web app.
autessa payments register-wallet-domainWeb appApple Pay / Google Pay domains are registered from your Autessa Payments settings in the web app.
autessa payments remove-bank-accountWeb appPayout bank accounts are removed from your Autessa Payments settings in the web app.
autessa payments set-default-bank-accountWeb appThe default payout bank account is set from your Autessa Payments settings in the web app.
autessa payments set-payout-scheduleWeb appThe payout schedule is set from your Autessa Payments settings in the web app.

Tutorials​

In-app tutorial and onboarding progress. Both commands are web-app-only.

2 commands2 in the web app
CommandWhat it does
autessa tutorials completeWeb appTutorials are marked complete from the tutorials page in the web app.
autessa tutorials listWeb appTutorials and course progress are viewed from the tutorials page in the web app.