# Role-based access for Flows

ZBrain Builder provides granular, role-based access control at the flow level, ensuring that users can view, edit, and execute only the flows appropriate to their assigned roles. This ensures secure and compliant handling of business logic and automation workflows across teams.

### **How role-based access works for Flows**

Each user’s interaction with flows is governed by their assigned role (Admin, Builder, Operator). Access can be customized further for each flow, ensuring tighter control over sensitive or critical processes.

| Role         | Flow access capabilities                                                                            |
| ------------ | --------------------------------------------------------------------------------------------------- |
| **Admin**    | Full control—create, modify, delete, run, and assign access to flows.                               |
| **Builder**  | Create and modify flows. Can test and execute the flows they’ve built or have been given access to. |
| **Operator** | View assigned flows. Cannot create, edit, or delete any flow. UI elements for editing are disabled. |

### **How to invite a user**

To invite a new user:

1. Click on the gear icon ⚙️ located at the top right corner of the ZBrain Builder interface and select ‘Settings’.

<figure><img src="https://3781630280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbuSicczDKTyHzwzicar%2Fuploads%2Frlnz0k3mCL2c4WNIN354%2Fimage.png?alt=media&#x26;token=435ba05a-246b-48d3-8c8d-a60fa2f11185" alt=""><figcaption></figcaption></figure>

2. Go to the ‘Users’ section under ‘Settings’.
3. Select the ‘+Add’ button to add a new user. A side panel titled ‘Add New User’ appears on the right.

<figure><img src="https://3781630280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbuSicczDKTyHzwzicar%2Fuploads%2FZJ1W6gulJCC7MlUVZ2Kb%2Fimage.png?alt=media&#x26;token=647ef6d4-c104-45f1-a95a-d42bcb51a1a4" alt=""><figcaption></figcaption></figure>

4. On the side panel, enter the first and last name of the user you want to invite.
5. Provide the person's email address and select the role to assign, Admin, Builder, or Operator.

<figure><img src="https://3781630280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbuSicczDKTyHzwzicar%2Fuploads%2F4OKDKD974tmzDSPHqjXP%2Fimage.png?alt=media&#x26;token=44b0f9b1-d9b3-46f9-b9e3-b8663f5dd27d" alt=""><figcaption></figcaption></figure>

6. Click ‘Invite.’

The user will receive the invitation message via email.

<figure><img src="https://3781630280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbuSicczDKTyHzwzicar%2Fuploads%2FpowyRLxjyWplSicoomq2%2Fimage.png?alt=media&#x26;token=880e9d5d-dc93-416c-91b3-4b07132d29cb" alt=""><figcaption></figcaption></figure>

### **Granting a user access to a Flow**

1. Click on the invited user to open the Provide Access panel.

<figure><img src="https://3781630280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbuSicczDKTyHzwzicar%2Fuploads%2FVSWnGW3yojjEJ1sn6sBU%2Fimage.png?alt=media&#x26;token=a7146ac9-8806-4aac-8dac-fdbf97e4c2a3" alt=""><figcaption></figcaption></figure>

2. Use the search box to find the flow you want to grant access to.
3. Select the desired flow.
4. Click ‘Done’ to apply access.

<figure><img src="https://3781630280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbuSicczDKTyHzwzicar%2Fuploads%2F2oPU3vkv6Plb3kQQAQYM%2Fimage.png?alt=media&#x26;token=b2e24d4d-f94a-4a84-82e8-8b40b75725e2" alt=""><figcaption></figcaption></figure>

The user will now see the assigned flow in their dashboard, with functionality aligned to their role.

### **How to modify the user access level**

To modify the details of the user:

1. Navigate to Settings > Users.
2. Click the pencil icon ✏️ next to the user.
3. In the ‘Edit User’ panel that appears, make the required changes:
   * First Name, Last Name, or Access Email
   * **Role:** Select the role that best fits the user’s responsibilities—Admin, Builder, or Operator.
   * **Status:** Switch the user’s status to Active or Inactive as required.
4. Click ‘Update’ to save the changes.

<figure><img src="https://3781630280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbuSicczDKTyHzwzicar%2Fuploads%2FpzbIGQWvLIx9eaeW6sb1%2Fimage.png?alt=media&#x26;token=16846321-24cd-4528-a893-16fd0b3a87f0" alt=""><figcaption></figcaption></figure>

### **Flow visibility and restrictions**

* Users will only see flows to which they have been explicitly granted access.
* If a user’s role is downgraded (e.g., from Builder to Operator), editing capabilities will be automatically restricted for all flows, even if they were previously granted.
* Role changes take effect immediately across all associated flows.

This system ensures a secure and structured way to manage access across all flow-related activities in ZBrain Builder.
