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

# Managing Your Workspace

> Manage your Blink workspace settings, members, and resources for effective team collaboration.

In the **Workspace** settings you can find all your workspaces in one place making it easier to manage, as well as all the details related to all your workspaces.

## Important Terms to Understand

1. **The Blink Organization** is a logical entity provided to an organization subscribing to Blink Ops.

2. A **Workspace** in Blink, is a compartment within the Blink Organization that organizes hyperautomation resources. An organization can have multiple workspaces, each designed for specific functions. Workspaces are independent, with no hierarchical connections between them, ensuring that each workspace operates separately. Each workspace manages its own set of resources, which can be shared with other workspaces if needed. Access to resources within a workspace is controlled by [RBAC (Role-Based Access Control) scopes](/docs/blink-platform/account-management/roles#workspaces-user-role-scope), which are linked to [user roles](/docs/blink-platform/account-management/roles).

3. **RBAC Scopes**, defined per workspace, govern the ability of a particular user or API client to perform specific operations on specific resources. Each scope is evaluated separately in each workspace. The list of available scopes can be found in our [documentation](/docs/blink-platform/account-management/roles#workspaces-user-role-scope). As new features and functionality are added to the product, new scopes are created.

4. **User Roles**, defined per workspace, are aggregations of scopes within the relevant workspace that allow users assigned to the role to perform specific tasks. Every workspace has a set of predefined user roles, with the option to define customized roles. To learn more about **User Roles** please navigate to the [User Role's Section](/docs/blink-platform/account-management/roles) of our documentation.

5. A **Personal Workspace** is a workspace associated with exactly one user, where the workspace’s internal identifier matches the user’s name.

***

## Settings

<Tabs>
  <Tab title="Members" icon="user">
    ### Inviting a New Member to a Workspace (RBAC)

    <Steps>
      <Step>
        Invite a new member to your workspace by navigating to the "Settings" page from the left hand navigation menu.

        <Frame>
          <img src="https://mintcdn.com/blinkops-2/4jJzHLYX9WcCQdrG/img/Workspaces/WorkspaceSettings.gif?s=9cb08ec65d3f4bb2820187b9987ca8db" width="1956" height="1080" data-path="img/Workspaces/WorkspaceSettings.gif" />
        </Frame>
      </Step>

      <Step>
        A dialogue box opens with the details of the workspace and the option to invite a new member to your workspace. You can invite only a member of the tenant. You can see a list of all the members of your workspace and control their permissions.

        <Frame>
          <img src="https://mintcdn.com/blinkops-2/rEe5UBpGIz5iEH3e/img/Workspaces/InviteNewUser.gif?s=1a8b900ffc1763775fc67daccc4a8a2a" width="1956" height="1080" data-path="img/Workspaces/InviteNewUser.gif" />
        </Frame>
      </Step>

      <Step>
        Each member invited to a workspace can be assigned one of the following roles:

        <Note>**Note**: Every workspace must have at least one owner.</Note>

        | Role        | Description                                                                                                             |
        | ----------- | ----------------------------------------------------------------------------------------------------------------------- |
        | Owner       | Can invite new members to the workspace, change user permissions and delete users (full access to workspace settings)   |
        | Contributor | Has full access to the workspaces. Can design, edit and execute Workflows.                                              |
        | Viewer      | View-only permission. Cannot create or modify workspace resources and Workflows. Members can execute existing Workflows |

        <Frame>
          <img src="https://mintcdn.com/blinkops-2/rEe5UBpGIz5iEH3e/img/Workspaces/InviteNewUser.gif?s=1a8b900ffc1763775fc67daccc4a8a2a" width="1956" height="1080" data-path="img/Workspaces/InviteNewUser.gif" />
        </Frame>
      </Step>
    </Steps>
  </Tab>

  <Tab title="Settings" icon="gear">
    ### General

    <Steps>
      <Step title="Enable “Overview Page”">
        When you enable the “Overview Page” option, the occurs overview page becomes available for that specific workspace.

        <Frame>
          <img src="https://mintcdn.com/blinkops-2/P8GBd81uQrUZZyXR/img/Workspaces/WorkspaceSettings.png?fit=max&auto=format&n=P8GBd81uQrUZZyXR&q=85&s=365a01d0d85083db5cb779e1974aebb8" width="1920" height="1080" data-path="img/Workspaces/WorkspaceSettings.png" />
        </Frame>
      </Step>

      <Step>
        Navigating to the overview page displays all available published dashboards within your workspace.

        <Note>
          **Note**:

          1. All dashboards displayed are in view mode

          2. You can configure a default dashboard to automatically appear on the Overview page through the [Dashboard Management Settings](/docs/blink-platform/dashboards/dashboard-management/dashboard-management#dashboard-table-settings).
        </Note>

        <Frame>
          <img src="https://mintcdn.com/blinkops-2/hAfAIflY7b8tS_Xj/img/Workspaces/SolutionsDashboard.png?fit=max&auto=format&n=hAfAIflY7b8tS_Xj&q=85&s=1240d5c6f467fb6d4d60ac181214076d" width="1920" height="1192" data-path="img/Workspaces/SolutionsDashboard.png" />
        </Frame>
      </Step>
    </Steps>

    ### Workflows- Default Error Handler

    <Tip>Only user's with the `workspace:edit` access permissions, can enable the 'Default Error Handler' in their workspace settings. </Tip>

    The default error-handling logic provides a consistent, generic response across the entire workspace whenever a workflow encounters an error, such as sending a notification to a designated Slack channel or team. This ensures errors are handled uniformly without requiring custom error-handling logic in each individual workflow.

    <Steps>
      <Step title="Configure Default Error Handler">
        <Note>**Note**: Only [Event-based workflows](/docs/workflows/building-workflows/triggers/event-based-triggers/event-based-triggers) that include the [Blink Error Event](/docs/workflows/building-workflows/error-handling/run-error#creating-an-event-based-workflow-using-the-blink-error-event) are available for selection as the default error-handling workflow.</Note>

        To set a workflow as the default error-handler for all workflows in the workspace, enable the **Default Error Handler** setting and select the desired workflow from the dropdown menu. The selected workflow will then be applied automatically as the default error handler.

        <Frame>
          <img src="https://mintcdn.com/blinkops-2/P8GBd81uQrUZZyXR/img/Workspaces/DefaultErrorHandler.png?fit=max&auto=format&n=P8GBd81uQrUZZyXR&q=85&s=e88909fa4008065c4c258174f5db8b1b" width="1920" height="1080" data-path="img/Workspaces/DefaultErrorHandler.png" />
        </Frame>
      </Step>

      <Step title="Optional- Override All">
        You can optionally choose to apply the selected workflow as the default error handler across all existing workflows in your workspace, overriding any that are currently configured with a custom error handler in the [Workflow Overview Page](/docs/workflows/managing-workflows/workflow-overview-page#error-handling).

        Click **“Override All”** and then type **“override”** to confirm.

        <Warning>This action cannot be undone.</Warning>

        <Frame>
          <img src="https://mintcdn.com/blinkops-2/P8GBd81uQrUZZyXR/img/Workspaces/Overide.png?fit=max&auto=format&n=P8GBd81uQrUZZyXR&q=85&s=b1bbf0b756b5f1feee974c23198f485e" width="1920" height="1081" data-path="img/Workspaces/Overide.png" />
        </Frame>
      </Step>
    </Steps>
  </Tab>
</Tabs>

***

## Filtering your Workspaces

In the Workspace Settings, use the 'Include Personal Workspaces' toggle in the top-left corner to show or hide <Tooltip headline="Personal Workspace" tip="A Personal Workspace is a workspace associated with exactly one user, where the workspace’s internal identifier matches the user’s name.">Personal Workspaces</Tooltip>

<Frame>
  <img src="https://mintcdn.com/blinkops-2/I2f17tQaPqeQOS2H/img/Workspaces/IncludePersonalWorkspace.png?fit=max&auto=format&n=I2f17tQaPqeQOS2H&q=85&s=7b53d9491c778b997d9d3ccb9ad1a8aa" width="1728" height="1080" data-path="img/Workspaces/IncludePersonalWorkspace.png" />
</Frame>

***

## Change your Workspace's Logo

<Tip>Once uploaded, your custom logo will automatically appear anywhere the workspace logo is displayed, including the Workspaces menu and across workspace pages.</Tip>

Navigate to the workspace settings and click the <Icon icon="pen" /> icon next to the colored square with your initials to upload a custom workspace logo.

<Frame>
  <img src="https://mintcdn.com/blinkops-2/65JYo7CSjJ9ldwRq/img/Workspaces/WorkspaceProfileImage.png?fit=max&auto=format&n=65JYo7CSjJ9ldwRq&q=85&s=9152f37b806c984fa96f3a3fe1fa2f0e" width="1728" height="1081" data-path="img/Workspaces/WorkspaceProfileImage.png" />
</Frame>

<Note>**Note**: Accepted image formats for upload are `PNG`, `JPG`, or `GIF`, with a maximum size of `800px` × `600px`.</Note>

<Frame>
  <img src="https://mintcdn.com/blinkops-2/65JYo7CSjJ9ldwRq/img/Workspaces/WorkspaceLogo.png?fit=max&auto=format&n=65JYo7CSjJ9ldwRq&q=85&s=1de5715a9246cc44b10a91f723f90666" width="3448" height="2160" data-path="img/Workspaces/WorkspaceLogo.png" />
</Frame>

***

### Removing a Member from a Workspace

<Step>
  <p>If you would like to **remove** a user from the selected workspace, click on <Icon icon="square-ellipsis-vertical" iconType="solid" /> icon next to their name and select the **remove** option.</p>

  <Frame>
    <img src="https://mintcdn.com/blinkops-2/4jJzHLYX9WcCQdrG/img/Workspaces/RemoveUser.png?fit=max&auto=format&n=4jJzHLYX9WcCQdrG&q=85&s=47b0db73792eb3152268037b9939b06d" width="3584" height="2004" data-path="img/Workspaces/RemoveUser.png" />
  </Frame>
</Step>

***

## Workspace Navigation

<Step>
  In the Workspace table, navigate to the chosen workspace by clicking <Icon icon="square-ellipsis-vertical" iconType="solid" /> icon on the right-hand side of the row and selecting the **Go to Workspace option**. This will open the selected workspace in a new tab.

  <Frame>
    <img src="https://mintcdn.com/blinkops-2/4jJzHLYX9WcCQdrG/img/Workspaces/WorkspaceNavigation.png?fit=max&auto=format&n=4jJzHLYX9WcCQdrG&q=85&s=5eff9cb3fc05eaa49ae58f913703ff99" width="3574" height="1952" data-path="img/Workspaces/WorkspaceNavigation.png" />
  </Frame>
</Step>

***

## Manage Workspace Members

1. Manage Members of a workspace by clicking the <Icon icon="square-ellipsis-vertical" iconType="solid" /> icon on the right-hand side of the selected Workspace and select the **Manage Members** option.

<Frame>
  <img src="https://mintcdn.com/blinkops-2/4jJzHLYX9WcCQdrG/img/Workspaces/WorkspaceOptions.png?fit=max&auto=format&n=4jJzHLYX9WcCQdrG&q=85&s=332670ec1bf1aa0a848c047b49d63dfa" width="3558" height="1969" data-path="img/Workspaces/WorkspaceOptions.png" />
</Frame>

2. A popup will appear, where you will have the option to **add users or groups** to the selected Workspace by entering the name of the user, group or email addresses and then selecting the **Add** button. You can also assign [roles](/docs/blink-platform/account-management/roles) such as [Contributor](/docs/blink-platform/account-management/roles#contributor), [Owner](/docs/blink-platform/account-management/roles#owner) or [Viewer](/docs/blink-platform/account-management/roles#viewer) to users in the selected workspace.

<Note>**Note**: If you have created your own [custom role](/docs/blink-platform/account-management/roles#adding-a-new-role), it will also appear in the dropdown menu and you can choose it to assign to the invited user or group.</Note>

<Frame>
  <img src="https://mintcdn.com/blinkops-2/4jJzHLYX9WcCQdrG/img/Workspaces/WorkspaceMembers.png?fit=max&auto=format&n=4jJzHLYX9WcCQdrG&q=85&s=02305b4aa7c2036ef0ad01478576d9a6" width="3576" height="1984" data-path="img/Workspaces/WorkspaceMembers.png" />
</Frame>

3. If you would like to **remove** a user from the selected workspace, click on <Icon icon="square-ellipsis-vertical" iconType="solid" /> icon next to their name and select the **remove** option.

<Frame>
  <img src="https://mintcdn.com/blinkops-2/4jJzHLYX9WcCQdrG/img/Workspaces/RemoveUser.png?fit=max&auto=format&n=4jJzHLYX9WcCQdrG&q=85&s=47b0db73792eb3152268037b9939b06d" width="3584" height="2004" data-path="img/Workspaces/RemoveUser.png" />
</Frame>