> For the complete documentation index, see [llms.txt](https://docs.airbook.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airbook.io/collaborating-with-your-team.md).

# Collaborating with your team

## Airbook Workspaces and Permissions

Airbook operates with a hierarchical structure of **Workspaces** and **Airbooks**. Each workspace and Airbook is created by an **owner**, who has full control over its management and permissions.

## Sharing in Airbook

Airbook supports sharing on **two levels**: **workspace-level** and **airbook-level**. Here's how they work:

### 1. Workspace-Level Sharing

You can invite users to your **workspace** as either:

* **Admin**: Full workspace management permissions
* **Analyst**: Can create and manage their own airbooks

> **Note:** Workspace-level users **do not get access** to any existing notebooks by default. They can only create and manage their own.

To invite someone:

* Navigate to your **workspace settings**
* Use the **Invite Users** option
* Assign the role (Admin or Analyst)

### 2. Airbook-Level Sharing

For sharing a specific Airbook:

* Open the Airbook you want to share
* Click the **Share** button in the top-right of the Navbar
* Invite users by email and assign them a role for the Airbook

If the user is **already in your workspace**, simply select their name and you can grant them access.

### Roles and Permissions

#### 1. Owner

* The **owner** is the creator of a workspace or Airbook.
* Has full administrative control.
* Can invite users and assign roles.

#### 2. Admins

* Can **query data, create notebooks, visualizations, and workflows**.
* Can **add and manage connections**.
* Can **manage billing**.
* Can **add or remove other users as Analysts**.

#### 3. Analysts

* Can **query data, create notebooks, visualizations, and workflows**.
* Can **add and manage connections**.
* Cannot manage billing.
* Can **invite Viewers and Editors**.

#### 4. Guests

* Guests do not have **workspace-level permissions**.
* Their access is restricted to specific notebooks.

**Guest Roles in Notebooks**

* **Viewers**: Read-only access.
* **Editors**: Can comment and add text but cannot edit queries, visualizations, or workflows.

### Summary of Permissions

| Role               | Query Data | Create Notebooks | Add Connections | Manage Billing | Notebook Access    |
| ------------------ | ---------- | ---------------- | --------------- | -------------- | ------------------ |
| **Owner**          | ✅          | ✅                | ✅               | ✅              | Full Access        |
| **Admin**          | ✅          | ✅                | ✅               | ✅              | Full Access        |
| **Analyst**        | ✅          | ✅                | ✅               | ❌              | Full Access        |
| **Guest (Viewer)** | ❌          | ❌                | ❌               | ❌              | Read-only          |
| **Guest (Editor)** | ❌          | ❌                | ❌               | ❌              | Comment & Add Text |

### Changing Roles

* **Analysts** can invite **Viewers and Editors** to notebooks based on business requirements.
* **Transferring ownership is not possible through the UI at the moment. To transfer ownership, please contact us.**