> Fetch the index of every Tonbo docs page as Markdown at https://tonbo.dev/llms.txt

# Concepts

Last updated 12 November 2026

Tonbo keeps one set of accounts for every region, and runs a cell of its own in each region. Your account, its members, its keys and its balance are the same wherever you work; each database, stream and Machine lives in one region, in that region’s cell.

## An account {#account}

What everything you create belongs to: its databases, streams, Machines, API keys and the balance that pays for them. It is your personal account or an organization, and nothing moves from one account to another (see [Accounts](https://tonbo.dev/docs/platform/accounts.md)).

## Members {#members}

The people and Agents of an account, each with a role that decides what they may do there. A person may belong to several accounts; an Agent belongs to the one account it was created in (see [Members and roles](https://tonbo.dev/docs/platform/members.md) and [Agents](https://tonbo.dev/docs/platform/agents.md)).

## A key {#keys}

An API key belongs to one account and acts as one member of it, with that member’s role and whatever narrowing the key has. It reaches that account in every region and never another account, so a program that works in two accounts holds a key of each. Your `tonbo login` is not a key: it is you on one computer, in every account you belong to (see [API keys and tokens](https://tonbo.dev/docs/platform/api-keys.md)).

## A region {#region}

Where a database, a stream or a Machine lives, chosen when it is created and fixed for its life; a creation that names none goes to `us-east-1`. Its data stays there, and its URL starts with that region’s origin, followed by your account’s name and its own. A name is unique within the account across every region (see [Databases](https://tonbo.dev/docs/databases/manage.md#regions) and [Streams](https://tonbo.dev/docs/streams/manage.md#regions)), and [Regions](https://tonbo.dev/docs/platform/regions.md) lists the regions and what each offers.

## A cell {#cell}

Tonbo’s hosts and servers in one region: they hold that region’s databases, streams and Machines and answer every request to them. Each region Tonbo offers is one cell. A cell opens one product at a time, so a region can offer databases and streams before it offers Machines.

## How they fit together {#together}

- The console and the Management API, at `https://api.tonbo.dev`, are the same for every region. They keep the accounts, their members, keys and balance, and they create and delete each database, stream or Machine in its region’s cell.
- Your program’s reads, writes, appends and calls go straight to the region’s origin, never through the Management API.
- A key goes to the Management API and to the token endpoint, `https://tonbo.dev/api/iam/token`, which exchanges it for a short-lived token that every region’s cell checks on its own. Revoking the key stops new tokens at once and reaches every region shortly after (see [The token exchange](https://tonbo.dev/docs/platform/api-keys.md#exchange)). A key that acts as a person may also be sent to a region as it is, and the cell then checks it with Tonbo (see [Sending the key directly](https://tonbo.dev/docs/platform/api-keys.md#direct)).
- Usage in every region is charged to the account’s one balance (see [Usage and billing](https://tonbo.dev/pricing.md#faq)).
