# Team and roles

> Invite co-hosts, managers and cleaners, and give each of them exactly the part of the workspace they need.

Source: https://docs.santara.ai/setup/team/

**Settings → Team**. Invitations are sent by email as a link. If the person has no account they
register first, then accept the invitation to join this workspace.

One person can hold different roles in different workspaces. Their login is theirs; the access is
per workspace.

## The three roles

| Role | Sees | Typical use |
| --- | --- | --- |
| **Host admin** | Everything: full portfolio visibility and billing | You, and anyone you trust with the money |
| **Co-host** | Scoped workflow access for daily operations | A partner, a manager, a maintenance lead |
| **Cleaner** | Their own assigned cleans, and enough about the building to find it | Your cleaning staff |

There is no separate "property manager" role, and you do not need one: a **co-host scoped to two
buildings** is a property manager. Scope is the second half of every invitation — see below.

The **primary host cannot be removed** from the workspace, which is what stops a workspace ending
up with nobody who can pay for it.

## How access actually works

Access is not a list of screens per job title. Every screen **and every API route** asks for a
named **capability** — `stay.read`, `pricing.write`, `guest.message.send`, and so on — and a role
is a bundle of capabilities, optionally narrowed to certain buildings and rooms.

Two consequences worth knowing:

- **Hiding a menu item is not the security.** The route enforces the same capability the navigation
  reads, so a link someone types by hand is refused, not just hidden.
- **Data classes are separate from screens.** Door codes, guest contact details and financial
  figures are each their own class. A cleaner can be told which building a job is in without being
  given its door code, and a manager can run operations without seeing owner payouts.

## Scoping to buildings

Every member has an **Access** setting: which buildings, and which rooms inside them, they can work
on. Either:

- **All buildings, including ones added later** — the right choice for a partner, and it does not
  need revisiting each time you buy something.
- **A selection** — pick the buildings and rooms. The summary reads *"3 buildings · 7 rooms"*, and
  a member with no access at all is told so plainly rather than shown an empty dashboard they will
  report as broken.

Scoped members see their buildings' work and nothing about the rest of your estate — not the
calendar, not the revenue, not the guests.

**Host admins always have access to every building**, including ones added later. That is not a
setting, and it is why the role is the one you hand out most carefully.

## What a cleaner experiences

They sign in and see the cleans assigned to them, on the days they happen, with the address and the
access notes for those buildings. They mark work done, optionally with a photo. That is the whole
product for them, on purpose.

If you would rather not give a cleaner an account at all, share the
[cleaning cluster message](/daily/tasks/#cleaning-clusters) from the daily brief instead — it
contains their jobs and nothing else.

## Removing someone

Remove them from the team and their access ends immediately, on every device. Work they did — cleans
marked done, messages sent, tickets resolved — stays attributed to them in the history.

## Your own account

**Settings → Personal** holds your name, language and timezone. **Settings → Security** holds your
password and account protection. Both follow you between workspaces; they are not workspace
settings. See [Workspace settings](/setup/workspace/) for what is shared.
