# 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.**


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.airbook.io/collaborating-with-your-team.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.