# Mestra Topos

Where an organisation keeps its own data in tables, brings it in with connectors, and writes decisions that choose what a screen shows.

Mestra Topos is where an organisation keeps its own data, brings it in from other systems and files, and writes decisions that choose what a screen shows. Open it at `topos.withmestra.com`, or from the app switcher in any Mestra app. You arrive signed in.

Mestra turns Topos on for an organisation. If Topos is off, the page says "Mestra Topos isn't on for" your organisation and links to support. To ask for it, see [Support](https://withmestra.com/docs/support/).

## The three areas

The sidebar has three pages.

- **Data** holds your tables. You can browse them, filter them, sort them and open any row. See [Tables](https://withmestra.com/docs/topos/tables/).
- **Ingest** holds your connectors. A connector brings data in and builds your tables. Your system can send data to an address with a key. Mestra can fetch it from a web address on a schedule. Or you can upload a spreadsheet or a CSV file. Each connector shows its schedule, its health and its past runs. See [Connectors](https://withmestra.com/docs/topos/connectors/).
- **Decisions** holds small programs that choose which variant of a campaign a screen shows. You test a decision, make a version live, and read a log of what it chose. See [Decisions](https://withmestra.com/docs/topos/decisions/).

The home page shows what needs a look (a failing connector, a decision that fell back), a tile for each area, the pages you opened recently, and recent activity. A new organisation sees **Start here**, with three steps: **Bring data in**, **Look at it** and **Write a decision**.

## Ask Mestra in Topos

[Ask Mestra](https://withmestra.com/docs/how-to/ask-mestra/) works on the Data, Ingest and Decisions pages. It can make a folder and move datasets, save a connector, a mapping or a decision, replay what a connector received, and make a decision version live or take it down. It does the work on the page in front of you, and it asks on a card before anything that removes something or changes what a screen shows, including how old a decision's data may be. Header values and ingest keys stay with you. See [Ask Mestra](https://withmestra.com/docs/how-to/ask-mestra/#topos).

An AI agent you connect yourself gets the same work as four tools: `topos_data`, `topos_decisions`, `topos_ingestors` and `topos_mappings`. They are in the Topos group on the [tools page](https://withmestra.com/docs/mcp/tools/).

## Who can do what

| Role         | What they can do in Topos                                                                                                                                                                                                                                |
| ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Owner**    | Everything: upload files, make, edit, run, replay and delete connectors, make and revoke keys, make and rename folders and move tables, delete tables, write and test decisions, make versions live and take them down, read the bodies of what arrived. |
| **Editor**   | See everything an owner can see, except the bodies of what arrived. Editors can't change anything in Topos.                                                                                                                                              |
| **Reviewer** | The same as an editor.                                                                                                                                                                                                                                   |

Everyone in the organisation sees all three pages. A page that is for owners only doesn't show its buttons to anyone else. If someone acting for Mestra support is signed in as your organisation, the owner-only changes are refused for them.

## Your data stays yours

Mestra keeps your data as you send it, and it stays yours. You are responsible for what you send. The one change Mestra makes is to mask card numbers: a card number in a payload or file is kept as its last four digits. See [Send data to Mestra](https://withmestra.com/docs/topos/send-data/#what-mestra-keeps).

## In this section

- [Get started](https://withmestra.com/docs/topos/getting-started/): from an empty Topos to a table and a first decision.
- [Tables](https://withmestra.com/docs/topos/tables/): kinds of table, column types, folders and the table viewer.
- [Connectors](https://withmestra.com/docs/topos/connectors/): what a connector is, how to add one and how to read its health.
- [Send data to Mestra](https://withmestra.com/docs/topos/send-data/): push data to an address with a key.
- [Fetch data on a schedule](https://withmestra.com/docs/topos/fetch-data/): Mestra reads a web address on an interval.
- [Upload a file](https://withmestra.com/docs/topos/upload-a-file/): turn a spreadsheet or CSV into a table.
- [Routes, modes and columns](https://withmestra.com/docs/topos/routes-and-modes/): how a connector reads records into a table.
- [Templates](https://withmestra.com/docs/topos/templates/): the ready-made Point of sale connector.
- [Runs, history and replay](https://withmestra.com/docs/topos/runs-and-replay/): past runs, what arrived, versions and replay.
- [Mappings](https://withmestra.com/docs/topos/mappings/): how rows become items in your model.
- [Decisions](https://withmestra.com/docs/topos/decisions/): write a decision.
- [The decision language](https://withmestra.com/docs/topos/decision-language/): what a decision receives, the built-ins and what is refused.
- [Test, go live and read the log](https://withmestra.com/docs/topos/decision-live/): versions, taking a decision down, the log and replay.
- [How data age works](https://withmestra.com/docs/topos/data-age/): how old the data behind a decision may be, and what a screen shows when it is too old.
- [Limits](https://withmestra.com/docs/topos/limits/): every size and count you can hit.
- [Errors and refusals](https://withmestra.com/docs/topos/troubleshooting/): what each message means and what to do.
- [Topos API](https://withmestra.com/docs/topos/api/): the calls you can make from your own systems.
