PricingConsole

Concepts

Last updated 12 November 2026

View .md

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

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).

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 and Agents).

A key

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).

A 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 and Streams), and Regions lists the regions and what each offers.

A 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

  • 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). 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).
  • Usage in every region is charged to the account’s one balance (see Usage and billing).