> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mentionlab.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Organization & Billing
> Manage your team, roles, tokens, and API keys
Your organization is the top-level entity in MentionLab. It groups your projects, team members,
billing and API keys. Reach it from **Organization → Settings**.
## General
Two fields: your **Organisation ID** (read-only, useful when contacting support) and the
organization **Name**. Only Administrators can save changes.
***
## Users
**Organization Settings → Users** lists your members and any pending invitations.
### Roles
| Role | What it can do |
| ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Administrator** | Everything: settings, billing, users, API keys, projects |
| **Editor** | Create and modify projects, queries and configurations. Can view API keys but not create or delete them |
| **Viewer** | Read-only access to dashboards and analysis |
| **Super viewer** | Viewer access, plus can see the member list and invite new members — but only as Viewers. Cannot remove members, change roles or cancel invitations |
A fifth role, **Super-org admin**, exists on organizations that manage linked organizations. It
cannot be assigned from the app — contact [support@mentionlab.io](mailto:support@mentionlab.io).
### Adding a member
Click **Add user**, enter their email and pick the **Role** — the role is chosen at invite time, not
after they accept. If they already have a MentionLab account they join immediately; otherwise they
receive an invitation email.
Pending invitations appear in their own **Pending Invitations** list below the member grid, where
you can cancel any of them.
Use **Viewer** for stakeholders who only read reports. It keeps your monitoring configuration safe
from accidental edits.
### Single sign-on
SSO (SAML) is available on Enterprise agreements and is configured by MentionLab, not self-serve.
Contact [support@mentionlab.io](mailto:support@mentionlab.io) to set it up.
***
## Project members
Projects have their own roles, independent of organization roles:
| Role | What it can do |
| ----------- | ----------------------------------------------------------------------- |
| **Manager** | Full control of the project, including managing its members |
| **Editor** | Modify queries, tags, entities and settings — but cannot manage members |
| **Viewer** | Read-only access to the project's analysis |
Manage them from **Project settings → Members**, visible to Managers and Editors only.
***
## Billing
MentionLab bills in **tokens**. Every query execution consumes tokens:
$\text{Tokens per run} = \text{Queries} \times \text{AI Models} \times \text{Iterations}$
The billing area lives at **Organization Settings → Billing** and is open to Administrators and
Editors.
The REST API and OpenAPI schema still call this unit *credits* (`availableCredits`,
`perCreditCents`). Tokens and credits are the same thing.
### Overview
Three headline tiles:
* **Available tokens** — your current balance, with a note of anything expiring soon.
* **Monthly tokens** — allowance remaining in this cycle, with the renewal date.
* **Account status** — Active, Suspended or Frozen, plus your billing mode and next charge.
Below them: your current subscription with its cycle and per-cycle price, and shortcuts to buy
tokens or change plan.
### Choose a plan
Three self-serve tiers — **Launch**, **Scale** and **Business** — plus **Enterprise** for custom
volume, SSO/SAML and a dedicated account manager. Longer billing cycles (quarterly, semi-annual,
annual) unlock volume discounts.
Same-cycle upgrades take effect immediately and are pro-rated. Plan or cycle changes are scheduled
for the end of your current cycle.
### Buy tokens
**One-time top-up** — pick an amount, see the quote, pay by card. Tokens land once payment clears.
The per-token rate drops as the amount rises.
**Multi-month plan** — commit to a total volume delivered monthly over 3, 6 or 12 months, and lock
today's rate for the term. Available on invoiced agreements; talk to us to set one up.
On self-serve billing, one-time top-ups require an active subscription.
Add your legal name, billing address and tax ID under **Billing → Settings** before your first
purchase. Without a tax ID on file, Belgian VAT is added at checkout — EU-registered businesses
should add theirs to benefit from reverse-charge.
### Activity
Three views:
* **Balance** — your token pockets, broken into the lots that make them up: source (Monthly
allowance, Purchase, Top-up, Plan delivery, Granted, Refund, Adjustment), amount remaining, rate
per token, purchase order and expiry.
* **Activity** — a **Daily token usage** chart over 7, 30 or 90 days, plus a **Token activity**
ledger of every consumption event: When, Tokens, Source, PO and Reason. Filter it by project, or
by "Outside any project".
* **Statements** — period summaries of tokens received, used and refunded, as downloadable PDFs.
A monthly rollup is generated automatically; click **New statement** to generate one for any
period, optionally narrowed to a single purchase order.
### Settings
Your bill-to address, tax IDs (EU VAT, UK VAT, CH VAT, US EIN — verified with the local authority),
payment method, and your full invoice history with PDFs. Credit notes appear nested under the
invoice they belong to.
### Account status
If a payment fails, the organization is **suspended** — new runs stop, but tokens you already
bought stay available and all your data remains accessible. Update your payment method to restore
service.
***
## Linked organizations
Agencies and groups can run a parent organization with child organizations underneath it. Only
Super-org admins see this area.
* **Overview** — every linked organization with its status, balance, pending requests and last 30
days of usage.
* **Organisations** — the child organizations and when each was linked.
* **Approvals** — child organizations cannot buy tokens directly. Their purchase requests land here
for you to approve or reject, and are charged to the parent's payment method.
Child organizations inherit the parent's plan and rate, see a "Billed through *parent*" notice
instead of a subscription block, and can cancel their own pending requests.
Linking an organization is not self-serve — contact
[support@mentionlab.io](mailto:support@mentionlab.io).
***
## API keys
**Organization Settings → API Keys**. Administrators and Super-org admins can create and delete
keys; Editors can view the list.
### Creating a key
Click **Create API Key** and set:
| Field | Description |
| ------------------- | ---------------------------------------------------- |
| **Name** | A descriptive name (e.g. "BI Dashboard Integration") |
| **Permission** | `Read only` or `Read & Write` |
| **Expiration Date** | Optional — leave empty for a key that never expires |
The full key is shown **once**, at creation. Copy it immediately — it cannot be recovered. If you
lose it, delete the key and create a new one.
`Read & Write` is not full access. It can read data and create or update project data, but it
cannot delete projects, manage members, or touch organization settings and billing.
Keys are scoped to one organization, start with `ml_live_`, and are sent in the `x-api-key` header.
See the [REST API documentation](/rest-api/authentication).
To revoke a key, delete it — there is no rotation.
***
## Recurring Projects
**Organization Settings → Recurring Projects** is a read-only, cross-project view of every project
in the organization that has a schedule, showing its recurrence, execution count, models and tokens
per run.