> For clean Markdown of any page, append `.md` to the page URL. > For a complete documentation index, see https://docs.sarvam.ai/llms.txt. > For full documentation content in one file, see https://docs.sarvam.ai/llms-full.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.sarvam.ai/_mcp/server. # Platform FAQ > Short answers on organisations vs workspaces, who can invite users and pay, where credits live, API key limits, switching organisations, and what happens when someone leaves your team. Short answers to the questions we get asked most about accounts, teams, and billing. For the full picture, start with [Organisations & workspaces](/api/platform/organisations-and-workspaces). ## Organisations and workspaces #### What's the difference between an organisation and a workspace? An **organisation** is your billing and identity boundary — credits, payment history, plan, and the member list live there. A **workspace** is a space inside the organisation for a project, team, or environment, and it is where API keys are created and where usage is attributed. **Rule of thumb:** one organisation per company that gets a bill; one workspace per thing you want to separate. #### Should I create a new workspace or a new organisation? Almost always a **workspace**. Workspaces give you separate API keys, separate access control, and per-workspace usage attribution while keeping one credit balance and one bill. Create a new **organisation** only when you need a genuinely separate billing entity — a different legal entity, or a client account that is invoiced directly. Nothing is shared between organisations: separate credits, separate payment methods, separate members. #### Do I need to set up billing again for a new workspace? No. A new workspace uses the organisation's existing credit balance straight away. A new **organisation**, on the other hand, starts with its own empty balance and needs its own credits. #### How many workspaces and organisations can I have? Up to **100 workspaces** per organisation, and you can own up to **100 organisations**. Deleted workspaces do not count towards the limit. #### How do I switch between organisations and workspaces? Use the switcher at the top of the left sidebar. Your current selection decides which credits, members, workspaces, and API keys you are looking at everywhere in the dashboard — so check it before creating a key or adding credits. One organisation can be your **default**, which is where you land when you sign in. You can see this as `Default organisation` under **Settings → Organisation → General**. #### Can I move a workspace to a different organisation? Not from the dashboard. Because a workspace's usage and API keys are tied to the organisation that pays for them, moving one is a manual operation — [contact us](mailto:developer@sarvam.ai) if you need it. ## Members and roles #### What roles are there? Two at the organisation level — **Owner** and **Member** — and three per workspace: **Admin**, **Editor**, and **Viewer**. Organisation Owners are automatically Admin on every workspace, so you do not need to grant them workspace access explicitly. #### Who can invite users? Only organisation **Owners**. For a Member the **Invite User** button is disabled with the tooltip *"Only org owners can invite users"*, and the API rejects the request too — it is a real permission, not just a hidden button. Creating workspaces, renaming the organisation, changing someone's role, and removing members are also Owner-only and enforced the same way. #### What role does an invited person get? Everyone starts as an organisation **Member** with **Editor** access to the workspaces you picked during the invite. The invite dialog does not offer a role choice. To make someone an Owner, invite them first, then use **Edit user** on their row and change **Organisation role** to Owner. #### Why does someone show as Pending? They have been invited but have not signed in and accepted yet. Pending rows offer **Revoke invitation** instead of the usual edit and remove actions. #### Can I remove the last Owner? No. An organisation must always have at least one Owner, so the final Owner cannot be demoted or removed. Promote someone else to Owner first. #### Someone left the team. What should I do? Remove them from **Settings → Organisation → Members**, which revokes their access to the organisation and all its workspaces immediately. Removing a person does **not** revoke API keys they created — keys belong to the workspace and keep working. Rotate any key you consider sensitive under **API Keys**. #### Is there a limit on members? No limit on the number of members. A single invite can grant access to up to **50 workspaces** at once. #### I need to onboard a large group at once The invite dialog handles one person at a time. For bulk onboarding, [contact us](mailto:developer@sarvam.ai) and we can load the invites for you. ## Credits and billing #### Where do credits live — organisation or workspace? The **organisation**. There is one balance per organisation, shared by every workspace, every API key, and every Sarvam product. There are no per-workspace balances or budgets. #### Can I cap spend per workspace or per API key? Not today. Because there is a single organisation-level balance, per-workspace and per-key budgets do not exist. If you need hard spend separation, use a [separate organisation](/api/platform/create-an-organisation), which has its own balance. You can still *see* spend per workspace under **Settings → Usage**, since usage is attributed to the workspace a call came from. #### Do credits expire? No. #### My API calls started returning 402 The organisation is out of credits. Add credits under **Settings → Billing** and calls resume immediately — no key rotation or redeploy needed. Enable [auto-recharge](/api/platform/billing) to avoid it happening again. If your balance looks healthy and you are still seeing `402`, see [Errors & Troubleshooting](/api/getting-started/errors-troubleshooting). #### I paid but my credits did not arrive Most often the payment window was closed before it confirmed, in which case the charge is refunded automatically rather than converted to credits. Check **Settings → Billing → Payment History** first, then [contact support](mailto:developer@sarvam.ai) with the payment reference if the money left your account and no refund appears. #### My invoice has no download link Usually a special character or emoji in the billing address, which the payment provider rejects. Fix the billing address and [contact support](mailto:developer@sarvam.ai) to have the invoice reissued. #### How do I get enterprise pricing? Use **Request enterprise plan** on **Settings → Plans & pricing**. Enterprise covers higher rate limits, custom concurrency and throughput, volume discounts on credits, and dedicated support with SLAs. ## API keys #### Do API keys belong to me or to the workspace? To the **workspace**. That is why a key keeps working after the person who created it leaves, and why calls made with it are attributed to that workspace. #### How many API keys can I have? Up to **50 active keys** per organisation. If you need more, [contact the team](mailto:developer@sarvam.ai) — the cap is not self-serve. #### Do rate limits apply per key or per account? Per account. All keys share the same rate limit pool — creating more keys does not buy more throughput. See [Credits & Rate Limits](/api/getting-started/ratelimits). #### What's the safest way to use keys across environments? One workspace per environment, with its own key in each. Rotating or revoking a staging key then never touches production traffic. ## Account settings #### Where do I find my organisation ID or workspace ID? Organisation ID is under **Settings → Organisation → General**; workspace ID is under **Settings → Workspace → General**. Both have a copy button. Support will often ask for one of these. #### What are the three settings scopes? The dropdown at the top of the settings sidebar switches between **Organisation** (org details, members, workspaces, billing and usage), **Workspace** (that workspace's details and members), and **Profile** (your own account settings). #### Can I stop Sarvam training on my data? Yes. **Model training** is a toggle under **Settings → Organisation → General**, and only an Owner can change it. For retention windows, zero-data-retention, and custom retention periods, [talk to us](/api/getting-started/help). #### Can I change the session timeout? Yes — **Session idle timeout** under **Settings → Organisation → General**, Owner-only. It applies to everyone in the organisation. ## Still stuck? #### [Talk to us](/api/getting-started/help) Support channels and what to include in a report. #### [Errors & Troubleshooting](/api/getting-started/errors-troubleshooting) Status codes, `402` and `429` handling, and common failures.