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

# Connection Permissions

> Control who can use a connection and what your Righthands can do with it

## Overview

Every connection has three layers of control: **scope**, **Righthand access**, and **tool permissions**. Together, these let you decide who owns the connection, which Righthands can use it, and exactly what they're allowed to do with it.

## Connection Scope

The scope determines who owns and controls the connection. When you add a connection, it defaults to **Personal**.

There are three scopes:

<CardGroup cols={3}>
  <Card title="Personal" icon="user">
    This account belongs to you. Only you can add or remove this connection from a Righthand.

    **Example:** Your personal Gmail account.
  </Card>

  <Card title="Righthand" icon="lock">
    This account was created specifically for a single Righthand. It is meant to be used by that Righthand alone.

    **Example:** A dedicated GitHub account for a Righthand Software Engineer.
  </Card>

  <Card title="Team" icon="users">
    This is a shared account accessible to the whole team. Any team member can assign it to their Righthands.

    **Example:** A shared database connection that doesn't need per-user access.
  </Card>
</CardGroup>

<Frame>
  <img src="https://mintcdn.com/americanproductivitycompany/CKORSJZHsNE6PYSy/images/connections/connection-scope.png?fit=max&auto=format&n=CKORSJZHsNE6PYSy&q=85&s=f4dccbfec6df9f146280cb843d23231c" alt="Connection scope settings showing Personal, Righthand, and Team options" width="1288" height="1332" data-path="images/connections/connection-scope.png" />
</Frame>

<Note>
  Righthands understand the sensitivities around connection permissions. They will respect the boundaries of each scope when working with your colleagues.
</Note>

## Righthand Access

Toggle which Righthands on your team have access to a given connection. This lets you share a single connection with multiple Righthands or restrict it to just one.

<Frame>
  <img src="https://mintcdn.com/americanproductivitycompany/CKORSJZHsNE6PYSy/images/connections/righthand-access.png?fit=max&auto=format&n=CKORSJZHsNE6PYSy&q=85&s=5e57d69f5961ea5d5daaa5b2bb0a1f5e" alt="Toggle Righthand access to a connection" width="1292" height="954" data-path="images/connections/righthand-access.png" />
</Frame>

## Tool Permissions

For OAuth connections, each tool within the OAuth scope has its own permission level. This gives you granular control over what your Righthands can actually do with a connection.

Each tool can be set to one of three permission levels:

| Permission | Behavior                                                                     |
| ---------- | ---------------------------------------------------------------------------- |
| **Yes**    | The Righthand can use this tool freely without asking.                       |
| **Ask**    | The Righthand will request approval from the manager before using this tool. |
| **No**     | The Righthand cannot use this tool at all.                                   |

<Frame>
  <img src="https://mintcdn.com/americanproductivitycompany/CKORSJZHsNE6PYSy/images/connections/tool-permissions.png?fit=max&auto=format&n=CKORSJZHsNE6PYSy&q=85&s=8e5e2fd90399d328c831d15d23ab2fe1" alt="Tool permissions with Yes, Ask, and No options" width="1270" height="1904" data-path="images/connections/tool-permissions.png" />
</Frame>

## Managing Connections

You can view and manage all of your connections from the Connections page in the platform. From there you can:

* Rename a connection
* Activate or deactivate it
* Change the scope
* Update Righthand access
* Adjust tool permissions
* Remove the connection entirely

<Info>
  Need help? Reach out to us at [support@humans.righthand.ai](mailto:support@humans.righthand.ai).
</Info>