> ## Documentation Index
> Fetch the complete documentation index at: https://darkbanner.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Manage users, roles, and permissions across your Zygo tenants

Zygo uses a multi-tenant architecture where every resource — flows, credentials, tickets, dashboards, and data — is scoped to a **tenant**. Users are invited to tenants and assigned roles that control what they can see and do.

## Key Concepts

> [card] Users
>
> A user account represents a single person. One user can belong to multiple tenants with different roles in each.

> [card] Tenants
>
> A tenant is an isolated workspace. All resources live within a tenant, and data is never shared between tenants.

> [card] Roles
>
> Roles control what a user can do within a tenant. Roles are hierarchical — higher roles inherit all permissions from lower ones.

> [card] Superadmins
>
> Superadmins are platform-level administrators who can access any tenant and manage all users.

## Role Hierarchy

Every tenant member is assigned one or more roles. Roles are cumulative and hierarchical:

| Role | Permissions |
| - | - |
| **User** | Minimal access. Can view and submit web forms only. |
| **Viewer** | Read-only access to all tenant resources — flows, runs, tickets, dashboards, credentials (masked), data tables, and logs. |
| **Editor** | Everything a Viewer can do, plus create, edit, delete, and run flows, manage credentials, records, tickets, and dashboards. |
| **Admin** | Everything an Editor can do, plus manage tenant members, assign roles, and configure tenant settings. |

> [!NOTE]
>
> A user with the **Editor** role automatically has all **Viewer** permissions. You don't need to assign both.

## What's Next?

> [card] [Managing Users](https://darkbanner.mintlify.site/user-management/managing-users)
>
> Invite users, update profiles, and deactivate accounts

> [card] [Managing Tenants](https://darkbanner.mintlify.site/user-management/managing-tenants)
>
> Create tenants, configure settings, and manage membership

> [card] [Roles & Permissions](https://darkbanner.mintlify.site/user-management/roles-and-permissions)
>
> Understand the role hierarchy and permission model

> [card] [API Authentication](https://darkbanner.mintlify.site/user-management/api-authentication)
>
> Authenticate API requests with tokens


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.