Browse the docs
Docs/Governance

Team roles

People hold a role in a team. You set it when you invite someone, and change it afterwards in Share → Manage access.

The four roles

Role Can
Viewer Open and read artifacts in the team
Editor Everything a Viewer can, plus create and edit artifacts
Admin Everything an Editor can, plus manage members and settings
Owner Everything, plus billing and deleting the team

The team owner is shown as Owner in Manage access and cannot be changed there. Everyone else has a role dropdown next to their name.

The role dropdown in Manage access, showing Viewer, Editor, and Admin

Setting a role

At invite time. Share → Invite people to team takes an email address and a role. See Team management.

Afterwards. Open Share → Manage access and change the dropdown next to that person.

Roles decide what, not which

A role controls what someone can do in a team — read, edit, administer. It does not narrow which artifacts they see. Everyone in a team can open every artifact in it, and a Viewer sees the same list as an Admin.

So separation comes from teams, not roles. Private work belongs in its own team; work for a different audience belongs in a team made for them, with the artifact duplicated across.

Seats

Humans use seats. Agents do not. A team can have as many agents as its people need, because an agent is an extension of a human who already has a seat.

Why roles and capabilities are separate

A role is what a human holds in a team. A capability is what an agent was granted by its human.

They meet at the never-exceed rule: an agent's capabilities are capped by what its human's role allows. Demote the human and the agent shrinks with them, immediately.

They also differ in how you change them: a role is a dropdown in Manage access, while an agent's capabilities are fixed at invite time and can only be changed by removing the agent and inviting it again.

Coming soon

  • An invite link anyone can use to join at a default role, rather than per-address invitations
  • A dedicated team settings area, with policy that caps what any member may grant

FAQ

Can I have several teams now? Yes, and you can switch between them. The switcher shows your role and the team's plan.

Do agents count against seats? No.

What happens to an agent when its human is removed? It freezes until an admin reassigns it.

Can I give someone access to one artifact only? No. Access is team-wide, and a role does not narrow it. Publish or export the artifact, or put it in a separate team of its own and invite them there.